聊天室状态监听
聊天室业务支持客户端 App 监听以下类型的聊天室操作事件:聊天室房间的状态变化与本端聊天室相关操作、用户在当前及其他客户端加入退出聊天室的状态、聊天室中成员进出的事件通知、以及聊天室中成员禁言、封禁相关的信息。
设置聊天室操作监听器
通过 addEventListener 可以设置监听器。
调用示例: addEventListener(Events.CHATROOM, listener)
JavaScript
const listener = (event) => {
if (event.rejoinedRoom) {
console.log('SDK 内部重连聊天室信息:', event.rejoinedRoom)
}
if (event.updatedEntries) {
console.log('监听到的聊天室 KV 更新:', event.updatedEntries)
}
if (event.userChange) {
console.log('加入退出的用户通知:', event.userChange)
}
if (event.chatroomDestroyed) {
console.log('聊天室销毁:', event.chatroomDestroyed)
}
/* since 5.7.9 */
if (event.chatroomNotifyMultiLoginSync) {
console.log('加入退出多端同步通知:', event.chatroomNotifyMultiLoginSync)
}
/* since 5.7.9 */
if (event.chatroomNotifyBlock) {
console.log('聊天室用户封禁通知:', event.chatroomNotifyBlock)
}
/* since 5.7.9 */
if (event.chatroomNotifyBan) {
console.log('聊天室用户禁言通知:', event.chatroomNotifyBan)
}
}
RongIMLib.addEventListener(Events.CHATROOM, listener)
聊天室销毁事件
下方列出了聊天室销毁事件。
事件 | 触发时机 | 说明 |
---|---|---|
event.chatroomDestroyed | 当前用户在线,且所在聊天室被销毁 | 返回数据包括:聊天室 ID。 |
聊天室成员变化事件
本端用户加入、退出聊天室时默认会触发 event.userChange
事件。
提示
如需监听聊天室中其他成员的加入或退出动作,您需要开通一项免费服务。请前往融云控制台 > 应用配置 > IM 服务 > 免费基础功能 > 聊天室,开启聊天室成员变化监听功能。
事件 | 触发时机 | 说明 |
---|---|---|
event.userChange | 用户加入、退出聊天室 | IChatroomUserChangeInfo 封装了当前聊天室中加入或退出聊天室的成员信息。如果当前用户由于网络原因和聊天室断开连接,则无法监听到断开连接期间的其他成员的加入、退出行为。 |