大规模房间
可以在后台创建大规模房间。 当普通一对多 的房间中用户人数达到 100人 时，此房间会自动升级成为大房间。可以在-
void onBecomeBigRoom()回调中监听，表示此时房间已升级为大房间。 以下接口均是在大房间情况的调用生效。
getUserNumberByRoles
-
简要描述
获取大房间特定用户的人数 根据用户角色搜索用户，返回人数
-
回调
结果会以on_gotuserinfo回调函数返回结果
-
接口详情
int getusernumberbyroles(struct roomclient client , const int roles_in = 0 , int roles_in_size = 0)
| 参数名 | 说明 |
|---|---|
| roles | 用户角色数组 |
| roles_in_size | 用户角色大小 |
getUserInfoByRoles
-
简要描述
大房间时，获取房间用户列表 根据角色，分页请求，获取特定数量的用户。
-
回调
结果会以on_gotuserinfo 回调函数返回结果
-
接口详情
int getuserinfobyroles(struct roomclient client , int start , int max , const int roles_in = 0 , int roles_in_size = 0)`
| 参数名 | 说明 |
|---|---|
| start | 起始位置，比如：0，20，40等 |
| max | 最大数量，比如：20 |
| roles | 用户角色数组 |
| roles_in_size | 角色大小 |
changeuserpropertybyids
-
简要描述
大房间时，批量改变指定用户的属性
-
回调
结果会以on_roomuserchanged 回调函数通知其他的用户
-
接口详情
int changeuserpropertybyids(struct roomclient client , const char ids , int ids_len , char tellWhom , tkstring properties);
| 参数名 | 说明 |
|---|---|
| ids | 用户ID |
| ids_len | 用户数量 |
| tellWhom | 接受者ID(要通知给哪些用户。“all”：所有人；“allExceptSender”：除自己以外的所有人；“allExceptAuditor”：除旁听用户以外的所有人；“None”：不通知任何人；某用户的peerID：只发给该用户) |
| properties | 被修改的用户属性 |
changeUserPropertyByRoles
-
简要描述
大房间时，批量改变指定用户的属性
-
回调
结果会以on_roomuserchanged 回调函数通知其他的用户
-
接口详情
int changeuserpropertybyids(struct roomclient client , const int roles_in , int ids_len , char* tellWhom , tkstring properties);
| 参数名 | 说明 |
|---|---|
| roles_in | 用户角色 |
| ids_len | 用户数量 |
| tellWhom | 接受者ID(要通知给哪些用户。“all”：所有人；“allExceptSender”：除自己以外的所有人；“allExceptAuditor”：除旁听用户以外的所有人；“None”：不通知任何人；某用户的peerID：只发给该用户) |
| properties | 被修改的用户属性 |
