接口规范7.按需录制相关接口-创新互联

7 按需录制直播流

7.1.定义按需录制的应用

• 用途
  将某个应用设置为按需录制应用。
  应用被设置为按需录制后，该应用下的直播流默认情况下不会被录制，只有在收到开始录制和停止录制的指令后才会针对某个直播流开始录制和停止录制。
  如果系统的全局配置参数中设置了不录制视频，直播流不会被录制。具体参见“application相关接口”章节中的DVR相关接口。
  按需录制的接口，对于live应用"live-"开头的应用无效。对于带有NR符号的应用和直播流也无效。

  

  创新互联长期为近1000家客户提供的网站建设服务，团队从业经验10年，关注不同地域、不同群体，并针对不同对象提供差异化的产品和服务；打造开放共赢平台，与合作伙伴共同营造健康的互联网生态环境。为册亨企业提供专业的成都网站制作、成都做网站，册亨网站改版等技术服务。拥有十余年丰富建站经验和众多成功案例,为您定制开发。

• 请求
  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
  }

另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。