查询RTMP协议直播流的详细音视频帧率码率_视频直播(LIVE)-阿里云帮助中心

接口说明

调用本接口查询RTMP协议的直播流在设置时间范围内的一组音视频帧率和音视频码率。
本接口为监控数据接口，数据采集处理方式不同于计费，不能用于计算用量进行对账参考。
适用于获取90天内的历史数据。
接口数据延时在3-5分钟。
单次请求的时间跨度最大为1小时。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveStreamDetailFrameRateAndBitRateData	系统规定参数。取值：DescribeLiveStreamDetailFrameRateAndBitRateData。
DomainName	String	是	example.com	您的推流域名或播流域名。
AppName	String	是	AppName	直播流所属应用名称。
StreamName	String	是	exampleStreamName	直播流名称。
StartTime	String	否	2017-12-21T08:00:00Z	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
EndTime	String	否	2017-12-22T08:00:00Z	结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

StartTime 和 EndTime 指定不合法，或者不指定 StartTime 和 EndTime 时，默认读取过去 1 小时的数据。

返回数据

名称	类型	示例值	描述
FrameRateAndBitRateInfos	Array of frabr		每个时间间隔的详细音视频帧率码率数据。
AudioBitRate	Float	200	直播流的音频码率。单位：Bps。
AudioFrameRate	Float	60	直播流的音频帧率。单位：FPS。
BitRate	Float	1420	直播流的码率。单位：Bps。
StreamUrl	String	rtmp://example.com/AppName/exampleStreamName	直播流的URL。
Time	String	2016-09-13T16:04:00Z	统计时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
VideoBitRate	Float	1200	直播流的视频码率。单位：Bps。
VideoFrameRate	Float	30	直播流的视频帧率。单位：FPS。
RequestId	String	BC858082-736F-4A25-867B-E5B67C85ACF7	请求ID。

直播流的总码率与音频码率、视频码率的计算采集方式是不同的，音频码率与视频码率的数值之和不一定与总码率相等。本接口返回数据仅用于参考和监控之用，不能用于计算用量和对账。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamDetailFrameRateAndBitRateData
&DomainName=example.com
&AppName=AppName
&StreamName=exampleStreamName
&StartTime=2017-12-21T08:00:00Z
&EndTime=2017-12-22T08:00:00Z
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveStreamDetailFrameRateAndBitRateDataResponse>
    <FrameRateAndBitRateInfos>
        <AudioBitRate>200</AudioBitRate>
        <AudioFrameRate>60</AudioFrameRate>
        <BitRate>1420</BitRate>
        <StreamUrl>rtmp://example.com/AppName/exampleStreamName</StreamUrl>
        <Time>2016-09-13T16:04:00Z</Time>
        <VideoBitRate>1200</VideoBitRate>
        <VideoFrameRate>30</VideoFrameRate>
    </FrameRateAndBitRateInfos>
    <RequestId>BC858082-736F-4A25-867B-E5B67C85ACF7</RequestId>
</DescribeLiveStreamDetailFrameRateAndBitRateDataResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "FrameRateAndBitRateInfos" : [ {
    "AudioBitRate" : 200,
    "AudioFrameRate" : 60,
    "BitRate" : 1420,
    "StreamUrl" : "rtmp://example.com/AppName/exampleStreamName",
    "Time" : "2016-09-13T16:04:00Z",
    "VideoBitRate" : 1200,
    "VideoFrameRate" : 30
  } ],
  "RequestId" : "BC858082-736F-4A25-867B-E5B67C85ACF7"
}

错误码

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