接口規范 5. 點播流相關接口

5.點播流相關接口

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 視頻流的播出時長，單位 秒
  formats 視頻流的格式，一個視頻流可以有多種格式，多種格式之間使用逗號分開，可以是flv、hls、mp4格式中的一種或多種。

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.4.刪除錄制數據

• 用途
  刪除某個直播流的某個版本的錄制數據。
  要刪除所有版本的錄制數據，請使用上一接口（刪除視頻流）；

• 請求
  streamMgr/?request=remove_stream_version&application=liveshow&stream=yellow&version=31
  application 應用名
  stream 流名稱
  version 錄制版本號

• 響應

  {
  "code":0
  }