接口规范 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
  }