调用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 |
视频编码格式。取值:
|
VideoDataRate | Long | 390 |
视频码率,该字段只有转码流数量统计时才有。 |
Type | String | raw |
实时流类型。取值:
|
示例
请求示例
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
}
}
}
}
}
}
错误码
访问错误中心查看更多错误码。