全部產品
Search
文件中心

:配置工作流程範本(新)

更新時間:Dec 05, 2025

在使用智能媒體服務媒資上傳或處理已上傳的媒資時,您可以基於工作流程範本進行ApsaraVideo for Media Processing。本文介紹工作流程的基本概念及使用方式。

功能概覽

基本概念

基本概念

說明

媒體工作流程(MediaWorkflow)

工作流程是預先編排好的一系列任務流程,可以實現在指定(或任意)OSS Bucket上傳一個檔案後,自動(或手動)觸發按照預先編排好的環節和條件依次執行作業。由媒體工作流程ID(MediaWorkflowId)唯一標識。

節點/活動(Activity)

工作流程中的每個節點(即一個單任務操作)稱為活動。每個工作流程必須包含開始和結束節點,中間節點可以自由編排。根據目前範圍,支援添加轉碼、截圖、智能審核、視頻DNA、智能封面任務。

輸入來源(MediaType)

觸發工作流程的媒體檔案來源,支援媒資庫媒資和Object Storage Service檔案兩種輸入源。

觸發方式(TriggerMode)

僅輸入來源為Object Storage Service時可設定工作流程觸發方式,支援自動觸發(預設)、手動觸發。

工作流程工作執行個體(TaskId)

工作流程每次執行,會產生工作流程工作執行個體(TaskId)作為唯一標識。

媒體ID(MediaId)

媒體包含一個音視頻輸入相關的所有輸出(例如:轉碼、截圖、封面、媒體資訊、審核結果、AI標籤等)。輸入和媒體是一一對應的,由媒體ID唯一標識。通過工作流程產生的所有資訊都屬於這個媒體ID。

應用情境

  • UGC視頻生產,上傳後先通過審核、DNA過濾低質內容,只對審核通過和非重複內容進行轉碼和標籤處理。

使用限制

  • 每個使用者(指每個阿里雲帳號)在每個服務地區預設可建立10個工作流程。

  • 不同地區功能支援情況不同,工作流程支援的活動也不相同。功能支援情況請參見服務地區

工作流程使用

建立工作流程

重要
  • 工作流程建立後,將自動啟用為啟用狀態。以Object Storage Service為輸入源,且觸發模式為自動觸發時,無論以何種方式新增上傳(OSS上傳、控制台上傳)至工作流程綁定的輸入路徑的檔案,只要滿足觸發規則,就會自動觸發工作流程執行。

  1. 登入智能媒體服務控制台

  2. 在智能媒體服務控制台左側導覽列的點播ApsaraVideo for Media Processing地區,單擊工作流程管理

  3. 在頂部左上方根據實際情況選擇地區。

  4. 點擊自訂頁簽,進入工作流程自訂配置頁面。

  5. 點擊建立工作流程範本,進入工作流程範本介面。

    image

    參數

    描述

    模板名稱

    工作流程範本名稱。由1~64位大小寫字母、中文、數字、底線(_)、短劃線(-)組成。

    模板描述

    模板描述。

    事件回調

    • 使用統一回調配置:使用回調設定中配置的HTTP請求或MNS隊列,詳情請參見設定回調事件

    • 使用獨立回調配置:僅對使用工作流程範本的子任務生效。

    回調方式

    事件回調使用獨立回調配置時,可以選擇回調方式為HTTP請求MNS隊列

    回調URL

    接收訊息通知的URL。當產生回調事件時,服務端會向此URL發起HTTP POST請求。

    隊列名稱

    接收訊息通知的MNS隊列。請使用ice-callback開頭命名的隊列,如果沒有可用的隊列,需要在MNS控制台建立。具體操作,請參見建立隊列

    輸入及輸出配置

    • 媒資庫:當前地區媒資庫。

    • Object Storage Service:

      • 觸發模式:上傳後自動觸發或手動觸發。

      • 輸入路徑:單擊選擇。在Bucket下拉式清單中,選擇Bucket名稱。路徑下方會顯示對應Bucket已經建立好的檔案夾,在檔案夾下選擇一個地址作為輸入路徑。

    工作流程節點配置

    • 單擊ico_add,添加工作流程節點,支援添加串列和並行節點。

    • 單擊ico_modify,編輯工作流程節點。

    • 單擊ico_delete,刪除工作流程節點。

      重要

      工作流程節點刪除後不能恢複,如果該節點存在後續節點,則後續節點將一起被刪除。

編輯/停用工作流程

單擊操作列指定功能,您可以對工作流程範本進行查看、編輯、啟用、停用、測試、複製和刪除操作。

說明
  • 系統預置的工作流程範本,僅支援在控制台查看、啟用和停用,不支援複製、編輯和刪除。

  • 狀態已停用的工作流程範本才支援在控制台編輯和刪除,如有需要,請先停用工作流程範本。

  • 狀態啟用中的工作流程範本才可用於發起ApsaraVideo for Media Processing。

  • 狀態啟用中內容來源為Object Storage Service(oss)的工作流程範本才支援在控制台測試工作流程。

觸發工作流程

根據媒體檔案來源,分為媒資庫媒資來源觸發和Object Storage Service(oss)來源觸發。其中Object Storage Service(oss)來源觸發根據檔案路徑、是否自動觸發又分為如下表3種方式,詳情請參見觸發工作流程

觸發方式

適用情境

自動觸發

新上傳到輸入路徑且符合格式等要求的檔案,會自動觸發工作流程執行。

手動觸發(校正輸入路徑)

  • 歷史資料處理,對已儲存在OSS的檔案按工作流程批量處理

  • 檔案上傳後不需要立刻處理,比如等待有使用者訪問、播放量較高後再處理

  • 檔案需要按商務邏輯,選擇執行不同的工作流程

手動觸發(任意路徑)

檔案路徑很多無法配置成統一路徑,但工作流程處理流程相同,需要手動提交

擷取執行結果

  • 控制台查詢:登入ApsaraVideo for Media Processing控制台,選擇點播ApsaraVideo for Media Processing > 任務管理 > 工作流程,查看詳情。

  • API查詢:調用GetWorkflowTask - 查詢工作流程工作。傳入TaskId,查詢該次工作流程執行的活動列表資訊(如活動類型、狀態、JobId)、MNS通知、使用者自訂資料、媒體ID。

  • 配置MNS擷取:在工作流程的輸入節點中配置工作流程MNS訊息。當工作流程開始和完成後,ApsaraVideo for Media Processing服務會向MNS發送訊息,您可以通過MNS接收訊息,擷取該次工作流程執行的相關資訊。

工作流程常用情境

  • 多路轉碼並行

    該流程會按照設定的多路轉碼節點進行多碼流輸出。

    image