使用预设替代来控制每个作业的设置

Media Services logo v3


警告

Azure 媒体服务将于 2024 年 6 月 30 日停用。 有关详细信息,请参阅 AMS 停用指南

提示

是否想要生成缩略图、将两个视频拼接在一起、对视频进行子剪辑或将其旋转(诸如此类)? 有关媒体服务示例代码,请参阅示例页面。

转换和作业概述

若要使用媒体服务 v3 进行编码,需创建转换和作业。 转换用于定义编码设置和输出的配方,作业则是该配方的一个实例。 有关详细信息,请参阅转换和作业

在媒体服务中编码或使用分析时,可以在转换中定义自定义的预设,以定义要使用的设置。 有时需要按作业替代有关某个转换的设置,这样就不必为每种方案都创建自定义转换。 若要替代转换预设上的任何设置,可以在将作业提交到转换之前使用作业输出资产的预设替代属性。

预设替代

预设替代使你能够传入自定义的预设,在创建转换对象后,该预设会替代提供给该对象的设置。 将新作业提交到转换时,此属性在作业输出资产上可用。

如果你需要替代自定义转换的某些属性或内置预设上的属性,此功能可能很有用。 例如,假设你创建了使用音频分析器内置预设的自定义转换,但最初将该预设设置为使用“en-us”(英语)音频语言设置。 这会生成一个将提交的每个作业仅作为美式英语版本发送到语音转文本听录引擎的转换。 提交到该转换的每个作业将锁定为“en-us”语言设置。 可以通过为每种语言定义一个转换来解决此问题,但这种方法的管理难度要大得多,并且可能会达到帐户中的转换配额限制。 若要以最好的办法解决此问题,可以在将作业提交到转换之前在作业输出资产上使用预设替代。 然后可以定义单个“音频听录”转换,并传入每个作业所需的语言设置。

通过预设替代可以在每个作业提交到转换时传入新的自定义预设定义。 此属性在基于 API 版本 2021-06-01 的所有 SDK 版本中的作业输出实体上可用。

有关参考,请参阅 REST 文档中作业输出实体上的 presetOverride 属性。

注意

只能使用预设替代来替代转换中定义的预设上的设置。 无法从一个特定的预设切换到另一种类型。 例如,如果尝试替代使用内置内容感知编码预设创建的转换以使用另一个预设(例如音频分析器),则会导致出现错误消息。

注意

如果存储帐户没有公用网络访问权限,则不支持 AudioAnalyzerPreset。

代码示例