ApsaraVideo Media Processing：工作流程活動介紹

活動名稱

拓撲結構中的Activitiy類型

說明

輸入（必選）

Start

設定媒體工作流程的OSS輸入路徑和全域配置，包括管道、訊息。

發布（必選）

Report

設定手動發布、自動發布。

分析

Analysis

對輸入檔案進行智能分析，推薦出適合輸入檔案的預置模板。

轉碼

Transcode

可以將視頻檔案轉碼成適合在全平台播放的格式。

截圖

Screenshot

截取指定時間點的畫面，用做視頻封面或產生雪碧圖。

打包配置

PackageConfig

將多解析度視頻、多音軌、多字幕檔案打包產生M3U8的過程。

視頻組

VideoGroup

音頻組

AudioGroup

字幕組

SubtitleGroup

提取視頻

提取音頻

提取字幕

Transcode

打包產生

GenerateMasterPlayList

審核

Censor

智能識別視頻內語音、文字、畫面的色情、暴恐涉政、不良畫面等內容，大幅節省人工審核人力成本，降低違規風險。

視頻DNA

FpShot

用來唯一標記一個視頻，實現對視頻中的映像、音頻等指紋特徵的提取和比對，解決重複視頻尋找、視頻片段查源、原創識別等問題。

智能封面

Cover

通過對視頻內容的理解，結合畫面和海量使用者行為資料，基於演算法選出最優的主要畫面格或關鍵片段作為視頻封面，提升視頻點擊轉化及使用者體驗。

名稱

類型

是否必選

描述

InputFile

String

是

輸入檔案，使用OSS的Bucket、Location、Object描述檔案位置。

• 具體觸發匹配規則，請參見工作流程的檔案匹配規則。

• 檔案只支援儲存於OSS上，參數規範請參見參數詳情。

• 在ApsaraVideo for Media ProcessingAPI中，Object必須經過URL Encoding說明（基於UTF-8編碼）後使用。

• 樣本：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","ObjectPrefix":"example.mp4"}。

PipelineId

String

是

全域配置。管道ID。

• 僅分析/轉碼/截圖/打包使用該管道ID，AI類任務在節點中單獨配置。

• 工作流程情境，管道上的單獨配置的訊息無效，請使用工作流程QueueName/TopicName中配置的訊息。

MessageType

String

否

全域配置。訊息類別。

• Queue：使用MNS隊列。請設定為QueueName。

• Topic：使用MNS主題。請設定為TopicName。

• 預設值：Queue。

QueueName

String

否

全域配置。ApsaraVideo for Media Processing管道上綁定的MNS隊列。綁定後，當該管道上的作業執行結束時，會將執行結果發送到該隊列。訊息請參見接收訊息通知。

• 可選值：您已經建立的MNS隊列，若無可用隊列請先前往Simple Message Queue (formerly MNS)中建立。

TopicName

String

否

全域配置。ApsaraVideo for Media Processing管道上綁定的MNS主題。綁定後，當該管道上的作業執行結束時，會將執行結果發送到該主題。主題會以訊息形式推送到訂閱的地址上，訊息請參見接收訊息通知。

• 可選值：您已經建立的MNS主題，若無可用主題請先前往Simple Message Queue (formerly MNS)中建立。

RoleName

String

否

全域配置。授權角色名稱。

• 預設值：AliyunMTSDefaultRole。

名稱

類型

必須

描述

PublishType

String

否

全域配置。媒體發布類型。

• Manual：手動發布。工作流程執行成功後，將媒體設定為未發布狀態，之後您可以手動發布該媒體。請參見管理媒體。

• Auto：所有活動完成後自動發布。工作流程執行成功後，將媒體設定為發布狀態。

• TranscodeCompletedAuto：任一轉碼活動完成後自動發布。將使用Start節點的訊息配置通知使用者轉碼完成。若轉碼活動的狀態是跳過的話，不會發送訊息。

• 預設值：Manual。

  說明

  • ApsaraVideo for Media Processing在執行工作流程進行檔案處理時，針對不同的發布類型，會使用STS臨時使用者對輸出檔案進行調整。

  • 發布狀態會影響輸出檔案的存取權限。

    • 不發布：視頻、音頻、截圖檔案的存取權限為私人。

    • 發行：視頻、音頻、截圖檔案的存取權限繼承所在Bucket的存取權限。

名稱

類型

必須

描述

KeepOnlyHighestDefinition

String

否

是否只保留最高清晰度的分析結果。

• True：僅輸出可選範圍內的最高清晰度。

• False：輸出可選範圍內全部清晰度。

• 預設值：False。

名稱

類型

必須

描述

Outputs

String

否

轉碼作業輸出。

• Outputs由Output列表構成，JSON數組，大小上限為30。

• 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打包，提取視頻流時必填。

• 更多資訊，請參見參數詳情。

• 樣本：{"URI": "c/d/video1.m3u8"}。

ExtXMedia

String

否

HLS打包，提取音頻流或者字幕流時必填。

• 更多資訊，請參見參數詳情。

• 樣本：{"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}。

WebVTTSubtitleURL

String

否

HLS打包，提取字幕流活動必填，字幕輸出地址。

• 目前只支援WebVTT字幕檔案，必須符合URL規範，可以在調用AddMedia時覆蓋字幕地址。

• 樣本：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitles****-en.vtt。

Representation

String

否

DASH打包，提取視頻流、音頻流或者字幕流活動時必填。

• 更多資訊，請參見參數詳情。

• 樣本：{\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}。

InputConfig

String

否

DASH打包，提取字幕流活動必填，字幕輸出地址。

• 更多資訊，請參見參數詳情。

• 樣本："{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle****-en.vtt\"}}"。

名稱

類型

必須

描述

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。

名稱

類型

必須

描述

Output

String

是

JSON字串。樣本：{"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}。

Protocol

String

是

值範圍：hls、dash。

名稱

類型

必須

描述

AdaptationSet

String

否

視頻組資訊。DASH打包，必填。

• 更多資訊，請參見參數詳情。

• 樣本："AdaptationSet":"{\"Group\":\"VideoGroup\"}"。

名稱

類型

必須

描述

GroupId

String

否

音頻分組ID。HLS打包，必填。

• 長度不能超過32個位元組。

AdaptationSet

String

否

音頻組資訊。DASH打包，必填。

• 更多資訊，請參見參數詳情。

• 樣本："{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}"。

名稱

類型

必須

描述

GroupId

String

否

字幕分組ID。HLS打包，必填。

• 長度不能超過32個位元組。

AdaptationSet

String

否

字幕組資訊。DASH打包，必填。

• 更多資訊，請參見參數詳情。

• 樣本："{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}"。

名稱

類型

必須

描述

MasterPlayList

String

否

• HLS專屬參數，必填，視頻多碼流列表。更多資訊，請參見參數詳情。

• 樣本：{"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}。