功能概述

應(yīng)用場(chǎng)景

• 視頻封面：選取首幀作為feed流短視頻的封面圖，或截取視頻指定時(shí)間點(diǎn)的畫面作為封面。

• 視頻預(yù)覽：制作視頻內(nèi)容縮略圖。當(dāng)用戶在播放器的時(shí)間軸上懸停時(shí)，可以顯示視頻特定時(shí)間點(diǎn)的靜態(tài)縮略圖，幫助用戶快速瀏覽視頻內(nèi)容，并跳轉(zhuǎn)到他們感興趣的部分。

• 視頻審核：對(duì)視頻內(nèi)容進(jìn)行截圖采樣，供人工或機(jī)器審核。

功能特性

計(jì)費(fèi)說明

按截圖張數(shù)收取功能接口請(qǐng)求費(fèi)用。詳細(xì)計(jì)費(fèi)說明，請(qǐng)參見功能接口請(qǐng)求定價(jià)。

控制臺(tái)提交截圖任務(wù)

1. 登錄媒體處理控制臺(tái)。

2. 在頂部菜單欄左側(cè)選擇地域。

3. 在左側(cè)導(dǎo)航欄，選擇工作流 > 工作流編排。

4. 單擊創(chuàng)建工作流。

5. 按需配置輸入節(jié)點(diǎn)。

6. 添加截圖節(jié)點(diǎn)。

7. 單擊截圖節(jié)點(diǎn)右側(cè)的筆形圖標(biāo)，配置截圖參數(shù)。

   參數(shù)	是否必選	說明
   截圖方式	必選	單張截圖：設(shè)置一個(gè)明確的截圖時(shí)間點(diǎn)，截取對(duì)應(yīng)的視頻圖像。 多張截圖：按照設(shè)置的間隔時(shí)間，均勻的截取對(duì)應(yīng)視頻的多幀圖像，每幀圖像都是一個(gè)圖片文件。也叫批量截圖、序列截圖。 平均截圖：按照設(shè)定的截圖張數(shù)，均勻地對(duì)視頻進(jìn)行切分并截取指定數(shù)量的圖像。
   截圖間隔時(shí)間（秒）	多張截圖時(shí)必選	在文本框中輸入截圖間隔時(shí)間，單位為秒。
   截圖數(shù)量	平均截圖時(shí)必選	在文本框中輸入截圖數(shù)量。 說明 不設(shè)置截圖數(shù)量時(shí)，表示按照間隔時(shí)間，一直截取到視頻結(jié)尾。 截圖數(shù)量大于1時(shí)，表示按照間隔時(shí)間，截取到指定數(shù)量的圖像時(shí)就停止截圖。 只設(shè)置截圖數(shù)量時(shí)，表示按總時(shí)長/截圖數(shù)量的時(shí)間間隔，平均截圖。
   名稱	必選	在文本框中輸入本節(jié)點(diǎn)名稱。
   輸出路徑	必選	單擊選擇，在Bucket下拉列表中，選擇Bucket名稱。路徑下方會(huì)顯示對(duì)應(yīng)Bucket已經(jīng)創(chuàng)建好的文件夾，在文件夾下選擇一個(gè)地址作為輸出路徑。 說明 單張截圖路徑格式：http://bucket.oss-cn-hangzhou.aliyuncs.com/path/{RunId}/{SnapshotTime}.jpg。 多張截圖/平均截圖路徑格式：需要使用{Count}占位符，即path后為/{RunId}/{SnapshotTime}/{Count}.jpg。
   開始時(shí)間	非必選	在下拉列表中按時(shí)、分、秒，選擇時(shí)間。
   寬度×高度	非必選	在輸入框中分別填寫寬度和高度值。 說明 如果寬和高都不設(shè)置時(shí)，圖片的尺寸和視頻相同。 如果只設(shè)置寬（或高）時(shí)，另一邊會(huì)按照視頻的分辨率保持比例不變，避免圖像變形。
   生成Webvtt索引文件	多張截圖、平均截圖時(shí)可選	單擊開關(guān)按鈕，表示需要生成webVTT格式的索引文件。
   設(shè)為封面	非必選	單擊開關(guān)按鈕，此節(jié)點(diǎn)截取的圖片會(huì)自動(dòng)設(shè)置為媒體庫中該媒體的封面，當(dāng)有多張截圖時(shí)，默認(rèn)第一張?jiān)O(shè)為封面。
   關(guān)鍵幀	非必選	單擊開關(guān)按鈕，截圖類型如果為關(guān)鍵幀，則表示只截取關(guān)鍵幀，如對(duì)應(yīng)指定時(shí)間點(diǎn)為非關(guān)鍵幀，則就近選取關(guān)鍵幀。
   黑屏檢測(cè)	多張截圖、平均截圖時(shí)可選	單擊開關(guān)按鈕，會(huì)檢測(cè)視頻的前5秒，如果前5秒內(nèi)存在畫面，則截取第一幀非黑屏的畫面。

8. 單擊確定，完成截圖節(jié)點(diǎn)設(shè)置。

9. 單擊保存，完成工作流配置。

   說明

   工作流創(chuàng)建完成后，當(dāng)有符合條件的新文件進(jìn)入指定路徑時(shí)，會(huì)自動(dòng)觸發(fā)工作流執(zhí)行。更多觸發(fā)方式說明，請(qǐng)參見觸發(fā)工作流。

API提交截圖任務(wù)

1. 上傳視頻到OSS。

