接口規(guī)范 4.直播流相關(guān)接口

4.直播流相關(guān)接口

4.1.查詢活動的視頻流

• 用途
  查詢活動的視頻流，即正在直播中的視頻流。

• 請求
  streamMgr/?request=get_active_streams

• 響應(yīng)

  {
  "code":0,
  "data":{
      "count":1,
      "items":[
          {
              "server":"g3",
              "host":"192.168.1.230",
              "protocol":"rtmp",
              "app":"live",
              "stream":"live2",
              "uid":"23000043",
              "end":"end",
              "starttime":1516242339
          }
      ]
  }
  }

  items數(shù)組可能包含0或多個元素。
  server 服務(wù)器類型，默認(rèn)是g3
  host 服務(wù)器IP地址或域名
  protocol 直播協(xié)議，rtmp或rtsp
  app 應(yīng)用名
  stream 流名稱
  starttime 開始直播的時間，是一個unix時間戳

4.2.關(guān)閉并禁用直播流

• 用途
  關(guān)閉一個直播流，并將該直播流設(shè)為禁用狀態(tài)。
  調(diào)用該接口后，直播流會被立即關(guān)閉，直播客戶端和播放客戶端的連接都會中斷。關(guān)閉后的直播流會被禁止再次推流，除非調(diào)用后續(xù)接口解除禁用。

• 請求
  closedStream/?request=close&application=live&stream=live2
  application 應(yīng)用名
  stream 直播流名稱

• 響應(yīng)

  {
  "code":0
  }

4.3.解除禁用的直播流

• 用途
  解除在上一接口中被關(guān)閉和禁用的直播流，解除后直播流可以允許推流直播。

• 請求
  closedStream/?request=open&application=live&stream=live2
  application 應(yīng)用名
  stream 直播流名稱

• 響應(yīng)

  {
  "code":0
  }

4.4.查詢被禁用的直播流

• 用途
  查詢被關(guān)閉并被禁用的直播流。

• 請求
  closedStream/?request=list

• 響應(yīng)

{
    "code":0,
    "data":{
        "count":1,
        "items":[
            {
                "application":"liveshow",
                "stream":"live1",
                "time":1516274119
            }
        ]
    }
}

items元素下包含被禁用的直播流列表。
application 應(yīng)用名
stream 直播流名稱
time 禁用時間，unix時間戳

4.5.關(guān)閉直播流（不禁用）

• 用途
  關(guān)閉一個直播流，但是不禁用，推流客戶端可以再次推流進來。
  調(diào)用該接口后，直播流會被立即關(guān)閉，直播客戶端和播放客戶端的連接都會中斷。
• 請求
  streamMgr/?request=close_active_stream&application=live&stream=live2
  application 應(yīng)用名
  stream 直播流名稱

響應(yīng)

{
    "code":0
}