使用 MediaConvertJobConfig 配置轉碼任務 - 智能媒體服務

名稱	類型	描述	樣本值
	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