媒體工作流程活動的類型包括: Start、 Transcode、Snapshot、 Analysis、 Cover、Summary、Censor、Report、UploadVerify、 GenerateMasterPlayList、AudioGroup、SubtitleGroup、PackageConfig、VideoGrou 本文將會介紹以下活動支援的參數:

Start活動

支援設定媒體工作流程的觸發條件和全域配置。本活動會執行媒體資訊擷取。如果媒體資訊擷取失敗,則後續活動會跳過,直到執行Report活動。
名稱 類型 必須 描述
InputFile String 輸入位置,參見工作流程觸發匹配規則

樣本:{“Bucket”: “example-001”,”Location”: “oss-cn-hangzhou”, “ObjectPrefix”: “test/“}。

PipelineId String 管道ID,全域配置。

工作流程情境,管道上的訊息配置無效,QueueName/TopicName的訊息配置有效。

MessageType String 訊息類別。
  • 範圍:Queue、Topic
  • 預設值:Queue
QueueName String 隊列名稱,全域配置。
TopicName String 主題名稱,全域配置。
RoleName String 授權角色名稱,全域配置。

預設值:AliyunMTSDefaultRole

Transcode活動

名稱 類型 必須 描述
Outputs String 字幕提取時非必填。
  • 參數參見:Output詳情
  • 樣本:[{“OutputObject”:”transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D”,”TemplateId”: “S00000001-000070”}]。
OutputBucket String 輸出Bucket。

HLS及DASH打包時,PackageConfig中的Bucket會覆蓋此項。

OutputLocation String 輸出地區。

HLS及DASH打包時,PackageConfig中的Location會覆蓋此項。

MultiBitrateVideoStream String HLS打包,提取視頻流時必填。
ExtXMedia String HLS打包,提取音頻流或者字幕流時必填。
  • 參數參見:41 ExtXMedia詳情
  • 樣本:{“Name”: “english”,”Language”: “en-US”,”URI”:”c/d/audio-1.m3u8”}。
WebVTTSubtitleURL String HLS打包專屬參數,字幕地址。
Representation String DASH打包時,提取音頻流、視頻流或者字幕流時必填。
  • 參數參見:44 Representation詳情
  • 樣本:{\”Id\”:\”480p\”, \”URI\”:\”videoSD/xx.mpd\”}。
InputConfig String DASH打包專屬,提取字幕流活動必填。

Screenshot活動

名稱 類型 必須 描述
SnapshotConfig String
  • 詳情參見:截圖參數配置詳情
  • 樣本:{“OutputFile”: {“Bucket”: “example-001”, “Location”: “oss-cn-hangzhou”, “Object”:”snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg”},”Time”: “5”}。
MediaCover String 是否設定成媒體封面。
  • 只針對單張截圖。
  • 範圍:true,false。
  • 預設值:false

Analysis活動支援的參數

名稱 類型 必須 描述
KeepOnlyHighestDefinition String 是否只保留最高清晰度的分析結果。
  • 範圍:True,False。
  • 預設值:False

Report活動

名稱 類型 必須 描述
PublishType String 媒體發布類型。
範圍:Auto、Manual、TranscodeCompletedAuto。
  • Auto表示工作流程執行完成後自動發布。
  • Manual表示不發布。
  • TranscodeCompletedAuto表示任一轉碼活動完成後自動發布(使用Start節點的訊息配置通知使用者轉碼完成,而且可以使用播放服務播放該活動輸出)。

預設值:Manual

说明 類型為TranscodeCompletedAuto時,若轉碼活動的狀態是跳過的話,不會發送訊息。

PackageConfig活動

名稱 類型 必須 描述
Output String JSON字串。
樣本:{“Bucket”:”output”,”Location”:”oss-cn-hangzhou”,”MasterPlayListName”:”a/b/c.m3u8”}。
说明 MasterPlayListName中可以使用的預留位置:
  • {ObjectPrefix}:不含Bucket資訊的原檔案路徑。
  • {FileName}:不含副檔名的原檔案名稱。
  • {ExtName}:原副檔名。
  • {RunId}:媒體工作流程執行ID。
  • {MediaId}:代表工作流程所處理媒體ID。
所有的預留位置可以動態替換。
Protocol String 取值:hls、dash

SubtitleGroup活動

名稱 類型 必須 描述
GroupId String 分組ID。
  • HLS打包專屬參數,必填,
  • 長度不能超過32個位元組。
AdaptationSet String
  • DASH打包專屬參數,必填。參見47 AdaptationSet詳情
  • 樣本:”{\”Lang\”:\”english\”, \”Group\”:\”SubtitleENGroup\”}”

AudioGroup活動

名稱 類型 必須 描述
GroupId String 分組ID。
  • HLS打包專屬參數,必填,
  • 長度不能超過32個位元組。
AdaptationSet String
  • DASH打包專屬參數,必填,參見 47 AdaptationSet詳情
  • 樣本:”{\”Lang\”:\”english\”, \”Group\”:\”AudioGroupEnglish\”}”,一種語言一個字幕組。

VideoGroup活動

名稱 類型 必須 描述
AdaptationSet String
  • DASH打包專屬參數,必填,參數參見:47 AdaptationSet詳情
  • 樣本:”AdaptationSet”: “{\”Group\”:\”VideoGroup\”}”

GenerateMasterPlayList活動

名稱 類型 必須 描述
MasterPlayList String
  • HLS專屬參數,必填,視頻多碼流列表。參數參見:42 MasterPlayList詳情
  • 樣本:{“MultiBitrateVideoStreams”: [{“RefActivityName”: “video-1”,”ExtXStreamInf”: {“BandWidth”: “111110”,”Audio”: “auds”,”Subtitles”: “subs” }}]}。