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