MediaConvertJobConfig

名称类型描述示例值
object

媒体转码任务配置

JobNamestring

任务名称。

  • 最大长度为 64 字节。
Name
Inputsarray<object>

转码作业输入列表

object

转码作业输入

Namestring

输入文件名称。在 Output 中使用 InputRef 时,可引用此名称。

InputVideo
InputFileobject

输入文件

Typestring

媒体文件类型。取值:

  • OSS: OSS 文件。
  • Media: 媒资文件。
OSS
Mediastring

媒资文件 URL 或 ID。

  • 当 Type 为 OSS 类型时,media 为 URL(支持 OSS/HTTP 协议),请勿带签名参数,否则可能导致权限校验失败。
  • 当 Type 为 media 类型时,media 为媒资 ID,默认使用源流输入。
http://bucket.loction.aliyuncs.com/path/to/video.mp4
OutputGroupsarray<object>

转码作业输出组配置列表

object

转码作业输出组配置

Namestring

输出组名称

hls-group
GroupConfigobject

组信息配置。

Typestring

输出组类型,取值:

  • File:独立文件。
  • Hls:HLS 协议文件(生成自适应播放流)。
Hls
OutputFileBaseobject

组输出目录。该 OutputGroup 产生的文件都会在该目录下。

Typestring

媒体对象类型,支持:

  • OSS: 阿里云 oss 文件
  • Media: 媒资
OSS
Mediastring

文件媒资

  • Type 为 OSS 时,media 为 URL,且支持 OSS 协议和 HTTP 协议。
  • Type 为 Media 时,media 为媒资 ID。默认使用源流作为输入。
oss://bucket/path/to/dir
ManifestNamestring

清单文件名称。当 Type Hls 或 Dash 时,用来指定生成的 manifest 文件的文件名。

manifest
ManifestExtendobject

清单文件扩展功能配置。该功能支持引用一个已存在的清单文件,并在此基础上结合当前输出组结果,生成新的清单文件。

InputRefstring

被引用的清单文件,其值为 Input 的 name。

Input-Manifest
Excludesarray<object>

用来排除引用清单文件中的流。条件内部采用与的逻辑,条件之间采用或的逻辑进行筛选。

object

流排除条件。

Languagestring

按流的 Language 字段查找被筛选项,遵循 RFC5646 标准。

en
Namestring

按流的 Name 字段查找被筛选项。

audio-1
Typestring

按流的 Type 字段查找被筛选项。

取值:

  • Audio。
  • Subtitle。
Audio
Outputsarray<object>

单路输出转码配置列表,数组每个配置表示一个输出流文件。

object

单路输出转码配置。

Namestring

转码输出名称,仅用于标记输出。

group-output
TemplateIdstring

转码模板 ID

****96e8864746a0b6f3****
OutputFileNamestring

转码输出文件名。配合 GroupConfig 中 OutputFileBase 一起使用。

720p.mp4
Priorityinteger

优先级,数值越大优先级越高,取值:[1,10],默认值为 6。

6
Featuresstring

功能参数,详情请参见 MediaConvertJobFeature

{}
OverrideParamsstring

覆盖参数(JSON 字符串),支持对转码模板关联的参数覆盖。

{}
HlsGroupConfigobject

Hls 组配置。配置当前流在 Manifest 中的行为。仅当组类型为 Hls 时有效。

Typestring

指定输出流类型:

取值:

  • video:视频流,处理时将仅保留与视频相关的设置。
  • audio:音频流,处理时将仅保留与音频相关的设置。
  • subtitle:字幕流,处理时将仅保留与字幕相关的设置。
  • hybrid:混合流,处理时将保留与音频和视频相关的设置。

默认值:hybrid。

hybrid
AudioGroupstring

该路视频流引用的音频组。当 Type 为 video 生效。

默认值: audio

audio
SubtitleGroupstring

该路视频流引用的字幕组。当 Type 为 video 和 hybrid 时生效。

默认值:subtitle

subtitle
Namestring

该输出流在 HLS manifest 中的 NAME 属性。当 Type 为 audio 或 subtitle 时,此项为必填

audio
Groupstring

该输出流在 HLS Manifest 中的 GROUP_ID 属性。该属性在 Type 为 audio 和 subtitle 时生效。

默认与 Type 的取值相同。

audio
Languagestring

该输出流在 HLS manifest 中的 LANGUAGE 属性,当 Type 为 audio 和 subtitle 时生效,需遵循 RFC 5646 标准。

zh
IsDefaultstring

是否设为默认流。当 Type 为 audio 和 subtitle 时生效。同一个 Group 中只能有一个默认流。

false
Forcedstring

是否强制显示。当 Type 为 audio 和 subtitle 时生效。

true
AutoSelectstring

是否自动选择流。当 Type 为 audio 和 subtitle 时生效。

true