直播云

  • 直播云 > API 文档 > 直播流管理API >查询在线流信息

    查询在线流信息

    最近更新时间: 2022-09-08 19:22:10

    接口描述

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

    请求参数

    GET /v2/hubs/<hub>/streams/<encodedStreamTitle>/live
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    
    参数 类型 必填 描述
    hub string 直播空间名
    encodedStreamTitle string 经过base64编码的直播流名

    返回数据

    参数 类型 描述
    startAt int64 推流开始时间,Unix 时间戳
    clientIP string 推流端IP
    serverIP string 服务端IP
    bps int 推流码率
    fps object 帧率
    ├─ audio int 音频帧率
    ├─ video int 视频帧率
    ├─ data int metadata帧率
    maxGop int 最近30秒内GOP最大值,单位:毫秒
    avgGop int 最近30秒内GOP平均值,单位:毫秒
    videoBitRate int 视频码率,单位:bps
    audioBitRate int 音频码率,单位:bps
    location string 推流端所在地区
    isp string 推流端所在运营商
    playCount int64 播放人数
    bandwidth int64 播放带宽,单位:bps

    示例

    请求体:

    GET /v2/hubs/test/streams/dGltZXN0YW1w/live HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

    返回体:

    200 OK
    
    {
        "startAt": 1635162331,
        "clientIP": "127.0.0.1:19866",
        "serverIP": "127.0.0.1:1935",
        "bps": 601344,
        "videoBitRate": 601251,
        "audioBitRate": 14148,
        "maxGop": 1000,
        "avgGop": 1000,
        "location": "上海",
        "isp": "电信",
        "playCount": 10,
        "bandwidth": 6012510,
        "fps": {
            "audio": 43,
            "video": 60,
            "data": 0
        }
    } // 流不在线时返回也为200,各值为零值
    
    404 {
        "error": "not found" // 未找到流
    }
    
    
    

    SDK

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

    以上内容是否对您有帮助?
  • Qvm free helper
    Close