You need to enable JavaScript to run this app.
导航
查询视频流帧率码率
最近更新时间:2024.08.19 16:07:23首次发布时间:2022.09.14 17:00:48

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

请求说明

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

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringGetStreamData接口名称。当前 API 的名称为 GetStreamData
VersionString2021-01-01接口版本。当前 API 的版本为 2021-01-01
StreamIDString2a772f0b-753c-4496-b535-a8df0fxxxxxx视频流 ID,可通过调用 ListStreams 接口获取
StartTimeString1663114220查询起始时间,Unix 时间戳,单位为秒。
EndTimeString1663137420查询结束时间,Unix 时间戳,单位为秒。

Body

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

StreamingIndex

Integer

1

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

  • 0:主码流;
  • 1~n:子码流。
ResolutionString1分辨率编码(可参考 GB28181-2022 协议附录G中的定义)。

返回参数

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

参数类型示例值描述
BVideoArray of BVideo-视频码率信息列表。
BAudioArray of BAudio-音频码率信息列表。
FPSArray of FPS-帧率信息列表。
HeightInteger1080视频高度,单位为 px。
WidthInteger1920视频宽度,单位为 px。
VCodecStringavc

BVideo

参数类型示例值描述
TimeStampString2022-09-14T14:12:00+0800时间戳,例如:2022-09-14T14:12:00+0800

Value

Float

4040310.1860465114

视频码率,单位为 bits。

说明

码率的单位为 bits,如返回值为 1000000 时表示 1000kbits 或 1Mbps。

BAudio

参数类型示例值描述
TimeStampString2022-09-14T14:12:00+0800时间戳,例如:2022-09-14T14:12:00+0800

Value

Float

0

音频码率,单位为 bits。

说明

码率的单位为 bits,如返回值为 1000000 时表示 1000kbits 或 1Mbps。

FPS

参数类型示例值描述
TimeStampString2022-09-14T14:12:00+0800时间戳,例如:2022-09-14T14:12:00+0800
ValueFloat24帧率,单位为 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
    }
}

错误码

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