调用DescribeLiveStreamCount获取直播流的实时在线原始流和转码流流数信息。
使用说明
先获取主播流域名,再调用本接口获取直播流的实时在线原始流和转码流流数信息。调用接口返回的视频编码格式为h264和h265。
QPS限制
本接口的单用户QPS限制为1次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveStreamCount | 系统规定参数。取值:DescribeLiveStreamCount。 |
DomainName | String | 是 | example.com | 主播流域名。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | FCFFE4A4-F34F-4EEF-B401-36A01689AFBC | 请求ID。 |
StreamCountInfos | Array of StreamCountInfo | 流信息统计内容。 |
|
StreamCountInfo | |||
Type | String | raw | 实时流类型。取值:
|
Count | Long | 3 | 在线流数量。 |
Limit | Long | 10 | 并发推流数量限制,只有白名单用户才显示。 |
StreamCountDetails | Array of StreamCountDetail | 流统计信息详情。 |
|
StreamCountDetail | |||
VideoDataRate | Long | 390 | 视频码率,该字段只有转码流数量统计时才有。 |
Format | String | h264 | 视频编码格式。取值:
|
Count | Long | 2 | 在线流数量。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamCount
&DomainName=example.com
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveStreamCountResponse>
<RequestId>FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
<StreamCountInfos>
<Type>raw</Type>
<Count>3</Count>
<Limit>10</Limit>
<StreamCountDetails>
<VideoDataRate>390</VideoDataRate>
<Format>h264</Format>
<Count>2</Count>
</StreamCountDetails>
</StreamCountInfos>
</DescribeLiveStreamCountResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
"StreamCountInfos" : [ {
"Type" : "raw",
"Count" : 3,
"Limit" : 10,
"StreamCountDetails" : [ {
"VideoDataRate" : 390,
"Format" : "h264",
"Count" : 2
} ]
} ]
}
错误码
访问错误中心查看更多错误码。
文档内容是否对您有帮助?