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