如何添加截圖模板 - ApsaraVideo VOD

ApsaraVideo for VOD提供預設參數的截圖模板，用於在ApsaraVideo for Media Processing工作流程中自動執行視頻截圖。本文介紹截圖方式選擇、模板建立與管理，以及如何在工作流程中使用模板實現自動化截圖。

截圖方式對比

截圖方式分為普通截图、WebVTT和雪碧图，詳情請參見視頻截圖。

截圖方式	適用情境	優缺點
普通截圖	視頻封面、內容審核、精彩瞬間分享。	優點：靈活性高，適用於需要單張圖片的情境。缺點：若截圖數量多，會產生大量檔案和HTTP請求，影響載入效能。
WebVTT	Web/H5播放器進度條懸停時顯示預覽圖。	優點：適配Web/H5播放器進度條預覽。缺點：用途單一，無法作為獨立圖片使用。
雪碧圖	移動端或需要極致載入效能的播放器預覽圖情境。	優點：減少HTTP請求數，最佳化前端載入效能，適合移動端情境。缺點：配置流程相對複雜，且單張小圖無法直接引用。

單擊添加截图模板，在添加截圖模板頁面，根據業務需求配置截圖模板。

重要

截圖方式（普通截圖/WebVTT/雪碧圖）在建立模板後不可修改，請在儲存前確認選擇。

以下參數適用於所有截圖方式。

參數	說明
模板名稱	模板的自訂名稱，用於在工作流程中識別和引用。
起始時間點	截圖開始的時間點（時：分：秒）。
截圖數量	期望產生的截圖總數。
截圖間隔時間	多張截圖時的時間間隔。填0或留空時，按視頻時間長度均分截取。
尺寸（寬×高）	截圖的寬和高。單位：像素。說明未設定寬高時，截圖尺寸與輸入視頻寬高相同。僅設定寬或高時，未設定邊按視頻比例自動縮放，保持畫面不變形。
框架類型	截圖截取的框架類型包括：主要畫面格、普通幀。說明選擇主要畫面格類型時，僅截取主要畫面格；若指定時間點無主要畫面格，則自動選取最近主要畫面格。同等條件下，主要畫面格截圖比普通幀更快。

參數	說明
產生大圖	是否將WebVTT所需的多張縮圖拼接成大圖儲存。

參數	說明
排列（行×列）	雪碧圖中的小圖寬和高設定參數。說明未設定時小圖寬高與普通截圖相同；僅設定一邊時，另一邊等比縮放。
行間距	雪碧圖中各行小圖之間的垂直間距，單位：像素。
列間距	雪碧圖中各列小圖之間的水平間距，單位：像素。
背景顏色	產生雪碧圖的背景顏色。
保留小圖	是否在產生雪碧圖的同時，保留構成雪碧圖的原始圖。

建立後需要將截圖模板添加到工作流程中，在上傳媒體或ApsaraVideo for Media Processing環節使用。

綁定到工作流程。
登入ApsaraVideo for VOD控制台，進入配置管理 > 媒体处理配置 > 工作流管理，添加或編輯一個工作流程，在節點中插入视频截图節點，並在右側節點配置中選擇已建立的截圖模板。
觸發工作流程。
綁定完成後，可通過以下方式觸發工作流程。
1. 自動觸發：在上傳音視頻時，指定該工作流程。音視頻上傳完成後，工作流程將自動執行。詳情請參見通過ApsaraVideo for VOD控制台上傳檔案。
2. 手動觸發：在媒资库 > 音/視頻頁面，選擇目標媒資，單擊媒体处理，選擇用工作流处理並指定該工作流程。
3. API觸發：調用提交點播工作流程作業介面指定該工作流程作業。
擷取截圖結果。
可以通過視頻截圖完成事件通知擷取截圖結果。當視頻截圖成功後，系統會向配置的地址發送回調訊息，訊息體中包含了截圖資料列表。

ApsaraVideo for VOD的截圖功能完全免費。

可以通過以下步驟排查：

可以通過提交媒體截圖作業獨立發起截圖任務。