接口规范 3.应用相关接口

3.application相关接口

3.1.查询应用接口

• 用途
  查询服务器上的应用（application）。

• 请求
  appMgr/?request=get&token=abce
  token 是在登录认证接口中获得的token值。后续接口描述中将省略对token参数的描述，但是要记住token参数是必须的。

• 响应

  {
  "code":0,
  "data":{
          "count":2,
          "items":[{"app_name":"show3",
                      "allow_live":"on",
                      "allow_publish":"on",
                      "allow_play":"on"
                      },
                      {"app_name":"show4",
                      "allow_live":"on",
                      "allow_publish":"on",
                      "allow_play":"on"}
                      ]}
  }

  返回一个或多个应用的信息。
  app_name 应用名
  allow_live 是否允许直播业务，on表示允许，off或省略不允许
  allow_publish 是否允许推送直播流到该应用，on表示允许，off或省略不允许
  allow_play 是否允许播出视频，on表示允许，off或省略不允许

3.2.查询DVR配置接口

• 用途
  查询应用的DVR配置参数。
  流媒体服务器的DVR功能可以将直播流在服务器上进行录制保存，DVR配置参数定义了保存的行为。
  系统有全局DVR配置参数，默认情况下会对每个应用生效。
  如果一个应用（application）没有DVR配置参数，则会使用全局配置参数。
  如果对一个应用配置了部分DVR参数，没有配置的参数依然会使用全局配置参数。
• 请求
  appMgr/?request=get_dvr_paras&application=
  application 应用名，如果没有指定应用名，则会查询全局配置参数。
• 响应

{
    "code":0,
    "data":{
        "count":1,
        "items":[
            {
                "is_dvr":"on",
                "dvr_method":"METHOD_A",
                "version_it":"on",
                "media_root":"/var/www/media",
                "keep_time":"0",
                "analyze_duration":"15",
                "segment_duration":"10",
                "chunk_type":"h",
                "chunk_size":"1",
                "chunk_ts":"off",
                "formats":"flv;hls",
                "probe_time":"20",
                "tv_streams":"tv",
                "application":"__Default"
            }
        ]
    }
}

返回应用的配置参数，items数组包含一个元素。
配置参数：
is_dvr on 表示DVR开启，off表示关闭。
media_root 归档数据保存的根路径
formats 归档的格式，多种格式用半角分号分开。flv 保存flv格式；hls保存hls切片格式；mp4保存mp4格式。
tv_streams 按照电视流格式归档的流名称，多个名称用半角分号分开。
application 应用名，"Default" 表示使用的是全局配置。

3.3.开启DVR功能

• 用途
  开启DVR功能。
  系统暂不支持针对某个应用开启和关闭DVR功能，也不支持针对某个应用配置其他DVR参数。DVR的开启、关闭和修改配置参数会对所有应用生效。
• 请求
  appMgr/?request=open_dvr
• 响应

  {
  "code":0
  }

3.4.关闭DVR功能

• 用途
  关闭DVR功能。
• 请求
  appMgr/?request=close_dvr
• 响应

  {
  "code":0
  }

3.5.设置DVR保存格式

• 用途
  设置DVR保存格式，可以设置直播流在流媒体服务器上以一种或多种格式保存。
• 请求
  appMgr/?request=set_dvr_format&formats=flv;hls;mp4
  format 设置的归档格式，多种格式用半角分号分开。flv 保存flv格式；hls保存hls切片格式；mp4保存mp4格式。
• 响应

  {
  "code":0
  }