调用DescribeLiveStreamCount获取直播流的实时在线原始流和转码流流数信息。
说明 调用频率限制1次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeLiveStreamCount |
系统规定参数,取值:DescribeLiveStreamCount。 |
DomainName | String | 是 | example.com |
直播播放域名或推流域名。 |
RegionId | String | 否 | cn-shanghai |
地域ID。默认值为cn-shanghai。 说明
如果传了直播域名DomainName,RegionID要和域名所在直播中心的RegionID保持一致。 不传RegionID的话,就是默认值cn-shanghai,所传直播域名参数DomainName所在直播中心的RegionID不是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>
<Count>3</Count>
<Type>raw</Type>
<StreamCountDetails>
<StreamCountDetail>
<Format>h264</Format>
<Count>2</Count>
</StreamCountDetail>
<StreamCountDetail>
<Format>h265</Format>
<Count>1</Count>
</StreamCountDetail>
</StreamCountDetails>
</StreamCountInfo>
<StreamCountInfo>
<Count>3</Count>
<Type>trans</Type>
<StreamCountDetails>
<StreamCountDetail>
<Format>h264</Format>
<Count>2</Count>
<VideoDataRate>390</VideoDataRate>
</StreamCountDetail>
<StreamCountDetail>
<Format>h265</Format>
<Count>1</Count>
<VideoDataRate>700</VideoDataRate>
</StreamCountDetail>
</StreamCountDetails>
</StreamCountInfo>
</StreamCountInfos>
</DescribeLiveStreamCountResponse>
JSON
格式
{
"RequestId": "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
"StreamCountInfos": {
"StreamCountInfo": [{
"Count": 3,
"Type": "raw",
"StreamCountDetails": {
"StreamCountDetail": [{
"Format": "h264",
"Count": 2
}, {
"Format": "h265",
"Count": 1
}]
}
}, {
"Count": 3,
"Type": "trans",
"StreamCountDetails": {
"StreamCountDetail": [{
"Format": "h264",
"Count": 2,
"VideoDataRate": 390
}, {
"Format": "h265",
"Count": 1,
"VideoDataRate": 700
}]
}
}]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交