GetAccountRealTimeOnlineNumber - 获取账号维度实时在线人数--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

GetAccountRealTimeOnlineNumber - 获取账号维度实时在线人数

最近更新时间：2025.08.27 14:27:08首次发布时间：2025.08.27 14:27:08

您可通过此接口获取当前账号下实时在线的所有观看人数。数据每分钟更新一次。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。
前提条件：确保您拥有火山引擎主账号。

请求说明

请求方式：GET
请求地址：https://livesaas.volcengineapi.com/?Action=GetAccountRealTimeOnlineNumber&Version=2023-08-01

调试

API Explorer

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

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetAccountRealTimeOnlineNumber`	接口名称。当前 API 的名称为 `GetAccountRealTimeOnlineNumber`。
Version	String	是	`2023-08-01`	接口版本。当前 API 的版本为 `2023-08-01`。

返回参数

参数类型示例值描述

参数	类型	示例值	描述
UV	Long	`10`	当前账号下，实时页面访问的总人数。计算逻辑如下： 1.先按直播间维度，计算每个直播间内的实时在线人数。同一直播间内，使用相同设备（即设备 ID 相同）观看或访问观看页的观众被判定为同一人，人数算作 1。 2.再按账号维度，将该账号下所有直播间的实时在线人数相加，即为在线总人数。若同一设备同时观看多个直播间，则在每个直播间分别计数，算作多人。示例：某一时刻，当前账号下有 2 个直播间正在直播：观众 1 使用设备 A 在一分钟内访问直播间 A 多次；观众 2 使用设备 B 观看直播间 A，同时进入直播间 B。则直播间 A 的实时在线人数为 2 人，直播间 B 的实时在线人数为 1 人，总在线人数为 3 人。

Long

10

当前账号下，实时页面访问的总人数。
计算逻辑如下：
1.先按直播间维度，计算每个直播间内的实时在线人数。同一直播间内，使用相同设备（即设备 ID 相同）观看或访问观看页的观众被判定为同一人，人数算作 1。
2.再按账号维度，将该账号下所有直播间的实时在线人数相加，即为在线总人数。若同一设备同时观看多个直播间，则在每个直播间分别计数，算作多人。
示例：
某一时刻，当前账号下有 2 个直播间正在直播：

观众 1 使用设备 A 在一分钟内访问直播间 A 多次；
观众 2 使用设备 B 观看直播间 A，同时进入直播间 B。
则直播间 A 的实时在线人数为 2 人，直播间 B 的实时在线人数为 1 人，总在线人数为 3 人。

请求示例

GET https://livesaas.volcengineapi.com/?Action=GetAccountRealTimeOnlineNumber&Version=2023-08-01

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetAccountRealTimeOnlineNumber",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "UV": 10
    }
}

错误码

访问公共错误码和错误码获取详细信息。