备案控制台
文档
产品文档
输入文档关键字查找
首页 视频直播 开发参考 API参考 监控统计 获取推流过程质量数据

获取推流过程质量数据

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

调用DescribeLiveUpVideoAudioInfo获取推流过程质量数据。

使用说明

  • 数据最大查询跨度为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. 结束时间错误，请您确认结束时间是否正确。

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

文档推荐
  • 本页导读 （1）
文档反馈