跳转至

大规模房间

可以在后台创建大规模房间。 当普通一对多 的房间中用户人数达到 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 被修改的用户属性

© 2016-2023 北京拓课网络科技有限公司 版权所有  京ICP备17018423号-1 京公网安备11010502043461号