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

文档中心

立即注册

导航

GetStreamData - 查询视频流帧率码率

最近更新时间：2025.06.16 17:00:38首次发布时间：2022.09.14 17:00:48

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

调试

API Explorer

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

去调试

请求参数

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

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

返回参数

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

参数	类型	示例值	描述
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