Pili 直播 > API 文档 > 直播流管理API >批量查询在线流信息

批量查询在线流信息

最近更新时间: 2021-11-02 15:23:01

接口描述

批量查询直播的开始时间、主播IP、当前码率、当前帧率等信息

请求参数

POST /v2/hubs/<hub>/livestreams
Host: pili.qiniuapi.com 
Authorization: <QiniuToken>
Content-Type: application/json

{
    "items": ["<StreamTitle1>", "<StreamTitle2>", ...]
}

参数	类型	必填	描述
hub	string	是	直播空间名
items	string[]	是	直播流列表，查询直播流列表数量不超过100

返回数据

参数	类型	描述
items	object[]	直播流列表
├─ startAt	int64	推流开始时间，Unix 时间戳，单位：秒
├─ clientIP	string	推流端IP
├─ serverIP	string	服务端IP
├─ bps	int	推流码率
├─ fps	object	帧率
├─ audio	int	音频帧率
├─ video	int	视频帧率
├─ data	int	metadata帧率
├─ key	string	直播流名

示例

请求体:

POST /v2/hubs/test/livestreams HTTP/1.1
Host: pili.qiniuapi.com 
Authorization: <QiniuToken>
Content-Type: application/json

{
    "items": ["teststream"]
}

返回体:

200 OK

{
    "items": [
        {
           "startAt": 1635162331,
           "clientIP": "127.0.0.1:19866",
           "serverIP": "127.0.0.1:1935",
           "bps": 604168,
           "fps": {
                "audio": 43,
                "video": 60,
                "data": 0
            },
            "key": "teststream"
        }
    ]
}

SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往下载

以上内容是否对您有帮助？