监听聊天室事件
聊天室业务为客户端 App 提供三种类型的事件监听器:聊天室状态监听器、聊天室成员变化监听器、聊天室事件通知监听器。通过这三个监听器,客户端 App 可以从融云服务端获取聊天室销毁状态、用户在当前及其他客户端加入退出聊天室的状态、聊天室中成员进出的事件通知、以及聊天室中成员禁言、封禁相关的信息。
参数说明
监听器 | 名称 | 说明 |
---|---|---|
ChatRoomAdvancedActionListener | 聊天室状态监听器 | 接收 在当前客户端登录的用户加入、退出聊天室的事件与聊天室销毁状态的信息。 |
ChatRoomMemberActionListener | 聊天室成员变化监听器 | 接收当前用户所在聊天室中其他用户加入、退出聊天室的信息。 |
ChatRoomNotifyEventListener | 聊天室事件通知监听器 | 接收当前所在聊天室中成员禁言、封禁相关的信息;接收当前用户在其他端加入、退出聊天室相关的信息。 |
监听聊天室状态
应用程序可以监听当前客户端上用户加入、退出聊天室的事件与聊天室销毁状态变更。
使用 RongChatRoomClient
的 addChatRoomAdvanceActionListener
setChatRoomAdvancedActionListener
添加或设置 ChatRoomAdvancedActionListener 监听器。
示例代码
Java
// addChatRoomAdvanceActionListener,since 5.2.5
RongChatRoomClient.addChatRoomAdvanceActionListener(
new ChatRoomAdvancedActionListener() {
@Override
public void onJoining(String chatRoomId) {
// default implementation ignored
}
@Override
public void onJoined(String chatRoomId) {
// 加入聊天室成功,已废弃
// default implementation ignored
}
@Override
public void onJoined(String chatRoomId, JoinChatRoomResponse joinChatRoomResponse) {
// 加 入聊天室成功 since 5.6.3
// default implementation ignored
}
@Override
public void onReset(String chatRoomId) {
// default implementation ignored
}
@Override
public void onQuited(String chatRoomId) {
// default implementation ignored
}
@Override
public void onDestroyed(String chatRoomId, ChatRoomDestroyType type) {
data.setFirstAndNotify(Pair.create(chatRoomId, type));
}
@Override
public void onError(String chatRoomId, CoreErrorCode code) {
// default implementation ignored
}
});
// setChatRoomAdvanceActionListener
RongChatRoomClient.setChatRoomAdvanceActionListener(listener);
移除监听器:
示例代码
Java
// removeChatRoomAdvanceActionListener,since 5.2.5
RongChatRoomClient.addChatRoomAdvanceActionListener(listener);
// setChatRoomAdvanceActionListener
RongChatRoomClient.setChatRoomAdvanceActionListener(null);
聊天室状态事件
下方列出了聊天室操作监听器 ChatRoomAdvancedActionListener
提供的事件列表及回调方法。
参数说明
回调方法 | 触发时机 | 说明 |
---|---|---|
onJoining(String chatRoomId) | 当前用户正在加入聊天室 | 返回数据包括:聊天室 ID |
onJoined(String chatRoomId, JoinChatRoomResponse) | 当前用户已加入聊天室(5.6.3 开始提供)。 | 返回数据包括:聊天室 ID,聊天室房间信息、用户在聊天室的状态。 |
onJoined(String chatRoomId) | 当前用户已加入聊天室(从 5.6.3 开始废弃) | 返回数据包括:聊天室 ID |
onReset(String chatRoomId) | 用户所在聊天室被重置。 | 返回数据包括:聊天室 ID。注意,加入聊天室成功,但是聊天室被重置,接收到此回调后,还会立刻收到 onJoining 和 onJoined 回调。 |
onQuited(String chatRoomId) | 当前用户退出聊天室 | 返回数据包括:聊天室 ID |
onDestroyed(String chatRoomId, IRongCoreEnum.ChatRoomDestroyType type) | 当前用户在线,且所在聊天室被销毁 | 返回数据包括:聊天室 ID、聊天室销毁类型。聊天室销毁类型为 ChatRoomDestroyType.MANUAL |