====== 聊天室概述 ======
更新时间：2022-06-22
===== 功能描述 =====
聊天室是支持多人加入的类似 Twitch 的组织。聊天室中的成员没有固定关系，用户离线后，超过 5 分钟会自动退出聊天室。聊天室成员在离线后，不会收到推送消息。聊天室可以应用于直播、消息广播等。
聊天室的使用限制视不同套餐版本而定，请参见 [[ccim:limitation|使用限制]]。
本文以及接下来几篇主要介绍聊天室管理功能，如需查看消息相关内容，参见 [[ccim:web:message1|消息管理]]。
==== 群组与聊天室的区别 ====
群组和聊天室均为支持多人沟通的即时通讯系统。两者的区别在于，群组中的成员会有固定的强的关系，成员加入后会长时间的在群组中。聊天室中的成员没有固定关系，类似与一个开放的空间，用户可以自由加入，离开即退出聊天室。
=== 群组与聊天室的功能对比 ===
^功能 ^群组 ^聊天室 ^
|使用场景 |类似于 Signal，Skype 里的群聊，所有加入的用户拥有固定的关系。 |类似 Twitch 的直播间，成员间没已有固定关系，离开即退出。 |
|最大成员数 |成员数支持取决于所选择的版本，最高版本支持 8,000 人。 |成员数支持取决于所选择的版本，最高版本支持 10,000 人。如需提升该上限，请联系商务。 |
|离线推送消息 |离线时，会收到推送消息。 |离线时，不会收到推送消息。 |
|离线消息存储 |支持离线消息存储，每个会话存储 200 条消息。
用户上线时，会收到离线消息。 |不支持离线消息存储。如果需要用户新加入聊天室时服务器推送最近的历史消息，可以联系商务开通聊天室历史消息推送，每个会话默认支持 10 条消息，最多可调整至 200 条。 |
|消息可靠性 |群组中发送的所有消息，用户都会收到。 |当消息量大时，聊天室中超过阈值的消息会被丢弃。消息开始丢弃的阈值为每秒 100 条消息，可以根据需求进行调整。 |
==== 功能列表 ====
=== 聊天室角色介绍 ===
^聊天室成员角色 ^描述 ^管理权限 ^
|普通成员 |不具备管理权限的聊天室成员。 |普通成员可以修改自己的聊天室资料。 |
|聊天室管理员 |由聊天室所有者授权，协助进行管理，拥有一定的管理权限。 |管理员可以对聊天室成员进行管理。
管理员最多可添加 99 个。 |
|聊天室所有者 |聊天室的创建者，在群中拥有最高的权限。 |聊天室可以指定管理员、解散聊天室、更改聊天室信息、对聊天室成员进行管理。 |
== 聊天室操作 ==
^功能 ^描述 ^
|创建聊天室 |只有特定用户有权限创建聊天室，聊天室成员数会受到版本指定聊天室最大成员数的限制。 |
|加入聊天室 |所有成员有权限加入聊天室。 |
|离开聊天室 |所有聊天室成员有权限离开聊天室。 |
|销毁聊天室 |需要聊天室所有者权限。 |
|获取聊天室列表 |所有聊天室成员有权限获取聊天室列表，获取为分页获取，需要指定分页大小。 |
|获取聊天室详情 |所有聊天室成员有权限获取聊天室详情。 |
|修改聊天室名称 |需要聊天室所有者权限。 |
|聊天室公告 |聊天室所有者有权限编辑公告、删除公告
公告更新会通过监听同步给所有成员。 |
=== 聊天室成员管理 ===
^功能 ^描述 ^
|聊天室单个成员禁言 |需要聊天室所有者或管理员权限，可以对当个的群成员进行禁言。 |
|聊天室全员禁言 |需要聊天室所有者或管理员权限，全局禁言时，默认聊天室所有者和管理员不禁言。 |
|白名单管理 |全局禁言时，白名单的成员可以发消息。 |
|聊天室管理员 |聊天室所有者可以指定、删除聊天室管理员。 |
|黑名单管理 |在黑名单的用户不能在聊天室发送消息。 |