DASH打包是指將多字幕、多音軌、多碼率視頻流生成一個Master Playlist文件的過程。在實際應用中,客戶端可以根據自身網絡情況動態選擇并請求最合適的片段進行播放,能夠顯著改善帶寬波動較大時的視頻播放質量。本文介紹了新建DASH打包工作流、調用AddMedia接口指定視頻及DASH打包工作流ID進行視頻處理的操作步驟。
使用說明
DASH打包工作流目前只能通過API生成,不能通過控制臺生成。通過API生成的工作流可以通過控制臺查看和使用。更多信息,請參見新增媒體工作流。
操作步驟
在創建工作流時,請關注以下對象。創建工作流API接口,請參見新增媒體工作流。
說明多次打包只需設置一次工作流。
對象
描述
Topology
拓撲結構是指可自定義的業務處理流程,DAG。
Activity
活動是指組成拓撲結構的處理節點,在新建DASH打包工作流時要注意的活動請參見下文活動說明表。
Dependencies
依賴關系是拓撲結構中的邊,指明活動之間的依賴。
表 1. 活動說明表
活動
描述
前后依賴
指定DASH打包配置,設置Master Playlist文件輸出位置。
前置節點允許:Start。
后置節點允許:SubtitleGroup、AudioGroup、VideoGroup。
指定字幕分組ID和語言。
前置節點允許:PackageConfig。
后置節點允許:Transcode(僅字幕)。
指定音頻分組ID和語言。
前置節點允許:PackageConfig。
后置節點允許:Transcode (僅音頻)。
指定視頻分組ID。
前置節點允許:PackageConfig。
后置節點允許:Transcode (僅視頻)。
用于提取視頻流、音頻流、字幕流。
前置節點允許:SubtitleGroup、AudioGroup、VideoGroup。
后置節點允許:GenerateMasterPlayList。
打包生成活動。
前置節點允許:Transcode。
后置節點允許:Report。
調用新增媒體接口,需要注意以下幾點:
指定媒體工作流ID。
若存在字幕提取,可以設置參數OverrideParams,以覆蓋字幕Transcode活動中的固定字幕文件地址參數,如
{"subtitleTransNode":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/package/subtitle/CENG.stl"}}}}
其中sutitleTransNode為工作流定義中的字幕抽取結點。工作流觸發模式設置為:NotInAuto。
場景
源文件mxf格式(也可是其它格式如mp4、flv、m3u8(ts)),從源文件中提取3路音軌,提取2路視頻流。提取2路WebVTT字幕,最終組合打包成一個Master Playlist:
設置DASH打包輸出Master Playlist的位置及名稱。
設置Bucket。
設置Location。
設置Master Playlist的名稱。
活動定義如下:
{ "Parameters" : { "Output" : "{\"Bucket\": \"exampleBucket****\",\"Location\": \"oss-cn-hangzhou\",\"MasterPlayListName\": \"{MediaId}/{RunId}/dash/master.mpd\"}" }, "Type" : "PackageConfig" }
Output設置Master Playlist的存儲位置及名稱,參見PackageConfig活動支持的參數。
Type指定活動類型為PackageConfig。
活動定義:
"audio-cn-group" : {
"Name" : "audio-cn-group",
"Parameters" : {
"AdaptationSet" : "{\"Lang\":\"chinese\",\"Group\":\"AudioGroupChinese\"}"
},
"Type" : "AudioGroup"
}
Group:指定音頻分組ID為AudioGroupChinese。
Type:類型為AudioGroup活動。
提取音軌。
從mxf源文件中提取音頻流,需要去掉視頻流。
輸出的音頻流參數。
活動定義:
"audioCNTransNode" : { "Name" : "audioCNTransNode", "Parameters" : { "Outputs" : "[{\"TemplateId\":\"d053297fc44f9DashTempla****\",\"AudioStreamMap\":\"0:a:0\",\"Video\":{\"Remove\":\"true\"}}]", "Representation" : "{\"Id\":\"chinese128k\",\"URI\":\"audiocn/cn-abc.mpd\"}" }, "Type" : "Transcode" }
視頻分組。
"video-group" : {
"Name" : "video-group",
"Parameters" : {
"AdaptationSet" : "{\"Group\":\"VideoGroup\"}"
},
"Type" : "VideoGroup"
}
提取視頻。
從mxf源文件中提取視頻流,需要去掉音頻流。
活動定義:
"videoTransSD" : { "Name" : "videoTransSD", "Parameters" : { "Outputs" : "[{\"TemplateId\":\"d861b90f6c0aed8f81095e5c5b85****\",\"Audio\":{\"Remove\":\"true\"}}]", "Representation" : "{\"Id\":\"476pSD\",\"URI\":\"videoSD/****.mpd\"}" }, "Type" : "Transcode" }
自定義轉碼模板ID:d861b90f6c0aed8f81095e5c5b857cba,可調用接口進行創建,容器格式為mpd。
在輸出中移除掉音頻流,請參見參數詳情。
URI: 視頻流提取后的名稱及存儲地址。
Type設置為Transcode,即轉碼活動。
字幕分組。
設置字幕分組ID。
活動定義:
"subtitle-cn-group" : { "Name" : "subtitle-cn-group", "Parameters" : { "AdaptationSet" : "{\"Lang\":\"Chinese\", \"Group\":\"SubtitleENGroup\"}" }, "Type" : "SubtitleGroup" }
Group:指定音頻分組名稱為SubtitleENGroup。
Lang: 指定此字幕組的語言。
Type:類型為SubtitleGroup活動。
提取字幕。
上傳STL、TTML、WebVtt格式的字幕到OSS中。
活動定義:
"subtitleCNNode" : { "Name" : "subtitleCNNode", "Parameters" : { "InputConfig" : "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/test/Audio-SiHD.chs.vtt\"}}", "Representation" : "{\"Id\":\"subtitle-chinese\", \"URI\":\"subtitle/cn-xx.vtt\"}" }, "Type" : "Transcode" }
InputConfig指定字幕地址,字幕地址在調用新增媒體時可以被動態覆蓋,見參數OverrideParams。
URI: 字幕流提取后的名稱及輸出目錄。
Type設置為Transcode,即轉碼活動。
輸出Master Playlist。
通過提取音頻、視頻、字幕,將所有提取轉換后的資源打包成一個Master Playlist。
活動定義:
{ "Parameters" : { }, "Type" : "GenerateMasterPlayList" }
Type設置為GenerateMasterPlayList,即生成Master Playlist活動。
拓撲圖示意:
完整的場景示例用拓撲結構表示:
{
"Activities": {
"act-package": {
"Name": "act-package",
"Parameters": {
"Output": "{\"Bucket\": \"outputbucketname\",\"Location\": \"oss-cn-hangzhou\",\"MasterPlayListName\": \"dashpackage/{MediaId}/{RunId}/master.mpd\"}",
"Protocol": "dash"
},
"Type": "PackageConfig"
},
"video-group": {
"Name": "video-group",
"Parameters": {
"AdaptationSet": "{\"Group\":\"VideoGroup\"}"
},
"Type": "VideoGroup"
},
"audio-en-group": {
"Name": "audio-en-group",
"Parameters": {
"AdaptationSet": "{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}"
},
"Type": "AudioGroup"
},
"audio-cn-group": {
"Name": "audio-cn-group",
"Parameters": {
"AdaptationSet": "{\"Lang\":\"chinese\", \"Group\":\"AudioGroupChinese\"}"
},
"Type": "AudioGroup"
},
"subtitle-en-group": {
"Name": "subtitle-en-group",
"Parameters": {
"AdaptationSet": "{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}"
},
"Type": "SubtitleGroup"
},
"subtitle-cn-group": {
"Name": "subtitle-cn-group",
"Parameters": {
"AdaptationSet": "{\"Lang\":\"chinese\", \"Group\":\"SubtitleCNGroup\"}"
},
"Type": "SubtitleGroup"
},
"videoTransLD": {
"Name": "videoTransLD",
"Parameters": {
"Outputs": "[{\"TemplateId\":\"d053297fc44f9dd6becd4a98d1c42f50\",\"Audio\":{\"Remove\":\"true\"}}]",
"Representation": "{\"Id\":\"270pLD\", \"URI\":\"videoLD/xx.mpd\"}"
},
"Type": "Transcode"
},
"videoTransSD": {
"Name": "videoTransSD",
"Parameters": {
"Outputs": "[{\"TemplateId\":\"d861b90f6c0aed8f81095e5c5b85****\",\"Audio\":{\"Remove\":\"true\"}}]",
"Representation": "{\"Id\":\"480pSD\", \"URI\":\"videoSD/****.mpd\"}"
},
"Type": "Transcode"
},
"videoTransHD": {
"Name": "videoTransHD",
"Parameters": {
"Outputs": "[{\"TemplateId\":\"117b3ae88efbc97df372cfd9a0e1****\",\"Audio\":{\"Remove\":\"true\"}}]",
"Representation": "{\"Id\":\"720pHD\", \"URI\":\"videoHD/****.mpd\"}"
},
"Type": "Transcode"
},
"audioCNTransNode": {
"Name": "audioCNTransNode",
"Parameters": {
"Outputs": "[{\"TemplateId\":\"d053297fc44f9dd6becd4a98d1c4****\",\"AudioStreamMap\":\"0:a:0\",\"Video\":{\"Remove\":\"true\"}}]",
"Representation": "{\"Id\":\"chinese128k\", \"URI\":\"audiocn/cn-abc.mpd\"}"
},
"Type": "Transcode"
},
"audioENTransNode": {
"Name": "audioENTransNode",
"Parameters": {
"Outputs": "[{\"TemplateId\":\"d053297fc44f9dd6becd4a98d1c4****\",\"AudioStreamMap\":\"0:a:1\",\"Video\":{\"Remove\":\"true\"}}]",
"Representation": "{\"Id\":\"english128k\", \"URI\":\"audioen/en-abc.mpd\"}"
},
"Type": "Transcode"
},
"subtitleENNode": {
"Name": "subtitleENNode",
"Parameters": {
"InputConfig": "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/dashpackage/subtitle/Subtitle****.EN.vtt\"}}",
"Representation": "{\"Id\":\"subtitle-english\", \"URI\":\"subtitle/en-****.vtt\"}"
},
"Type": "Transcode"
},
"subtitleCNNode": {
"Name": "subtitleCNNode",
"Parameters": {
"InputConfig": "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/dashpackage/subtitle/Subtitle.CN.vtt\"}}",
"Representation": "{\"Id\":\"subtitle-chinese\", \"URI\":\"subtitle/cn-****.vtt\"}"
},
"Type": "Transcode"
},
"act-report": {
"Name": "act-report",
"Parameters": {
"PublishType": "Auto"
},
"Type": "Report"
},
"act-start": {
"Name": "act-start",
"Parameters": {
"PipelineId": "cc7fcef2562e4abc9332d491f933****",
"InputFile": "{\"Bucket\":\"exampleBucket****\",\"Location\":\"oss-cn-hangzhou\",\"ObjectPrefix\":\"package/dash/\"}"
},
"Type": "Start"
},
"generateMasterPlayListAct": {
"Name": "generateMasterPlayListAct",
"Parameters": {},
"Type": "GenerateMasterPlayList"
}
},
"Dependencies": {
"audio-en-group": ["audioENTransNode"],
"video-group": ["videoTransLD", "videoTransSD", "videoTransHD"],
"audio-cn-group": ["audioCNTransNode"],
"audioCNTransNode": ["generateMasterPlayListAct"],
"subtitleENNode": ["generateMasterPlayListAct"],
"act-package": ["audio-en-group", "audio-cn-group", "subtitle-cn-group", "subtitle-en-group", "video-group"],
"act-report": [],
"videoTransSD": ["generateMasterPlayListAct"],
"videoTransHD": ["generateMasterPlayListAct"],
"subtitle-en-group": ["subtitleENNode"],
"subtitle-cn-group": ["subtitleCNNode"],
"subtitleCNNode": ["generateMasterPlayListAct"],
"act-start": ["act-package"],
"videoTransLD": ["generateMasterPlayListAct"],
"generateMasterPlayListAct": ["act-report"],
"audioENTransNode": ["generateMasterPlayListAct"]
}
}
示例代碼
新建DASH打包工作流。
新增媒體。