提交工单
咨询集成、功能及报价等问题
拉取教室内在线的教师和学生信息,包括用户角色、用户 uid、用户昵称、用户摄像头和麦克风状态、用户权限等。
调用频率限制:10 次/秒
POST
/edu_room/get_attendee_list
application/json
参数 | 类型 | 是否必选 | 示例 | 描述 |
---|---|---|---|---|
room_id | String | 是 | "123456" | 教室房间 ID,只能包含数字,最长 9 个字符。 |
uid | Int64 | 是 | 171171717 | 用户 ID。 |
{
"uid":171171717,
"room_id":"123456"
}
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
room_id | String | "123456" | 教室房间 ID。 |
seq | Int64 | 1 | 在线成员列表序列号,客户端需要缓存在本地,用来检测是否有数据同步丢失。 |
attendee_list | Object | - | 在线成员列表。 |
attendee_list 数据结构如下:
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
uid | Int64 | 171171717 | 用户 ID。 |
nick_name | String | "Shawn" | 用户昵称。 |
role | Int32 | 1 | 用户角色,取值如下:
|
camera | Int32 | 1 | 用户摄像头状态,取值如下:
|
mic | Int32 | 1 | 用户麦克风状态,取值如下:
|
can_share | Int32 | 2 | 用户共享权限状态,取值如下:
|
login_time | Int64 | 1600928701534 | 用户登录教室时间,为 Unix 时间戳,单位:毫秒。 |
join_live_time | Int64 | 1600928726313 | 用户连麦时间,为 Unix 时间戳,单位:毫秒。 |
{
"ret": {
"code": 0,
"message": "succeed"
},
"data": {
"attendee_list": [
{
"uid": 171171717,
"nick_name": "Shawn",
"role": 1,
"login_time": 1600928701534,
"join_live_time": 1600928726313,
"camera": 2,
"mic": 2,
"can_share": 2
}
],
"seq": 1,
"room_id": "123456"
}
}
返回码 | 描述 |
---|---|
10005 | 需要先登录房间。 |
10006 | 房间不存在。 |
联系我们
文档反馈