获取推流过程质量数据-阿里云帮助中心

使用说明

数据最大查询跨度为24小时。
数据最小查询跨度为1分钟。
数据最大查询范围为31天。

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveUpVideoAudioInfo	系统规定参数。取值：DescribeLiveUpVideoAudioInfo。
Stream	String	是	rtmp://example.com/AppName/StreamName	查询的流名，需要完整填写，格式为：`rtmp://推流域名/app名/流名`
StartTime	String	否	2015-12-10T15:00:00Z	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
EndTime	String	否	2015-12-10T15:10:00Z	结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

返回数据

名称	类型	示例值	描述
RequestId	String	BC858082-736F-4A25-867B-E5B67C85ACF7	请求ID。
UpItems	Array of PublishItem		返回信息中聚合推流数总计。
PublishItem
PublishTime	String	2015-12-10T15:00:00Z	推流开始时间，UTC格式。
AppName	String	AppName	推流App名称。
CodecInfo	String	H264/AAC	音视频编码信息。
PublishIp	String	cn397	推流端IP。
StreamName	String	StreamName	流的名称。
PublishStatus	String	1	推流状态，分为 “1”: “正在推流” 或 “0”: “过去推流” 两种
UniqueId	String	2.-395_37261_9848098_1538080899396	每次推流的唯一ID。
PublishInterval	String	-	推流时长，单位为秒；"-"表示正在推流，暂无推流时长。
StopTime	String	2015-12-10T15:10:00Z	推流结束时间，UTC格式。
DomainName	String	example.com	推流域名。
VideoFrames	Array of VideoFrames		秒级视频帧率，单位：帧。
VideoFrames
Value	Integer	29	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AudioFrames	Array of AudioFrames		秒级音频帧率，单位：帧。
AudioFrames
Value	Integer	23	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
VideoStamps	Array of VideoStamps		秒级视频时间戳，单位：毫秒。
VideoStamps
Value	Integer	725053781	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AudioStamps	Array of AudioStamps		秒级音频时间戳，单位：毫秒。
AudioStamps
Value	Integer	725053422	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
VideoAndAudioStamp	Array of V_AStamp		秒级音视频时间戳差值，单位：毫秒。
V_AStamp
Value	Integer	359	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AvcHeaders	Array of AvcHeaders		秒级音频AVC头，单位：次数。
AvcHeaders
Value	Integer	11	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AacHeaders	Array of AacHeaders		秒级音频AAC头，单位：次数。
AacHeaders
Value	Integer	20	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
VideoBitRate	Array of VideoBitRate		秒级视频码率，单位：bit/s。
VideoBitRate
Value	Integer	3970160	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AudioBitRate	Array of AudioBitRate		秒级音频码率，单位：bit/s。
AudioBitRate
Value	Integer	24552	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
VideoInterval	Array of VideoInterval		秒级最大视频帧间隔，单位：毫秒。
VideoInterval
Value	Integer	278	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
AudioInterval	Array of AudioInterval		秒级最大音频帧间隔，单位：毫秒。
AudioInterval
Value	Integer	254	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。
ErrorFlags	Array of ErrorFlags		推流断开错误码。
ErrorFlags
Value	Integer	0	对应质量数据在查询时间的秒级指标值。
Time	Long	1538134750408	查询时间，用UNIX毫秒时间戳表示。

部分参数不存在时，返回空字符串。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveUpVideoAudioInfo
&Stream=rtmp://example.com/AppName/StreamName
&StartTime=2015-12-10T15:00:00Z
&EndTime=2015-12-10T15:10:00Z 
&公共请求参数

正常返回示例

XML格式

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

