全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询实时推流信息

最近更新时间:2024-03-27 15:34:26

查询实时推流信息(ListRealtimePubStreamsInfo)

接口描述

  • 用来查询域名下某应用或某条流的推流信息

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

  • 调用方式:HTTP GET

  • 数据粒度:100s

  • 签名机制

    • Service取值:kls

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

请求参数

参数名

类型

是否必须

描述

Action

String

Y

操作接口名,取值:RealtimePubStreamsInfo

Version

String

Y

版本号,取值:2017-01-01

UniqueName

String

Y

域名空间

App

String

Y

应用名

Pubdomain

String

Y

推流域名

Stream

String

N

流名

OrderTime

Int

N

排序类型,0:按推流开始时间降序排列,1:按推流开始时间升序排列

Marker

Int

N

起始游标,默认为0。 0代表第1页的数据,以此类推

Limit

Int

N

每页返回的记录数,默认1000。单页最多返回5000条数据

返回参数

参数名

类型

描述

UniqueName

String

域名空间

App

String

应用名

Pubdomain

String

推流域名

Stream

String

流名

Count

Int

本页返回的记录数

Marker

Int

起始游标,默认为0。 0代表第1页的数据,以此类推

OrderTime

Int

排序类型,0:按推流开始时间降序排列,1:按推流开始时间升序排列

Total

Int

符合查询条件的总记录数

ClientIP

String

推流客户端IP

Width

String

视频宽度

Height

String

视频高度

FrameRate

String

视频理论帧率

Curfps

Int

视频实时帧率

Curbitrate

Int

视频码率/B

BwInAudio

String

音频码率/B

SampleRate

String

音频采样率/Hz

BwReal

String

总真实码率/B

BwIn

String

总理论码率/B

UpdateTime

Int

流信息采集UTC时间

PubTime

Int

开始推流的UTC时间

RetCode

Int

响应码 0成功 其他失败

RetMsg

String

响应信息描述

请求示例

GET /?Action=RealtimePubStreamsInfo&Version=2017-01-01&UniqueName=xxx&App=live&Pubdomain=xxx.xxx.com&Marker=0&Limit=2&OrderTime=0 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

返回示例

{
  "Data": {
    "App": "live",
    "Count": 1,
    "Marker": 0,
    "OrderTime": 0,
    "Pubdomain": "xxx.xxx.com",
    "Result": [
      {
        "BwIn": "52666",
        "BwInAudio": "20814",
        "BwReal": "52227",
        "Clientip": "114.255.44.132",
        "Curbitrate": 52666,
        "Curfps": 31,
        "FrameRate": "30",
        "Height": "614",
        "Pubtime": 1491033051,
        "SampleRate": "44100",
        "Stream": "yh668",
        "UpdateTime": 1491036296,
        "Width": "1092"
      }
    ],
    "RetCode": 0,
    "RetMsg": "success",
    "Total": 1,
    "UniqueName": "xxx"
  }
}

错误码

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

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