查询主播推拉流信息

查询主播推拉流信息（ListRealtimeStreamsInfo）

接口描述

此接口汇总了主播的实时推流质量状态、主播热度和各码率观看热度

1.主播推流质量状态信息

• 推流列表：查询时间点的瞬时在推流名列表

• 质量信息：码率、帧率、丢帧率、客户端IP，CDN收流节点IP等

2.主播热度信息（注意：此接口不能用来查询推流触发转码的主播热度信息，即统计的在线人数和带宽不包括推流转码的转码流数据，如需全量查询带宽、人数请参考GetLivePlayStatData）

• 观众在线人数：即原流和各转码流观众在线人数的加和

• 观众拉流带宽：即原流和各转码流拉流带宽的加和

3.各码率观看热度（注意：此接口不能用来查询推流触发转码的转码流信息，即统计的流名列表、在线人数、拉流带宽不包括推流转码的转码流数据，如需全量查询带宽、人数请参考GetLivePlayStatData）

• 各码率拉流流名列表：包含原流名和转码后的流名

• 在线人数：返回原流/转码流的在线人数

• 拉流带宽：返回原流/转码流的带宽

注意：

• 在线人数及带宽目前支持查询的地区：中国大陆

• 推流质量信息为查询时刻的瞬时信息，因数据统计汇总，拉流数据会有5-10min的延时

• 限制访问频率：50次/分钟

• 数据粒度：1min

• 单次返回数据最多10000条，如需增加数据量请联系售后评估

• 调用方式：HTTP POST

• 签名机制：

  • Service取值：kls

• 接入地址：kls.api.ksyun.com︎

请求参数

返回参数

DataByStream

DataByPull

请求示例

POST /?Action=ListRealtimeStreamsInfo&Version=2017-01-01 HTTP/1.1 
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: AWS4-HMAC-SHA256 Credential=YOURAK/YYYYMMDD/cn-beijing-6/kls/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=SIG
Host: kls.api.ksyun.com

{ 
    "UniqueName":"xxx",
     "App":"xxx"
}

返回示例

{
    "Data":
  {
        "UniqueName":"xxx",
        "App":"live",
        "Bw":50000,
        "OnlineUser":500,
        "Count":1,
        "Streams":[
            {
                "Node":"xxxxx",
                "FLR": 52,
                "BwDiff": 555.5,
                "Vcodec": "h264",
                "Acodec": "mp3",
                "OnlineUser": 500 ,
                "Bw": 50000 ,
                "BwInAudio": 21043,
                "BwIn": 442409,
                "BwReal": 223,
                "BwDiff": 442186,
                "Width": 368,
                "Clientip":"114.255.44.132",
                "Curbitrate":52666,
                "Curfps":31,
                "FrameRate": 30 ,
                "Height": 614 ,
                "Pubtime":1491033051,
                "SampleRate": 44100 ,
                "Stream":"s222"
                "Pulls":[
                    {
                        "Stream":"s222",
                        "Bw":"20000",
                        "OnlineUser": 200 
                    },
                    {
                        "Stream":"s222_1500",
                        "Bw": 30000 ,
                        "OnlineUser": 300 
                    }
                ]
            },
            {

            }
        ],
        "RetCode":0,
        "RetMsg":"success"
  }
}

错误码

为了帮您快速定位问题，云直播将错误码集中归类，请到错误码中心查看详情。