You need to enable JavaScript to run this app.
导航
慢直播
  • 文档首页
    • /
  • 慢直播

查询帧率和码率

最近更新时间：2024.02.29 14:55:33

首次发布时间：2022.09.14 17:00:48

我的收藏

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

请求说明

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

请求参数

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

Query

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

Body

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

StreamingIndex

Integer

否

1

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

  • 0：主码流；
  • 1~n：子码流。
ResolutionString否1分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。

返回参数

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

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

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
    }
}

错误码

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