本文介紹ApsaraVideo for Media Processing服務的幾個基本概念和關係,以便您更好的理解和使用ApsaraVideo for Media Processing服務。
- 媒體
媒體包含一個輸入(視頻、音頻多媒體檔案)和相關的所有輸出(例如,轉碼、截圖、媒體資訊、AI標籤等)。輸入和媒體是一一對應的,由媒體ID唯一標識。
媒體庫
媒體庫是所有媒體的集合,媒體是媒體庫的最小嵌入式管理單元。
- 媒體工作流程
媒體工作流程是自動化生產媒體的工廠,由MediaWorkflowId唯一標識。说明 媒體工作流程在文檔中也簡稱為工作流程。
- 活動
工作流程中的每個節點稱為活動。根據實際需求,即可以並存執行(例如,示意圖的作業A、B、C之間),也可以串列執行(例如:示意圖的作業A1、A2之間)。除開始的輸入活動和結束的發布彙報活動,活動支援各種類型的作業(轉碼作業、截圖作業等)。
- 開始的輸入活動
配置工作流程關聯儲存的觸發路徑,只要在對應的路徑上傳視頻、音頻多媒體檔案,就會自動觸發工作執行。
- 結束的發布彙報活動
工作流程執行完成後,會訊息通知執行結果。執行結果包含了媒體ID和多媒體檔案的絕對位址,這樣就能對應具體是哪個多媒體檔案執行完成。
- 作業活動
作業支援的所有參數,都可以在作業活動中配置。
- 開始的輸入活動
- 路徑匹配規則
匹配使用路徑首碼的規則,例如,上傳的檔案是
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv
,配置的觸發路徑結果如下: - 副檔名匹配規則
上傳時的自動觸發機制會檢查檔案的副檔名,避免產生一些無效的資料(例如pdf、word文檔等)。说明 API手動觸發機制不檢查副檔名。
檔案或者沒有副檔名(檔案名稱中不包含副檔名分割符號”.”),或者副檔名符合下面的規則:
- 視頻
3gp、asf、avi、dat、dv、flv、f4v、gif、m2t、m3u8、m4v、mj2、mjpeg、mkv、mov、mp4、mpe、mpg、mpeg、mts、ogg、qt、rm、rmvb、swf、ts、vob、wmv、webm
- 音頻
aac、ac3、acm、amr、ape、caf、flac、m4a、mp3、ra、wav、wma、aiff
- 視頻
- 工作流程執行
每次上傳匹配的多媒體檔案都會觸發一次執行,同一個多媒體檔案如果多次上傳,則會觸發多次執行,每次執行有唯一的RunId標識。
除了上傳時的自動觸發機制,工作流程針對儲存中的存量多媒體檔案,也提供了API手動觸發機制。每次調用API都會觸發一次執行。
- 使用者資料
每次執行時,可以填寫自訂的使用者資料參數(例如,商品ID),然後訊息通知中會返回自訂的使用者資料參數,這樣可以不需要在業務系統中記錄媒體ID或者多媒體檔案的絕對路徑,使用自訂的使用者資料(例如,商品ID)來關聯業務系統。
- 活動