接口規(guī)范 7. 按需錄制相關(guān)接口

7 按需錄制直播流

7.1.定義按需錄制的應(yīng)用

• 用途
  將某個(gè)應(yīng)用設(shè)置為按需錄制應(yīng)用。
  應(yīng)用被設(shè)置為按需錄制后，該應(yīng)用下的直播流默認(rèn)情況下不會(huì)被錄制，只有在收到開始錄制和停止錄制的指令后才會(huì)針對某個(gè)直播流開始錄制和停止錄制。
  如果系統(tǒng)的全局配置參數(shù)中設(shè)置了不錄制視頻，直播流不會(huì)被錄制。具體參見“application相關(guān)接口”章節(jié)中的DVR相關(guān)接口。
  按需錄制的接口，對于live應(yīng)用"live-"開頭的應(yīng)用無效。對于帶有NR符號(hào)的應(yīng)用和直播流也無效。

• 請求
  demandDvr/?request=add_app&application=show
  application 應(yīng)用名

• 響應(yīng)

  {
  "code":0
  }

7.2.撤銷按需錄制的應(yīng)用

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

• 請求
  demandDvr/?request=del_app&application=show
  application 應(yīng)用名

• 響應(yīng)

{
    "code":0
}

7.3.查詢按需錄制的應(yīng)用

• 用途
  查詢所有被設(shè)置為按需錄制的應(yīng)用。

• 請求
  demandDvr/?request=list_app

• 響應(yīng)

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

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

7.4.開始錄制

• 用途
  對按需錄制應(yīng)用下的直播流，發(fā)送開始錄制指令。服務(wù)器收到指令后會(huì)開始錄制該直播流。
  如果該直播流當(dāng)前時(shí)間正在直播，服務(wù)器收到指令后會(huì)立即開始錄制，直到收到停止錄制指令后才會(huì)停止錄制。
  如果該直播流當(dāng)前時(shí)間沒有正在直播，服務(wù)器收到該指令后會(huì)保持錄制狀態(tài)，一旦該直播流開始直播就會(huì)開始錄制。

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

  {
  "code":0
  }

7.5.停止錄制

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

  {
  "code":0
  }