2. 提交截圖任務(wù)。調(diào)用SubmitSnapshotJob - 提交截圖作業(yè)接口，通過指定SnapshotConfig參數(shù)，來實(shí)現(xiàn)提交同步單張截圖、異步單張截圖、雪碧圖、WebVTT截圖等功能。SnapshotConfig參數(shù)結(jié)構(gòu)示例如下，詳見參數(shù)詳情。

   同步單張截圖

   在視頻第100毫秒處截取1張關(guān)鍵幀。輸出圖片寬為1280px，高度自適應(yīng)。保存為jpg格式。
   同步模式不可設(shè)置Num和Interval參數(shù)，不支持輸出雪碧圖和vtt。
   {
     "Time":"100",
     "FrameType":"intra",
     "Width":"1280",
     "OutputFile":{
     	"Bucket":"example-bucket",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example.jpg"
   	}
   }

   異步單張截圖

   在視頻開頭截取1張關(guān)鍵幀，開啟首幀黑屏檢測(cè)。輸出圖片的尺寸和視頻相同。保存為jpg格式。
   {
     "Num":"1",
     "Time":"0",
     "FrameType":"intra",
     "BlackLevel":"100",
     "PixelBlackThreshold":"30",
     "OutputFile":{
     	"Bucket":"example-bucket",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example.jpg"
   	}
   }

   采樣截圖

   從視頻開頭開始，每隔10秒截取一張普通幀，直到截夠200張或到視頻結(jié)尾。
   對(duì)第一張圖開啟首幀黑屏檢測(cè)。輸出圖片的尺寸和視頻相同。保存為example{Count}.jpg。
   {
     "Num":"200",
     "Time":"0",
     "Interval":"10",
     "FrameType":"normal",
     "BlackLevel":"100",
     "PixelBlackThreshold":"30",
     //為了避免文件覆蓋，多張截圖OutputFile必須設(shè)置{Count}占位符
     "OutputFile":{
     	"Bucket":"example-bucket",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example{Count}.jpg"
   	}
   }

   平均截圖

   從視頻第100毫秒開始到片尾之間，均勻截取200張普通幀。輸出圖片寬為1280px，高為720px。保存為example{Count}.jpg。
   {
     "Num":"200",
     "Time":"100",
     "Interval":"0",
     "FrameType":"normal",
     "Width":"1280",
     "Height":"720",
     //為了避免文件覆蓋，多張截圖OutputFile必須設(shè)置{Count}占位符
     "OutputFile":{
     	"Bucket":"example-bucket",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example{Count}.jpg"
   	}
   }

   雪碧圖

   從視頻第100毫秒開始到片尾之間，均勻截取200張普通幀。輸出圖片寬為1280px，高為720px。
   將小圖按10*10的布局拼接成雪碧圖，雪碧圖保存在example-bucket002中，小圖保存在example-bucket001中。
   {
     "Num":"200",
     "Time":"100",
     "Interval":"0",
     "FrameType":"normal",
     "Width":"1280",
     "Height":"720",
     //為了避免文件覆蓋，多張截圖OutputFile必須設(shè)置{Count}占位符
     "OutputFile":{
    		"Bucket":"example-bucket001",
   	  "Location":"oss-cn-hangzhou",
   	  "Object":"example{Count}.jpg"
   	},
     "TileOut":{
       "Lines":10,
       "Columns":10,
       "Padding":"2",
       "Margin":"4",
       "Color":"black",
       "IsKeepCellPic":"true"
     },
     //為了避免文件覆蓋，請(qǐng)將OutputFile和TileOutputFile設(shè)置成不同Bucket或Object路徑，且雪碧圖TileOutputFile必須設(shè)置{TileCount}占位符
     "TileOutputFile":{ 
     	"Bucket":"example-bucket002",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example{TileCount}.jpg"
   	}
   }

   WebVTT圖

   從視頻第100毫秒開始到片尾之間，均勻截取200張普通幀。輸出圖片寬為1280px，高為720px。輸出vtt文件。
   {
     "Num":"200",
     "Time":"100",
     "Interval":"0",
     "FrameType":"normal",
     "Width":"1280",
     "Height":"720",
     //輸出vtt文件，Object后綴必須設(shè)置為.vtt。對(duì)應(yīng)的圖片路徑為example/snapshot-tile-{Count}.jpg
     "OutputFile": {
     	"Bucket":"example-bucket",
     	"Location":"oss-cn-hangzhou",
     	"Object":"example.vtt"
   	},
     "Format":"vtt",
     "SubOut":{
       "IsSptFrag":"true"
     }
   }

3. 同步單張截圖任務(wù)會(huì)通過接口直接返回任務(wù)結(jié)果，異步任務(wù)需配置MNS回調(diào)或主動(dòng)查詢。

   說明

   如果輸入文件過大可能會(huì)導(dǎo)致超時(shí)失敗，請(qǐng)酌情增加重試機(jī)制。

4. 接收回調(diào)消息（推薦）。

   異步任務(wù)完成后，如果配置了官大MNS消息通知，會(huì)向輕量消息隊(duì)列（原 MNS）指定的隊(duì)列或主題發(fā)送消息。詳細(xì)信息請(qǐng)參見接收消息通知。

5. 查詢作業(yè)結(jié)果。

   調(diào)用QuerySnapshotJobList - 查詢截圖作業(yè)結(jié)果接口，通過指定多個(gè)截圖作業(yè)ID進(jìn)行查詢。或不指定具體的截圖作業(yè)ID，通過篩選截圖狀態(tài)、創(chuàng)建時(shí)間、管道等條件，進(jìn)行分頁查詢。

SDK提交截圖任務(wù)

常見問題

截圖常見問題，請(qǐng)參見截圖常見問題。