文档简介：
聊天室是支持多人沟通的即时通讯系统。聊天室中的成员没有固定关系，用户离线后，超过 5 分钟会自动退出聊天室。聊天室成员在离线后，不会收到推送消息。聊天室可以应用于直播、消息广播等。
本文介绍如何使用环信即时通讯 IM SDK 在实时互动 app 中创建和管理聊天室，并实现聊天室的相关功能。
消息相关内容见 消息管理。
技术原理
环信即时通讯 IM Flutter SDK 提供 EMChatRoom、EMRoomManager 和 EMChatRoomEventHandler 类用于聊天室管理，支持你通过调用 API 在项目中实现如下功能：
- 创建聊天室
- 从服务器获取聊天室列表
- 加入聊天室
- 获取聊天室详情
- 退出聊天室
- 解散聊天室
- 监听聊天室事件
前提条件
开始前，请确保满足以下条件：
- 完成 SDK 初始化，详见 快速开始；
- 了解环信即时通讯 IM 的 使用限制。
- 了解环信即时通讯 IM 不同版本的聊天室相关数量限制，详见 环信即时通讯 IM 价格 (opens new window)。
- 只有超级管理员才有创建聊天室的权限，因此你还需要确保已调用 RESTful API 添加了超级管理员，详见 添加聊天室超级管理员。
- 聊天室创建者和管理员的数量之和不能超过 100，即管理员最多可添加 99 个。
实现方法
本节介绍如何使用环信即时通讯 IM SDK 提供的 API 实现上述功能。
创建聊天室
仅 超级管理员 可以调用 EMChatRoomManager#createChatRoom 方法创建聊天室，并设置聊天室的名称、描述、最大成员数等信息。成功创建聊天室后，该超级管理员为该聊天室的所有者。
你也可以直接调用 REST API 从服务端创建聊天室。
示例代码如下：
try { EMChatRoom room = await EMClient.getInstance.chatRoomManager.createChatRoom(name); } on EMError catch (e) { }
加入聊天室
用户申请加入聊天室的步骤如下：
- 调用 EMChatRoomManager#fetchPublicChatRoomsFromServer 方法从服务器获取聊天室列表，查询到想要加入的聊天室 ID。
- 调用 EMChatRoomManager#joinChatRoom 方法传入聊天室 ID，申请加入对应聊天室。新成员加入聊天室时，其他成员收到 EMChatRoomEventHandler#onMemberJoinedFromChatRoom 事件。
示例代码如下：
// 获取公开聊天室列表，每次最多可获取 1,000 个。 try { EMPageResult<EMChatRoom> result
= await EMClient .getInstance.chatRoomManager .fetchPublicChatRoomsFromServer( pageNum: pageNum,
pageSize: pageSize, ); } on EMError catch (e) { } // 加入聊天室 try { await EMClient.getInstance.
chatRoomManager.joinChatRoom(roomId); } on EMError catch (e) { }
获取聊天室详情
聊天室所有成员均可以调用 EMChatManager#fetchChatRoomInfoFromServer 获取聊天室详情，包括聊天室 ID、聊天室名称，聊天室描述、最大成员数、聊天室所有者、是否全员禁言以及聊天室权限类型。聊天室公告、管理员列表、成员列表、黑名单列表、禁言列表需单独调用接口获取。
示例代码如下：
try { EMChatRoom room = await EMClient.getInstance.chatRoomManager.
fetchChatRoomInfoFromServer(roomId); } on EMError catch (e) { }
退出聊天室
聊天室所有成员均可以调用 EMChatRoomEventHandler#leaveChatRoom 方法退出当前聊天室。成员退出聊天室时，其他成员收到 onMemberExitedFromChatRoom 回调。
示例代码如下：
try { await EMClient.getInstance.chatRoomManager.leaveChatRoom(roomId); } on EMError catch (e) { }
退出聊天室时，SDK 默认删除该聊天室的所有本地消息，若要保留这些消息，可在 SDK 初始化时将 EMOptions#deleteMessagesAsExitChatRoom 设置为 false。
示例代码如下：
EMOptions options = EMOptions( appKey: APPKEY, deleteMessagesAsExitChatRoom: false, );
与群主无法退出群组不同，聊天室所有者可以离开聊天室，例如所有者从服务器下线则 5 分钟后自动离开聊天室。如果所有者重新进入聊天室仍是该聊天室的所有者。
解散聊天室
仅聊天室所有者可以调用 EMChatRoomManager#destroyChatRoom 方法解散聊天室。聊天室解散时，其他聊天室成员收到 EMChatRoomEventHandler#onChatRoomDestroyed 回调并被踢出聊天室。
示例代码如下：
try { await EMClient.getInstance.chatRoomManager.destroyChatRoom(roomId); } on EMError catch (e) { }
监听聊天室事件
EMChatRoomEventHandler 类中提供了聊天室事件的监听接口。你可以通过注册聊天室监听器，获取聊天室事件，并作出相应处理。如不再使用该监听，需要移除，防止出现内存泄露。
示例代码如下：
// 添加监听器 EMClient.getInstance.chatRoomManager.addEventHandler( "UNIQUE_HANDLER_ID",
EMChatRoomEventHandler( // 转让聊天室。聊天室全体成员会收到该事件。 onOwnerChangedFromChatRoom:
(roomId, newOwner, oldOwner) {}, // 禁言指定成员。被禁言的成员会收到该事件。 onMuteListAddedFromChatRoom
: (roomId, mutes, expireTime) {}, // 解除对指定成员的禁言。被解除禁言的成员会收到该事件。
onMuteListRemovedFromChatRoom: (roomId, mutes) {}, // 解散聊天室。聊天室全体成员会收到该事件。
onChatRoomDestroyed: (roomId, roomName) {}, // 聊天室详情有变更。聊天室的所有成员会收到该事件。
onSpecificationChanged: (room) {}, // 有用户加入聊天室。聊天室的所有成员（除新成员外）会收到该事件。
onMemberJoinedFromChatRoom: (roomId, participant) {}, // 有成员主动退出聊天室。聊天室的所有成员
（除退出的成员）会收到该事件。 onMemberExitedFromChatRoom: (roomId, roomName, participant) {},
// 有成员被移出聊天室。被移出的成员收到该事件。 onRemovedFromChatRoom: (roomId, roomName, participant)
{}, // 聊天室公告变更。聊天室的所有成员会收到该事件。 onAnnouncementChangedFromChatRoom: (roomId,
announcement) {}, // 有成员被加入白名单列表。被添加的成员收到该事件。 onAllowListAddedFromChatRoom:
(roomId, members) {}, // 有成员被移出白名单列表。被移出白名单的成员会收到该事件。
onAllowListRemovedFromChatRoom: (roomId, members) {}, // 全员禁言状态变更。聊天室所有成员会收到该事件。
onAllChatRoomMemberMuteStateChanged: (roomId, isAllMuted) {}, // 有成员被设为管理员。被添加的管理员会收到该事件。
onAdminAddedFromChatRoom: (roomId, admin) {}, // 有成员被移除管理员权限。被移除的管理员会收到该事件。
onAdminRemovedFromChatRoom: (roomId, admin) {}, // 聊天室自定义属性有更新。聊天室所有成员会收到该事件。
onAttributesUpdated: (roomId, attributes, from) {}, // 有聊天室自定义属性被移除。聊天室所有成员会收到该事件。
onAttributesRemoved: (roomId, keys, fromId) {}, ), ); // 移除监听器 EMClient.getInstance.chatRoomManager
.removeEventHandler("UNIQUE_HANDLER_ID");
