截圖
實(shí)時(shí)媒體處理截圖服務(wù)支持對(duì)直播流進(jìn)行截圖并保存到阿里云OSS中。通過(guò)閱讀本文，您可以了解截圖功能的詳情及使用方法。
截圖功能說(shuō)明
功能說(shuō)明
實(shí)時(shí)截圖可以實(shí)時(shí)的對(duì)原始直播流按照指定頻率進(jìn)行截圖，支持存入到阿里云OSS中。實(shí)時(shí)媒體處理截圖功能根據(jù)存儲(chǔ)規(guī)則不同支持以下兩種方式：
截圖方式 | 描述 |
覆蓋截圖 | 每次新生成的截圖覆蓋之前生成的截圖文件。 |
實(shí)時(shí)截圖 | 每次新生成的截圖不覆蓋之前生成的截圖文件，以UNIX時(shí)間戳命名。 |
使用限制
單賬號(hào)并發(fā)截圖任務(wù)最多支持100路，如果您有其他需求，請(qǐng)聯(lián)系您的阿里云客戶(hù)經(jīng)理
截圖任務(wù)輸入的直播流當(dāng)前只支持RTMP協(xié)議。
截圖僅支持保存至阿里云OSS中，輸出格式僅支持JPG。
創(chuàng)建截圖模板
通過(guò)控制臺(tái)創(chuàng)建
在頂部左上角根據(jù)實(shí)際情況選擇地域。
在左側(cè)導(dǎo)航欄選擇實(shí)時(shí)媒體處理 > 模板管理。
在截圖頁(yè)簽下創(chuàng)建截圖模板。
參數(shù)
描述
模板名稱(chēng)
輸入截圖模板名稱(chēng)。
截圖頻率
輸入截圖頻率，取值范圍：[5,3600]，單位：秒。
圖片按關(guān)鍵幀獲取。
存儲(chǔ)規(guī)則
覆蓋截圖：每次新生成的截圖覆蓋之前生成的截圖文件，命名規(guī)則為
snapshot/{JobId}.jpg。實(shí)時(shí)截圖：每次新生成的截圖不覆蓋之前生成的截圖文件，命名規(guī)則為
snapshot/{JobId}/{Sequence}/{UnixTimestamp}.jpg。
說(shuō)明當(dāng)前僅支持生成JPG格式的截圖。
通過(guò)OpenAPI創(chuàng)建
調(diào)用接口CreateLiveSnapshotTemplate，創(chuàng)建用戶(hù)自定義模板。
創(chuàng)建截圖任務(wù)
通過(guò)控制臺(tái)創(chuàng)建
在頂部左上角根據(jù)實(shí)際情況選擇地域。
在左側(cè)導(dǎo)航欄選擇實(shí)時(shí)媒體處理 > 任務(wù)管理。
在截圖頁(yè)簽下創(chuàng)建實(shí)時(shí)媒體截圖任務(wù)。
參數(shù)
描述
任務(wù)名稱(chēng)
輸入截圖任務(wù)名稱(chēng)。
存儲(chǔ)地址
選擇截圖文件的存儲(chǔ)地址，支持存入到阿里云OSS。如果沒(méi)有可用的存儲(chǔ)地址，您可以自行配置，詳情請(qǐng)參見(jiàn)配置存儲(chǔ)地址。
選擇模板
選擇截圖模板。
直播流
輸入正確有效的直播流URL。當(dāng)前只支持RTMP協(xié)議。
回調(diào)地址
輸入回調(diào)URL，僅對(duì)本次任務(wù)有效。如果為空，將使用回調(diào)設(shè)置中回調(diào)URL。
通過(guò)OpenAPI創(chuàng)建
調(diào)用接口SubmitLiveSnapshotJob提交實(shí)時(shí)媒體截圖任務(wù)。
查詢(xún)截圖任務(wù)詳情
通過(guò)回調(diào)信息查詢(xún)
通過(guò)接收直播截圖回調(diào)，查詢(xún)實(shí)時(shí)媒體截圖任務(wù)詳情。更多信息，請(qǐng)參見(jiàn)回調(diào)事件概述。
通過(guò)OpenAPI查詢(xún)
調(diào)用GetLiveSnapshotJob查詢(xún)實(shí)時(shí)媒體截圖任務(wù)詳情。
獲取截圖文件
當(dāng)截圖任務(wù)開(kāi)始后，可以通過(guò)查詢(xún)截圖任務(wù)獲取截圖文件，您可以根據(jù)實(shí)際需求處理此截圖文件。
通過(guò)控制臺(tái)獲取
在頂部左上角根據(jù)實(shí)際情況選擇地域。
在左側(cè)導(dǎo)航欄選擇實(shí)時(shí)媒體處理 > 文件管理。
在截圖頁(yè)簽下獲取直播的截圖文件。
通過(guò)OpenAPI獲取
調(diào)用ListLiveSnapshotFiles獲取直播的截圖文件。
查詢(xún)截圖任務(wù)用量
在左側(cè)導(dǎo)航欄選擇數(shù)據(jù)中心 > 用量查詢(xún)。
在實(shí)時(shí)任務(wù)用量頁(yè)簽下直播截圖區(qū)域查詢(xún)或明細(xì)導(dǎo)出任務(wù)的時(shí)長(zhǎng)用量。
說(shuō)明為了保證數(shù)據(jù)安全，導(dǎo)出的下載鏈接有效期為30分鐘。如果超時(shí)，請(qǐng)重新刷新頁(yè)面。