接口規範 應用相關接口
阿新 • • 發佈:2018-01-17
全局 open 修改配置 def 3.2 開啟 set default 請求 3.application相關接口
- 3.1.查詢application
用途
查詢服務器上的應用(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 }
接口規範 應用相關接口