接口規範 點播流相關接口
- 5.1.查詢點播流
用途
查詢某個應用下的點播視頻流。
如果查詢的是點播應用（如"vod"），返回的是該點播應用下的點播流列表。
如果查詢的是直播應用（如“liveshow”），則會返回的是有錄制數據的歷史直播流的列表，列表中的時長、修改時間、生成時間屬性都是針對該流最後一個錄制版本的描述。可以通過下一個接口查詢某個直播流下的詳細錄制數據。
請求
streamMgr/?request=get_streams&application=vod&pageno=1&page_size=20
application 應用名
pageno 頁碼
page_size
在視頻流較多的情況下，可以通過傳入頁碼參數請求某一範圍內的數據。返回的數據中含有詳細的分頁信息，可以通過請求第一頁獲取數據總量和分頁的詳情。
本文檔的後續章節將不再對分頁屬性做解釋。
響應
{ "code":0, "data":{ "page":1, "page_size":"20", "pages":"2", "total":"28", "modify_time":"1515731044", "count":20, "items":[ { "seq":1, "application":"vod", "stream":"fk7cpizvhwshjnyu", "type":"movie", "starttime":"1515155078", "modifytime":"1515155078", "active":"no", "duration":"10", "formats":"flv,hls,mp4" }, { "seq":2, "application":"vod", "stream":"VID20160916153947", "type":"movie", "starttime":"1515154953", "modifytime":"1515154953", "active":"no", "duration":"36", "formats":",,mp4" } ] } }
返回應用下的點播流。
data元素下包含數據量和分頁信息：
page 當前頁碼
pages 總頁數
page_size 分頁大小
total 總數據條數
count 當前分頁中的數據條數
items元素下包含0或多條點播數據流，每條記錄的屬性如下：
application 應用名
stream 流名稱
type 點播流類型,movie表示是視頻點播流，live表示是直播流（由直播流形成的歸檔數據）。
modifytime 最後修改的時間戳
"starttime 開始生成的時間戳，對於movie類型的流，表示轉碼生成的時間，對於live類型的流表示錄制的時間。
duration 視頻流的播出時長，單位 秒
- 5.2.查詢直播流錄制數據
用途
查詢某個直播流的錄制數據，錄制數據也是一種點播流，是錄制直播流形成的點播數據。
一個直播流每次啟停都會生一份錄制數據，多次啟停後會在一個直播流下生成多份錄制數據。直播流的錄制數據使用版本號區分，版本號從0開始，每生成一個新文件版本號會增1。
請求
streamMgr/?request=get_stream_files&application=liveshow&stream=jgdy&pageno=1&page_size=20
application 應用名
stream 直播流名稱
pageno 頁碼
page_size 分頁大小
響應
{
"code":0,
"data":{
"page":1,
"page_size":"20",
"pages":"1",
"total":"2",
"modify_time":"1515755949",
"count":2,
"items":[
{
"version":"1",
"size":"28759864",
"duration":"353",
"starttime":"1515655308",
"modifytime":"1515655659",
"formats":"hls"
},
{
"version":"0",
"size":"121345164",
"duration":"1209",
"starttime":"1515218380",
"modifytime":"1515219588",
"formats":"hls"
}
]
}
}返回某個直播流的錄制數據。
items元素下包含0或多條錄制數據，每條數據的屬性如下：
version 版本號
size 錄制數據大小，單位 字節
duration 視頻流的播出時長，單位 秒
modifytime 最後修改的時間戳，可以理解成錄制結束的時間戳
"starttime 開始錄制的時間戳。
formats 視頻流的格式，一個視頻流可以有多種格式，多種格式之間使用逗號分開，可以是flv、hls、mp4格式中的一種或多種。
- 5.3.刪除視頻流
用途
刪除一個視頻流。
如果請求刪除的是一個視頻點播流名稱（如"vod"應用下的某個流），會把這個點播流下的視頻數據刪除掉。
如果請求的是一個直播流名稱，則會把這個直播流下的所有版本的錄制數據刪除。要刪除直播流的某個版本的錄制數據，使用下一個接口（刪除錄制數據）。
請求
streamMgr/?request=remove_stream&application=vod&stream=fk7cpizvhwshjnyu
application 應用名
stream 流名稱
響應
{
"code":0
}- 5.2.刪除錄制數據
用途
刪除某個直播流的某個版本的錄制數據。
要刪除所有版本的錄制數據，請使用上一接口（刪除視頻流）；
請求
streamMgr/?request=remove_stream_version&application=liveshow&stream=yellow&version=31
application 應用名
stream 流名稱
version 錄制版本號
響應
{
"code":0
}接口規範 點播流相關接口