<DescribeLiveUpVideoAudioInfoResponse>
    <RequestId>BC858082-736F-4A25-867B-E5B67C85ACF7</RequestId>
    <UpItems>
        <PublishTime>2015-12-10T15:00:00Z</PublishTime>
        <AppName>AppName</AppName>
        <CodecInfo>H264/AAC</CodecInfo>
        <PublishIp>cn397</PublishIp>
        <StreamName>StreamName</StreamName>
        <PublishStatus>1</PublishStatus>
        <UniqueId>2.-395_37261_9848098_1538080899396</UniqueId>
        <PublishInterval>-</PublishInterval>
        <StopTime>2015-12-10T15:10:00Z</StopTime>
        <DomainName>example.com</DomainName>
        <VideoFrames>
            <Value>29</Value>
            <Time>1538134750408</Time>
        </VideoFrames>
        <AudioFrames>
            <Value>23</Value>
            <Time>1538134750408</Time>
        </AudioFrames>
        <VideoStamps>
            <Value>725053781</Value>
            <Time>1538134750408</Time>
        </VideoStamps>
        <AudioStamps>
            <Value>725053422</Value>
            <Time>1538134750408</Time>
        </AudioStamps>
        <VideoAndAudioStamp>
            <Value>359</Value>
            <Time>1538134750408</Time>
        </VideoAndAudioStamp>
        <AvcHeaders>
            <Value>11</Value>
            <Time>1538134750408</Time>
        </AvcHeaders>
        <AacHeaders>
            <Value>20</Value>
            <Time>1538134750408</Time>
        </AacHeaders>
        <VideoBitRate>
            <Value>3970160</Value>
            <Time>1538134750408</Time>
        </VideoBitRate>
        <AudioBitRate>
            <Value>24552</Value>
            <Time>1538134750408</Time>
        </AudioBitRate>
        <VideoInterval>
            <Value>278</Value>
            <Time>1538134750408</Time>
        </VideoInterval>
        <AudioInterval>
            <Value>254</Value>
            <Time>1538134750408</Time>
        </AudioInterval>
        <ErrorFlags>
            <Value>0</Value>
            <Time>1538134750408</Time>
        </ErrorFlags>
    </UpItems>
</DescribeLiveUpVideoAudioInfoResponse>

JSON格式

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

{
  "RequestId" : "BC858082-736F-4A25-867B-E5B67C85ACF7",
  "UpItems" : {
    "PublishTime" : "2015-12-10T15:00:00Z",
    "AppName" : "AppName",
    "CodecInfo" : "H264/AAC",
    "PublishIp" : "cn397",
    "StreamName" : "StreamName",
    "PublishStatus" : 1,
    "UniqueId" : "2.-395_37261_9848098_1538080899396",
    "PublishInterval" : "-",
    "StopTime" : "2015-12-10T15:10:00Z",
    "DomainName" : "example.com",
    "VideoFrames" : {
      "Value" : 29,
      "Time" : 1538134750408
    },
    "AudioFrames" : {
      "Value" : 23,
      "Time" : 1538134750408
    },
    "VideoStamps" : {
      "Value" : 725053781,
      "Time" : 1538134750408
    },
    "AudioStamps" : {
      "Value" : 725053422,
      "Time" : 1538134750408
    },
    "VideoAndAudioStamp" : {
      "Value" : 359,
      "Time" : 1538134750408
    },
    "AvcHeaders" : {
      "Value" : 11,
      "Time" : 1538134750408
    },
    "AacHeaders" : {
      "Value" : 20,
      "Time" : 1538134750408
    },
    "VideoBitRate" : {
      "Value" : 3970160,
      "Time" : 1538134750408
    },
    "AudioBitRate" : {
      "Value" : 24552,
      "Time" : 1538134750408
    },
    "VideoInterval" : {
      "Value" : 278,
      "Time" : 1538134750408
    },
    "AudioInterval" : {
      "Value" : 254,
      "Time" : 1538134750408
    },
    "ErrorFlags" : {
      "Value" : 0,
      "Time" : 1538134750408
    }
  }
}

错误码

HttpCode	错误码	错误信息	描述
400	InvalidStartTime.Malformed	Specified StartTime is malformed.	StartTime参数错误，请您确认该StartTime参数是否正确。
400	InvalidEndTime.Malformed	Specified EndTime is malformed.	结束时间错误，请您确认结束时间是否正确。

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