腾讯会议
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 直播管理 > 获取直播观看人数

获取直播观看人数

最近更新时间：2024-04-24 17:50:12

我的收藏

本页目录：

接口描述

描述：当用户为企业管理员或会议创建者时，可根据会议 ID 获取直播观看人数，正在进行中的直播获取实时观看人数，已结束的直播获取会议下直播观看总人数，对于周期性会议不支持获取直播观看总人数。暂不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meeting_id}/live_play/live-view-info?userid={userid}&instanceid={instanceid}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明。
参数名称
必选
参数类型
参数描述
userid
是
String
用户 ID。
instanceid
是
integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：Linux
20：Rooms for Touch Windows
21：Rooms for Touch MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS

输出参数

成功时返回空消息体，失败时返回 错误码 和错误信息。
参数名称
参数类型
参数描述
meeting_id
String
会议号。
subject
String
会议主题。
live_viewers_num
Integer
直播观看人数。

错误码列表

状态码
错误码
错误描述
500
9003
会议信息不存在。
400
190004
参数非法，请对照接口文档检查您的参数。
500
190001
存在未注册的用户。
500
190441
没有权限查询直播观看数据。场景：非企业管理员或会议创建者。

示例

输入示例

GET
https://api.meeting.qq.com/v1/meetings/1638834881407589704/live_play/live-view-info?userid=tester&instanceid=1

输出示例

{
    "meeting_id": "1638834881407589704",
    "subject": "直播",
    "live_viewers_num": 9
}

中国站