查询视频流帧率码率--慢直播-火山引擎

文档中心

立即注册

导航

查询视频流帧率码率

最近更新时间：2024.08.19 16:07:23首次发布时间：2022.09.14 17:00:48

查询指定视频流推流的帧率和码率等信息。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=GetStreamData&Version=2021-01-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetStreamData`	接口名称。当前 API 的名称为 `GetStreamData`。
Version	String	是	`2021-01-01`	接口版本。当前 API 的版本为 `2021-01-01`。
StreamID	String	是	`2a772f0b-753c-4496-b535-a8df0fxxxxxx`	视频流 ID，可通过调用 ListStreams 接口获取
StartTime	String	是	`1663114220`	查询起始时间，Unix 时间戳，单位为秒。
EndTime	String	是	`1663137420`	查询结束时间，Unix 时间戳，单位为秒。

Body

参数类型是否必选示例值描述

参数	类型	是否必选	示例值	描述
StreamingIndex	Integer	否	`1`	主子码流编号，取值及含义如下所示。 0：主码流； 1~n：子码流。
Resolution	String	否	`1`	分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。

StreamingIndex

Integer

否

1

主子码流编号，取值及含义如下所示。

0：主码流；
1~n：子码流。

Resolution String 否 1 分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
BVideo	Array of BVideo	`-`	视频码率信息列表。
BAudio	Array of BAudio	`-`	音频码率信息列表。
FPS	Array of FPS	`-`	帧率信息列表。
Height	Integer	`1080`	视频高度，单位为 px。
Width	Integer	`1920`	视频宽度，单位为 px。
VCodec	String	`avc`

BVideo

参数	类型	示例值	描述
TimeStamp	String	`2022-09-14T14:12:00+0800`	时间戳，例如：2022-09-14T14:12:00+0800
Value	Float	`4040310.1860465114`	视频码率，单位为 bits。说明码率的单位为 bits，如返回值为 1000000 时表示 1000kbits 或 1Mbps。

BAudio

参数	类型	示例值	描述
TimeStamp	String	`2022-09-14T14:12:00+0800`	时间戳，例如：2022-09-14T14:12:00+0800
Value	Float	`0`	音频码率，单位为 bits。说明码率的单位为 bits，如返回值为 1000000 时表示 1000kbits 或 1Mbps。

FPS

参数	类型	示例值	描述
TimeStamp	String	`2022-09-14T14:12:00+0800`	时间戳，例如：2022-09-14T14:12:00+0800
Value	Float	`24`	帧率，单位为 fps。

请求示例

POST https://open.volcengineapi.com?Action=GetStreamData&Version=2021-01-01&StreamID=2a772f0b-753c-4496-b535-a8df0fxxxxxx&StartTime=1663114220&EndTime=1663137420

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202209141422410102040570671202A65A",
        "Action": "GetStreamData",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "BVideo": [
            {
                "TimeStamp": "2022-09-14T14:10:00+0800",
                "Value": 3899494.358974359
            },
            {
                "TimeStamp": "2022-09-14T14:11:00+0800",
                "Value": 3823790.111111111
            },
            {
                "TimeStamp": "2022-09-14T14:12:00+0800",
                "Value": 4040310.1860465114
            }
        ],
        "BAudio": [
            {
                "TimeStamp": "2022-09-14T14:10:00+0800",
                "Value": 0
            },
            {
                "TimeStamp": "2022-09-14T14:11:00+0800",
                "Value": 0
            },
            {
                "TimeStamp": "2022-09-14T14:12:00+0800",
                "Value": 0
            }
        ],
        "FPS": [
            {
                "TimeStamp": "2022-09-14T14:10:00+0800",
                "Value": 25
            },
            {
                "TimeStamp": "2022-09-14T14:11:00+0800",
                "Value": 24
            },
            {
                "TimeStamp": "2022-09-14T14:12:00+0800",
                "Value": 24
            }
        ],
        "Height": 1080,
        "Width": 1920
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。