保利威文档中心

帮助中心

在线列表

更新时间:2025-03-21 14:06:01

聊天室模块(chat) 提供用户列表相关 Api,用于开发者开发在线人数、在线列表等功能。

一、开始在线用户列表轮询

说明: 每隔 1 分钟轮询在线用户列表,调用后会立即触发一次

Api 方法: startOnlineUserListPolling(): void

从 v1.8.0 版本开始支持

二、结束在线用户列表轮询

Api 方法: stopOnlineUserListPolling(): void

从 v1.8.0 版本开始支持

三、获取在线用户列表新接口

Api 方法: getOnlineUserListNew(): Promise<UserListResult>

从 v1.8.0 版本开始支持

返回值说明: Promise<UserListResult> 类型,详细类型说明如下

属性名 说明 类型
count 在线人数 number
userlist 列表 ChatMessageUser<ChatUserType>[]

示例:

const result = await watchCore.chat.getOnlineUserListNew();
console.log('在线列表:', result.userlist);

四、获取聊天室的实时在线人数

通过 getOnlineUserCount 获取实时在线人数,ChatEvents.OnlineUserCountChange 事件监听聊天室在线人数的改变。

Api 方法: getOnlineUserCount(): number

返回值说明: 实时在线人数

示例:

const onlineUserCount = watchCore.chat.getOnlineUserCount();
console.log('当前聊天室在线人数:', onlineUserCount);

// 监听人数改变
watchCore.chat.eventEmitter.on(ChatEvents.OnlineUserCountChange, (data) => {
  console.log('在线人数改变:', data.onlineUserCount);
});
联系客服,在线咨询