调用DescribeLiveStreamCount获取直播流的实时在线原始流和转码流流数信息。

使用说明

先获取主播流域名,再调用本接口获取直播流的实时在线原始流和转码流流数信息。调用接口返回的视频编码格式为h264和h265。

QPS限制

本接口的单用户QPS限制为1次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLiveStreamCount

系统规定参数,取值:DescribeLiveStreamCount

DomainName String example.com

主播流域名。

RegionId String cn-shanghai

域名所属地域。

返回数据

名称 类型 示例值 描述
RequestId String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC

请求ID。

StreamCountInfos Array of StreamCountInfo

流信息统计内容。

StreamCountInfo
Count Long 3

在线流数量。

Limit Long 10

并发推流数量限制,只有白名单用户才显示。

StreamCountDetails Array of StreamCountDetail

流统计信息详情。

StreamCountDetail
Count Long 2

在线流数量。

Format String h264

视频编码格式。取值:

  • h264
  • h265
VideoDataRate Long 390

视频码率,该字段只有转码流数量统计时才有。

Type String raw

实时流类型。取值:

  • raw:原始流。
  • trans:转码流。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamCount
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveStreamCountResponse>
  <RequestId>FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
  <StreamCountInfos>
        <StreamCountInfo>
              <Type>raw</Type>
              <Limit>10</Limit>
              <Count>3</Count>
              <StreamCountDetails>
                    <StreamCountDetail>
                          <Format>h264</Format>
                          <Count>2</Count>
                          <VideoDataRate>390</VideoDataRate>
                    </StreamCountDetail>
              </StreamCountDetails>
        </StreamCountInfo>
  </StreamCountInfos>
</DescribeLiveStreamCountResponse>

JSON格式

{
    "DescribeLiveStreamCountResponse": {
        "RequestId": "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
        "StreamCountInfos": {
            "StreamCountInfo": {
                "Type": "raw",
                "Limit": 10,
                "Count": 3,
                "StreamCountDetails": {
                    "StreamCountDetail": {
                        "Format": "h264",
                        "Count": 2,
                        "VideoDataRate": 390
                    }
                }
            }
        }
    }
}

错误码

访问错误中心查看更多错误码。