注意云點播【托管模式】功能將逐步調整下線,存量用戶仍可繼續使用。新用戶請使用【點播模式】。
綜述
工作流(Workflow)是預先編排好的一系列任務流程。云點播【托管模式】監聽特定對象存儲路徑,在文件上傳監聽路徑后觸發消息通知,按照預設的工作流程執行轉碼、截圖、審核等任務動作。每個動作都可以實現多任務并發,一進多出。以下我們將通過一個具體示例來闡明工作原理。
下圖闡釋了一個樣例文件sample.mp4從本機上傳至對象存儲桶的監聽路徑后觸發工作流事件的完整流程。
- 用戶本機的文件sample.mp4通過SDK、用戶控制臺或第三方S3工具上傳至媒體存儲。在文件完成傳輸完成后,媒體存儲根據工作流的配置判斷后,會生成一個事件通知。判斷的依據主要為:
(1)該文件是否上傳至工作流配置的監聽路徑下。注意,如果文件實際上傳路徑深于監聽路徑,也是可以觸發事件的。例如監聽目錄為input/,而文件實際上傳至input/path1/path2/sample.mp4。
(2)該文件的擴展名是否在工作流支持的文件類型范圍內。注意,媒體存儲僅判斷該文件擴展名是否在支持列表內(不區分大小寫)。因此如果文件不包含擴展名,或者擴展名不正確,均不能正常觸發工作流事件。
(3)該工作流是否已經啟用。 - 云點播接收到媒體存儲的事件通知后,會根據監聽路徑匹配的工作流配置,產生特定的處理指令發送給各功能模塊。
- 各功能模塊在完成任務后,會執行以下操作(1)將執行產生的數據文件(視頻、截圖等)回寫至工作流配置的輸出路徑下;(2)按照工作流(或全局回調)配置的回調路徑,將任務結果(JSON格式)以HTTP POST方法發送至指定回調地址。
- 用戶接收回調事件后處理后續業務流程。
新建工作流
前提條件
- 已開通云點播產品。
- 已開通至少一個點播區域。
- 已經完成至少一個存儲桶的托管。
操作步驟
進入,選擇左側導航欄的【托管模式】–【工作流設置】可打開工作流的配置頁面(如下圖所示)。

列表中展示各字段說明
| 一級選項 | 二級選項 | 取值樣例 | 說明 |
|---|---|---|---|
| 工作流ID | 100100000440 | 工作流ID,用作云點播系統內的標識,在云點播系統內全局唯一。 | |
| 工作流名稱 | 工作流測試 | 工作流的可讀化名稱。 | |
| 狀態 | 已啟用 | 當前工作流的啟用狀態。【已停用】代表當前工作流未啟用,當有文件寫入時不觸發動作;【已啟用】代表當前工作流處于激活狀態,當有文件寫入時會觸發動作。 | |
| 創建時間 | 2023-07-10 16:12:37 | 工作流的創建時間。 | |
| 修改時間 | 2023-07-10 16:12:37 | 工作流的修改時間。 | |
| 操作 | 詳情 | 當前工作流的配置細節。 | |
| 操作 | 啟用 | 當該工作流處于停用狀態時,點擊可啟用該工作流。 | |
| 操作 | 停用 | 當該工作流處于啟用狀態時,點擊可停用該工作流。 | |
| 操作 | 修改 | 當該工作流處于停用狀態時,點擊對該工作流的動作部分進行修改。 | |
| 操作 | 刪除 | 當該工作流處于停用狀態時,點擊將刪除該工作流。 |
當用戶點擊該頁面左上角的【新建工作流】時,可進入工作流新建頁面。創建一條合法工作流,總共有兩個步驟:
步驟一:輸入設置
在該頁面,您需要填入以下內容:

