接口規范 7. 按需錄制相關接口

7 按需錄制直播流

7.1.定義按需錄制的應用

• 用途
  將某個應用設置為按需錄制應用。
  應用被設置為按需錄制后，該應用下的直播流默認情況下不會被錄制，只有在收到開始錄制和停止錄制的指令后才會針對某個直播流開始錄制和停止錄制。
  如果系統的全局配置參數中設置了不錄制視頻，直播流不會被錄制。具體參見“application相關接口”章節中的DVR相關接口。
  按需錄制的接口，對于live應用"live-"開頭的應用無效。對于帶有NR符號的應用和直播流也無效。

• 請求
  demandDvr/?request=add_app&application=show
  application 應用名

• 響應

  {
  "code":0
  }

7.2.撤銷按需錄制的應用

• 用途
  撤銷某個應用的按需錄制配置。即如果通過上一接口將某個應用設置為按需錄制應用，可以通過本接口撤銷這種設置。

• 請求
  demandDvr/?request=del_app&application=show
  application 應用名

• 響應

{
    "code":0
}

7.3.查詢按需錄制的應用

• 用途
  查詢所有被設置為按需錄制的應用。

• 請求
  demandDvr/?request=list_app

• 響應

  {
  "code":0,
  "data":{
      "count":2,
      "items":[
          {
              "application":"show1",
              "time":1516264587
          },
          {
              "application":"liveshow",
              "time":1515742304
          }
      ]
  }
  }

  返回消息的items元素包含0或多條記錄。
  application 應用名
  time 添加時間，unix時間戳

7.4.開始錄制

• 用途
  對按需錄制應用下的直播流，發送開始錄制指令。服務器收到指令后會開始錄制該直播流。
  如果該直播流當前時間正在直播，服務器收到指令后會立即開始錄制，直到收到停止錄制指令后才會停止錄制。
  如果該直播流當前時間沒有正在直播，服務器收到該指令后會保持錄制狀態，一旦該直播流開始直播就會開始錄制。

• 請求
  demandDvr/?request=start&application=liveshow&stream=live1
  application 應用名
  stream 直播流名稱
• 響應

  {
  "code":0
  }

7.5.停止錄制

• 用途
  對按需錄制應用下的直播流，發送停止錄制指令。服務器收到指令后會停止錄制該直播流。
• 請求
  demandDvr/?request=stop&application=liveshow&stream=live1
  application 應用名
  stream 直播流名稱
• 響應

  {
  "code":0
  }