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

查询直播流数据

最近更新时间：2023.10.13 15:11:29

首次发布时间：2023.10.13 14:59:21

我的收藏

查询来自直播的视频流信息。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。

字段
位置
类型
必填
说明
值
ActionQueryString是公共参数，OpenAPI 接口名称StatStream
VersionQueryString是公共参数，OpenAPI 接口版本2021-01-01

Body 参数

字段
类型
必填
说明
StreamIDString是视频流 ID；可通过调用 ListStreams 接口获取
StartTimeInteger是查询起始时间；Unix 时间戳，精确到秒，例如：1697166403
EndTimeInteger是查询结束时间；Unix 时间戳，精确到秒，例如：1697169407
AggregationInteger是数据聚合周期；支持60和300，单位：秒

返回结果

返回参数说明

通用返回参数，请参考 ResponseMetadata 结构体说明。

Result 字段包含以下参数：

字段
类型
说明
SessionDataArray of objects查询到的直播视频流信息列表，参考以下 直播视频流数据结构说明

直播视频流数据结构说明

字段
类型
说明
TimestampInteger视频流时间片开始时刻，Unix 时间戳，单位：秒
OnlineUserInteger直播在线人数
RequestInteger请求数

示例

请求示例

POST https://open.volcengineapi.com?Action=StatStream
&Version=2021-01-01
&<公共请求参数>

{
    "StreamID": "2a772f0b-753c-4496-b535-a8df0fxxxxxx",
    "StartTime": 1697166403,
    "EndTime": 1697169407,
    "Aggregation": 60
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202209141422410102040570671202A65A",
        "Action": "StatStream",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "SessionData": [
            {
                "Timestamp": 1697167403,
                "OnlineUser": 10,
                "Request": 20
            },
            {
                "Timestamp": 1697168407,
                "OnlineUser": 15,
                "Request": 30
            }
        ]
    }
}