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

本文讲解"接口规范 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 }

本文讲解"接口规范 4.直播流相关接口"，用于解决相关问题。 4.直播流相关接口4.1.查询活动的视频流用途查询活动的视频流，即正在直播中的视频流。请求streamMgr/?request=g ...