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

文档中心

立即注册

导航

GetStreamData - 查询视频流帧率码率

最近更新时间：2025.06.06 14:20:33首次发布时间：2022.09.14 17:00:48

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

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	GetStreamData	要执行的操作，取值：GetStreamData。
Version	String	是	2021-01-01	API的版本，取值：2021-01-01。
StreamingIndex	Integer	否	1	主子码流编号，取值及含义如下所示。 0：主码流； 1~n：子码流。
StreamID	String	是	2a772f0b-753c-4496-b535-a8df0fxxxxxx	视频流 ID，可通过调用 ListStreams 接口获取
Resolution	String	否	1	分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。
StartTime	String	是	1663114220	查询起始时间，Unix 时间戳，单位为秒。
EndTime	String	是	1663137420	查询结束时间，Unix 时间戳，单位为秒。

返回参数

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

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

请求示例

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

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	ErrorStreamDBNotFound	NotFound.Stream