接口規(guī)范 3.應(yīng)用相關(guān)接口

3.application相關(guān)接口

3.1.查詢應(yīng)用接口

• 用途
  查詢服務(wù)器上的應(yīng)用（application）。

• 請(qǐng)求
  appMgr/?request=get&token=abce
  token 是在登錄認(rèn)證接口中獲得的token值。后續(xù)接口描述中將省略對(duì)token參數(shù)的描述，但是要記住token參數(shù)是必須的。

• 響應(yīng)

  {
  "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"}
                      ]}
  }

  返回一個(gè)或多個(gè)應(yīng)用的信息。
  app_name 應(yīng)用名
  allow_live 是否允許直播業(yè)務(wù)，on表示允許，off或省略不允許
  allow_publish 是否允許推送直播流到該應(yīng)用，on表示允許，off或省略不允許
  allow_play 是否允許播出視頻，on表示允許，off或省略不允許

3.2.查詢DVR配置接口

• 用途
  查詢應(yīng)用的DVR配置參數(shù)。
  流媒體服務(wù)器的DVR功能可以將直播流在服務(wù)器上進(jìn)行錄制保存，DVR配置參數(shù)定義了保存的行為。
  系統(tǒng)有全局DVR配置參數(shù)，默認(rèn)情況下會(huì)對(duì)每個(gè)應(yīng)用生效。
  如果一個(gè)應(yīng)用（application）沒(méi)有DVR配置參數(shù)，則會(huì)使用全局配置參數(shù)。
  如果對(duì)一個(gè)應(yīng)用配置了部分DVR參數(shù)，沒(méi)有配置的參數(shù)依然會(huì)使用全局配置參數(shù)。
• 請(qǐng)求
  appMgr/?request=get_dvr_paras&application=
  application 應(yīng)用名，如果沒(méi)有指定應(yīng)用名，則會(huì)查詢?nèi)峙渲脜?shù)。
• 響應(yīng)

{
    "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"
            }
        ]
    }
}

返回應(yīng)用的配置參數(shù)，items數(shù)組包含一個(gè)元素。
配置參數(shù)：
is_dvr on 表示DVR開(kāi)啟，off表示關(guān)閉。
media_root 歸檔數(shù)據(jù)保存的根路徑
formats 歸檔的格式，多種格式用半角分號(hào)分開(kāi)。flv 保存flv格式；hls保存hls切片格式；mp4保存mp4格式。
tv_streams 按照電視流格式歸檔的流名稱，多個(gè)名稱用半角分號(hào)分開(kāi)。
application 應(yīng)用名，"Default" 表示使用的是全局配置。

3.3.開(kāi)啟DVR功能

• 用途
  開(kāi)啟DVR功能。
  系統(tǒng)暫不支持針對(duì)某個(gè)應(yīng)用開(kāi)啟和關(guān)閉DVR功能，也不支持針對(duì)某個(gè)應(yīng)用配置其他DVR參數(shù)。DVR的開(kāi)啟、關(guān)閉和修改配置參數(shù)會(huì)對(duì)所有應(yīng)用生效。
• 請(qǐng)求
  appMgr/?request=open_dvr
• 響應(yīng)

  {
  "code":0
  }

3.4.關(guān)閉DVR功能

• 用途
  關(guān)閉DVR功能。
• 請(qǐng)求
  appMgr/?request=close_dvr
• 響應(yīng)

  {
  "code":0
  }

3.5.設(shè)置DVR保存格式

• 用途
  設(shè)置DVR保存格式，可以設(shè)置直播流在流媒體服務(wù)器上以一種或多種格式保存。
• 請(qǐng)求
  appMgr/?request=set_dvr_format&formats=flv;hls;mp4
  format 設(shè)置的歸檔格式，多種格式用半角分號(hào)分開(kāi)。flv 保存flv格式；hls保存hls切片格式；mp4保存mp4格式。
• 響應(yīng)

  {
  "code":0
  }