需填入數據字段說明
| 一級選項 | 二級選項 | 是否必填 | 說明 |
|---|---|---|---|
| 工作流名稱 | 是 | 用戶需要為該工作流起一個容易記憶、標識的名稱。該名稱需要遵循以下規則:中英文字符、數字、下劃線和短橫線“-”,不超過20位。 | |
| 備注 | 否 | 用戶可以在備注欄補充關于該工作流的一些細節描述,供管理使用。總字數長度不超過200字即可。 | |
| 工作流回調 | 否 | 用戶可以為該工作流配置一個專屬的回調地址,專門用于接收該工作流產生的所有動作事件。關于該回調配置的詳細說明,可查閱【托管模式】-【回調通知】。 | |
| 輸入 | 托管存儲區 | 是 | 托管桶所在的存儲資源池位置。 |
| 輸入 | 存儲桶 | 是 | 托管桶名稱,您可以在下拉框找到之前托管授權的所有存儲桶名稱。如果是子賬戶配置,此處需要準確填寫存儲桶名稱,無下拉選項。 |
| 輸入 | 對象路徑 | 是 | 該工作流的動作觸發入口。當有文件寫入到該路徑時,將會觸發后續的工作流動作。請注意路徑的命名規范。輸入路徑默認需以"/"結尾,表示一個“目錄”。如用戶在工作流配置中未輸入"/",系統會自動為用戶補全。 |
| 輸入 | 媒體類型 | 是 | 寫入上述對象路徑的文件,云點播將會根據本設置項預設的文件類型決定是否觸發工作流動作。您需要確保寫入的文件擴展名在該媒體類型支持的范圍內。目前已經支持的媒體類型詳見功能介紹。 |
注意
該頁面配置的信息在工作流完成后輸入部分的信息不可再修改,請注意確保信息準確。
請注意本步驟配置的輸入路徑不要跟下一步的輸出路徑重復,否則可能造成循環觸發造成您的經濟損失。
托管存儲區+存儲桶+輸入路徑的組合在租戶級別全局唯一,因此不允許出現多條工作流中出現這三個參數完全一致的情況。
步驟二:動作設置
在步驟一配置完成后,點擊【下一步】進入動作設置的配置頁面。

