查询推流实时信息接口

最近更新时间:2020-05-27 20:54:28

查询推流实时信息接口(ListRealtimePubStreamsInfo)

接口描述

此接口用于查询Pubdomain或者单路流stream下的实时流信息

备注:

此接口不适合高频度调用,每个UID限制访问频率300次/分钟

请求参数

参数名 类型 是否必须 描述
Action String Y 操作接口名,取值:ListRealtimePubStreamsInfo
Version String Y 版本号,取值:2017-01-01
UniqueName string Y 域名标识
App string Y 应用名
Pubdomain string Y 推流域名
Stream string N 流名
OrderTime int N 排序类型(0:从最新的开始,1:从后向前),默认为0
Marker int N 起始游标,默认为0
Limit int N 单次请求返回配置数量限制,默认1000;注:最多返回50000条配置信息

返回参数

参数名 类型 描述
UniqueName string 域名标识
App string 应用名
Pubdomain string 推流域名
Stream string 流名
Count int 返回记录数
Marker int 起始游标,默认为0
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 总真实码率/kb
BwIn string 总理论码率/kb
UpdateTime int 流信息采集UTC时间
PubTime int 开始推流的UTC时间
RetCode int 响应码 0成功 其他失败
RetMsg string 错误信息

请求示例

GET /?Action=ListRealtimePubStreamsInfo&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"
  }
}

金山云,开启您的云计算之旅

免费注册