使用 MediaConvertJobConfig 配置转码任务 - 智能媒体服务 -Alibaba Cloud - 智能媒体服务

名称	类型	描述	示例值
	object	媒体转码任务配置
JobName	string	任务名称。最大长度为 64 字节。	Name
Inputs	array	转码作业输入列表
	object	转码作业输入
Name	string	输入文件名称。在 Output 中使用 InputRef 时，可引用此名称。	InputVideo
InputFile	object	输入文件
Type	string	媒体文件类型。取值： OSS: OSS 文件。 Media: 媒资文件。	OSS
Media	string	媒资文件 URL 或 ID。当 Type 为 OSS 类型时，media 为 URL（支持 OSS/HTTP 协议），请勿带签名参数，否则可能导致权限校验失败。当 Type 为 media 类型时，media 为媒资 ID，默认使用源流输入。	http://bucket.loction.aliyuncs.com/path/to/video.mp4
OutputGroups	array	转码作业输出组配置列表
	object	转码作业输出组配置
Name	string	输出组名称	hls-group
GroupConfig	object	组信息配置。
Type	string	输出组类型，取值： File：独立文件。 Hls：HLS 协议文件（生成自适应播放流）。	Hls
OutputFileBase	object	组输出目录。该 OutputGroup 产生的文件都会在该目录下。
Type	string	媒体对象类型，支持： OSS: 阿里云 oss 文件 Media: 媒资	OSS
Media	string	文件媒资 Type 为 OSS 时，media 为 URL，且支持 OSS 协议和 HTTP 协议。 Type 为 Media 时，media 为媒资 ID。默认使用源流作为输入。	oss://bucket/path/to/dir
ManifestName	string	清单文件名称。当 Type Hls 或 Dash 时，用来指定生成的 manifest 文件的文件名。	manifest
ManifestExtend	object	清单文件扩展功能配置。该功能支持引用一个已存在的清单文件，并在此基础上结合当前输出组结果，生成新的清单文件。
InputRef	string	被引用的清单文件，其值为 Input 的 name。	Input-Manifest
Excludes	array	用来排除引用清单文件中的流。条件内部采用与的逻辑，条件之间采用或的逻辑进行筛选。
	object	流排除条件。
Language	string	按流的 Language 字段查找被筛选项，遵循 RFC5646 标准。	en
Name	string	按流的 Name 字段查找被筛选项。	audio-1
Type	string	按流的 Type 字段查找被筛选项。取值： Audio。 Subtitle。	Audio
Outputs	array	单路输出转码配置列表，数组每个配置表示一个输出流文件。
	object	单路输出转码配置。
Name	string	转码输出名称，仅用于标记输出。	group-output
TemplateId	string	转码模板 ID	**96e8864746a0b6f3**
OutputFileName	string	转码输出文件名。配合 GroupConfig 中 OutputFileBase 一起使用。	720p.mp4
Priority	integer	优先级，数值越大优先级越高，取值：[1,10]，默认值为 6。	6
Features	string	功能参数，详情请参见 MediaConvertJobFeature 。	{}
OverrideParams	string	覆盖参数（JSON 字符串），支持对转码模板关联的参数覆盖。	{}
HlsGroupConfig	object	Hls 组配置。配置当前流在 Manifest 中的行为。仅当组类型为 Hls 时有效。
Type	string	指定输出流类型：取值： video：视频流，处理时将仅保留与视频相关的设置。 audio：音频流，处理时将仅保留与音频相关的设置。 subtitle：字幕流，处理时将仅保留与字幕相关的设置。 hybrid：混合流，处理时将保留与音频和视频相关的设置。默认值：hybrid。	hybrid
AudioGroup	string	该路视频流引用的音频组。当 Type 为 video 生效。默认值： audio	audio
SubtitleGroup	string	该路视频流引用的字幕组。当 Type 为 video 和 hybrid 时生效。默认值：subtitle	subtitle
Name	string	该输出流在 HLS manifest 中的 NAME 属性。当 Type 为 audio 或 subtitle 时，此项为必填。	audio
Group	string	该输出流在 HLS Manifest 中的 GROUP_ID 属性。该属性在 Type 为 audio 和 subtitle 时生效。默认与 Type 的取值相同。	audio
Language	string	该输出流在 HLS manifest 中的 LANGUAGE 属性，当 Type 为 audio 和 subtitle 时生效，需遵循 RFC 5646 标准。	zh
IsDefault	string	是否设为默认流。当 Type 为 audio 和 subtitle 时生效。同一个 Group 中只能有一个默认流。	false
Forced	string	是否强制显示。当 Type 为 audio 和 subtitle 时生效。	true
AutoSelect	string	是否自动选择流。当 Type 为 audio 和 subtitle 时生效。	true

object

媒体转码任务配置

JobName

string

任务名称。

最大长度为 64 字节。

Name

Inputs

array

转码作业输入列表

object

转码作业输入

Name

string

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

InputVideo

InputFile

object

输入文件

Type

string

媒体文件类型。取值：

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

OSS

Media

string

媒资文件 URL 或 ID。

当 Type 为 OSS 类型时，media 为 URL（支持 OSS/HTTP 协议），请勿带签名参数，否则可能导致权限校验失败。
当 Type 为 media 类型时，media 为媒资 ID，默认使用源流输入。

http://bucket.loction.aliyuncs.com/path/to/video.mp4

OutputGroups

array

转码作业输出组配置列表

object

转码作业输出组配置

Name

string

输出组名称

hls-group

GroupConfig

object

组信息配置。

Type

string

输出组类型，取值：

File：独立文件。
Hls：HLS 协议文件（生成自适应播放流）。

Hls

OutputFileBase

object

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

Type

string

媒体对象类型，支持：

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

OSS

Media

string

文件媒资

Type 为 OSS 时，media 为 URL，且支持 OSS 协议和 HTTP 协议。
Type 为 Media 时，media 为媒资 ID。默认使用源流作为输入。

oss://bucket/path/to/dir

ManifestName

string

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

manifest

ManifestExtend

object

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

InputRef

string

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

Input-Manifest

Excludes

array

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

object

流排除条件。

Language

string

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

en

Name

string

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

audio-1

Type

string

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

取值：

Audio。
Subtitle。

Audio

Outputs

array

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

object

单路输出转码配置。

Name

string

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

group-output

TemplateId

string

转码模板 ID

****96e8864746a0b6f3****

OutputFileName

string

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

720p.mp4

Priority

integer

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

6

Features

string

功能参数，详情请参见 MediaConvertJobFeature 。

{}

OverrideParams

string

覆盖参数（JSON 字符串），支持对转码模板关联的参数覆盖。

{}

HlsGroupConfig

object

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

Type

string

指定输出流类型：

取值：

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

默认值：hybrid。

hybrid

AudioGroup

string

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

默认值： audio

audio

SubtitleGroup

string

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

默认值：subtitle

subtitle

Name

string

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

audio

Group

string

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

默认与 Type 的取值相同。

audio

Language

string

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

zh

IsDefault

string

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

false

Forced

string

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

true

AutoSelect

string

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

true