在該頁面,您可以為工作流配置轉碼、截圖、審核、拼接四種動作。當上一步的輸入路徑寫入文件后,這里配置的動作會并行觸發。您可以根據這個機制,實現一次寫入,所有動作同步完成的效果,提升處理效率。除了審核動作外,其他動作都支持配置0-N條平行子配置,但這四個動作中至少需要配置一個。在每個動作的左上角,點擊【添加配置】均可增加一條相關配置,具體的配置說明可參考以下表格。
轉碼動作配置
| 配置項 | 是否必填 | 說明 |
|---|---|---|
| 轉碼模板 | 是 | 當輸入文件符合步驟一的輸入配置時,將按照該轉碼模板執行轉碼動作。相關模板的配置可參考【公共模板管理】-【轉碼模板】。 |
| 水印模板 | 否 | 在執行轉碼時,如果需要對轉碼后視頻疊加水印,可配置水印模板。相關模板的配置可參考【公共模板管理】-【水印模板】。 |
| 托管存儲區 | 是 | 轉碼后輸出文件的存儲區域。 |
| 輸出Bucket | 是 | 轉碼后輸出文件的存儲桶名稱,需要是已經托管的存儲桶。 |
| 輸出路徑 | 是 | 轉碼后輸出文件的在存儲桶內的路徑前綴。 請注意此路徑不要跟上一步的輸入路徑相同。 輸出路徑默認需以"/"結尾,表示一個“目錄”。如用戶在工作流配置中未輸入"/",系統會自動為用戶補全。 |
| 命名規則 | 是 | 輸出文件的命名規律。為了避免同名文件產生的標識混亂,同時建立輸入、輸出文件的關聯,云點播在此引入兩個文件名變量{input}和{follow_input}。 其中{input}代表輸入文件的文件名部分(不包含擴展名)。{follow_input}代表輸入路徑后除擴展名以外的部分。 例如:用戶在某桶的input/監聽路徑下,又新建了名為【pathA】的子目錄。并在該子目錄下上傳了一個媒體文件sample.mp4,其完整輸入路徑為 "input/pathA/sample.mp4"。 則在輸出路徑產生的輸出文件中,{input}代表了“sample”部分。而{follow_input}代表了"pathA/sample"部分。 此處{input}和{follow_input}變量,您必須任意選擇其中一種。也可以在此基礎上添加其他允許字符(包括數字、英文、中文、英文點號、下劃線、短橫線),以匹配業務需求。 |
| ACL權限 | 是 | 輸出文件的ACL權限。您可以選擇【公共讀】或者【私有】。請注意,文件的ACL權限和桶ACL權限作用范圍不同。詳情可查閱ACL權限的描述。 |
| 刪除配置 | 否 | 刪除當前配置。 |
截圖動作配置
| 配置項 | 是否必填 | 說明 |
|---|---|---|
| 截圖模板 | 是 | 當輸入文件符合步驟一的輸入配置時,將按照該截圖模板執行截圖動作。相關模板的配置可參考【公共模板管理】-【截圖模板】。 |
| 水印模板 | 否 | 在執行截圖時,如果需要對截圖圖片疊加水印,可配置水印模板。相關模板的配置可參考【公共模板管理】-【水印模板】。 |
| 托管存儲區 | 是 | 截圖后輸出文件的存儲區域。 |
| 輸出Bucket | 是 | 截圖后輸出文件的存儲桶名稱,需要是已經托管的存儲桶。 |
| 輸出路徑 | 是 | 截圖后輸出文件的在存儲桶內的路徑前綴。 請注意此路徑不要跟上一步的輸入路徑相同。 輸出路徑默認需以"/"結尾,表示一個“目錄”。如用戶在工作流配置中未輸入"/",系統會自動為用戶補全。 |
| 命名規則 | 是 | 輸出文件的命名規律。為了避免同名文件產生的標識混亂,同時建立輸入、輸出文件的關聯,云點播在此引入兩個文件名變量{input}和{follow_input}。 其中{input}代表輸入文件的文件名部分(不包含擴展名)。{follow_input}代表輸入路徑后除擴展名以外的部分。 例如:用戶在某桶的input/監聽路徑下,又新建了名為【pathA】的子目錄。并在該子目錄下上傳了一個媒體文件sample.mp4,其完整輸入路徑為 "input/pathA/sample.mp4"。 則在輸出路徑產生的輸出文件中,{input}代表了“sample”部分。而{follow_input}代表了"pathA/sample"部分。 此處{input}和{follow_input}變量,您必須任意選擇其中一種。也可以在此基礎上添加其他允許字符(包括數字、英文、中文、英文點號、下劃線、短橫線),以匹配業務需求。 由于截圖任務可能會產生一系列圖片,因此在實際輸出的圖片文件,將會以{input}或{follow_input}為前綴,疊加模版ID和截圖時間點生成圖片名稱。 例如命名規則為{input}_snap,實際截圖任務產生了10張圖片,截圖從0秒開始,每張截圖間隔5秒,截圖模版ID100000000049,則這10張圖片將以{input}_snap_100000000049-00.0.jpg、{input}_snap_100000000049-05.0.jpg等進行編號。完整的圖片列表可以通過訂閱回調獲得。 |
| ACL權限 | 是 | 輸出文件的ACL權限。您可以選擇【公共讀】或者【私有】。請注意,文件的ACL權限和桶ACL權限作用范圍不同。詳情可查閱ACL權限的描述。 |
| 刪除配置 | 否 | 刪除當前配置。 |
審核動作配置
| 配置項 | 是否必填 | 說明 |
|---|---|---|
| 審核模板 | 是 | 當輸入文件符合步驟一的輸入配置時,將按照該審核模板執行審核動作。相關模板的配置可參考【公共模板管理】-【審核模板】。 |
| 審核類型 | 是 | 審核的類型,目前僅支持【視頻審核】。 |
| 托管存儲區 | 是 | 審核后輸出的審核截圖和違規圖片的存儲區域。 |
| 輸出Bucket | 是 | 審核后輸出的審核截圖和違規圖片的存儲桶名稱,需要是已經托管的存儲桶。 |
| 輸出路徑 | 是 | 審核后輸出的審核截圖和違規圖片在存儲桶內的路徑前綴。 請注意此路徑不要跟上一步的輸入路徑相同。 輸出路徑默認需以"/"結尾,表示一個“目錄”。如用戶在工作流配置中未輸入"/",系統會自動為用戶補全。 |
| 命名規則 | 是 | 審核后輸出的審核截圖和違規圖片的命名規律。請注意,該字段不允許修改。您需要遵循{input}_audit的命名規律。實際輸出的圖片文件,將會以{input}_audit自定義字段為前綴,疊加模版ID和截圖時間點生成圖片名稱。例如某視頻審核任務產生了10張圖片,截圖從0秒開始,每張截圖間隔5秒,審核模版ID100000000049,則這10張圖片將以{input}_audit_100000000049-00.0.jpg、{input}_audit_100000000049-05.0.jpg等進行編號。完整的圖片列表可以通過訂閱回調獲得。 |
| ACL權限 | 是 | 輸出文件的ACL權限。由于審核圖片可能包含違禁內容,故此類文件不允許修改權限為公共讀。 |
| 刪除配置 | 否 | 刪除當前配置。 |
拼接動作配置
| 配置項 | 是否必填 | 說明 |
|---|---|---|
| 拼接模板 | 是 | 當輸入文件符合步驟一的輸入配置時,將按照該拼接模板執行拼接動作。相關模板的配置可參考【公共模板管理】-【拼接模板】。 |
| 水印模板 | 否 | 在執行拼接時,如果需要對拼接視頻疊加水印,可配置水印模板。相關模板的配置可參考【公共模板管理】-【水印模板】。 |
| 托管存儲區 | 是 | 拼接后輸出文件的存儲區域。 |
| 輸出Bucket | 是 | 拼接后輸出文件的存儲桶名稱,需要是已經托管的存儲桶。 |
| 輸出路徑 | 是 | 拼接后輸出文件的在存儲桶內的路徑前綴。 請注意此路徑不要跟上一步的輸入路徑相同。 輸出路徑默認需以"/"結尾,表示一個“目錄”。如用戶在工作流配置中未輸入"/",系統會自動為用戶補全。 |
| 命名規則 | 是 | 輸出文件的命名規律。為了避免同名文件產生的標識混亂,同時建立輸入、輸出文件的關聯,云點播在此引入兩個文件名變量{input}和{follow_input}。 其中{input}代表輸入文件的文件名部分(不包含擴展名)。{follow_input}代表輸入路徑后除擴展名以外的部分。 例如:用戶在某桶的input/監聽路徑下,又新建了名為【pathA】的子目錄。并在該子目錄下上傳了一個媒體文件sample.mp4,其完整輸入路徑為 "input/pathA/sample.mp4"。 則在輸出路徑產生的輸出文件中,{input}代表了“sample”部分。而{follow_input}代表了"pathA/sample"部分。 此處{input}和{follow_input}變量,您必須任意選擇其中一種。也可以在此基礎上添加其他允許字符(包括數字、英文、中文、英文點號、下劃線、短橫線),以匹配業務需求。 |
| ACL權限 | 是 | 輸出文件的ACL權限。您可以選擇【公共讀】或者【私有】。請注意,文件的ACL權限和桶ACL權限作用范圍不同。詳情可查閱媒體存儲(原 對象存儲融合版)ACL權限的描述。 |
| 刪除配置 | 否 | 刪除當前配置。 |
| 判定條件 | 否 | 用戶可以在工作流中,根據輸入文件的metadata元數據信息決定是否執行拼接動作。例如當主文件播放時間大于1分鐘以上,才執行拼接操作;或者當視頻平均碼率大于5Mbps以上視頻,才進行拼接。用戶可以在一個拼接動作中預設多個判定條件,當這多個判定條件同時滿足時才觸發該拼接動作。當前云點播支持的判定條件包括【播放時長】【視頻高度】【視頻寬度】【視頻碼率】。 |
最后點擊【完成】按鈕后,即可完成對當前工作流的創建。需要注意的是,新創建的工作流默認處于禁用狀態,您需要在【工作流設置】頁面點擊【啟用】激活當前工作流。
刪除工作流
前提條件
- 已開通云點播產品。
- 已開通至少一個點播區域。
- 已經完成至少一個存儲桶的托管。
- 使用主賬號登陸用戶控制臺。
操作步驟
進入,選擇左側導航欄的【托管模式】–【工作流設置】可打開工作流的配置頁面(如下圖所示)。在該頁面選擇一條工作流配置,如果當前工作流處于【啟用】狀態,您需要首先在操作欄點擊【更多】-【停用】將該工作流置于停用狀態,然后點擊隨后出現的【刪除】按鈕,即可刪除該工作流。當該工作流刪除后,與之相關的各類公共模版的關聯檢查也隨之解除,您可以自行刪除關聯的公共模版。

修改工作流
前提條件
- 已開通云點播產品。
- 已開通至少一個點播區域。
- 已經完成至少一個存儲桶的托管。
- 至少創建了一條工作流。
- 使用主賬號登陸用戶控制臺。
操作步驟
進入,選擇左側導航欄的【托管模式】–【工作流設置】可打開工作流的配置頁面(如下圖所示)。在該頁面選擇一條工作流配置,如果當前工作流處于【啟用】狀態,您需要首先在操作欄點擊【停用】將該工作流置于停用狀態,然后點擊隨后出現的【修改】按鈕,即可修改該工作流。修改操作與新建操作流程步驟基本一致,此處不再贅述。需要注意一點,已經創建的工作流不允許修改步驟一中的輸入部分,請在創建工作流時確保這部分內容的正確性。
