跳到主要内容

聊天室服务配置

聊天室业务本身不需要单独申请开通,但部分聊天室服务需要在控制台开通与配置,例如聊天室广播消息聊天室消息云端存储、以及与聊天室相关的回调地址等。

聊天室服务配置主要在免费基础功能IM 服务管理页面。

免费基础功能

以下是聊天室业务提供的免费基础功能:

  • 单个用户加入多个聊天室:默认情况下,一个用户只能加入一个聊天室。开启后,一个用户可以同时加入多个聊天室。
  • 聊天室状态同步:聊天室状态同步是融云即时通讯(IM)服务提供的回调服务,需同时提供可正常访问的回调地址。配置成功后,在应用下聊天室发生状态变化时,将实时同步到开发者的应用服务器地址。目前支持的同步状态包括:创建、销毁、成员加入和成员退出聊天室,详见聊天室状态同步
  • 加入聊天室获取指定消息设置:默认加入聊天室时可最多获取全部消息类型的最近 50 条消息。开启后,可设置获取指定消息类型。
  • 聊天室销毁等待时间
    1. 支持配置不活跃聊天室销毁的等待时间。默认等待时间为 1 小时,即不活跃超过 1 小时即被销毁。您可以按需调整这个时间(必须为 1 至 24 之间的整数),最长可设置为 24 小时。
    2. 聊天室销毁时,会向聊天室成员发送聊天室销毁通知,以方便客户可以在聊天室销毁后,在终端自定义一些操作(依赖 5.1.1 及更高版本 SDK)。
    3. 聊天室增加 sessionId,在聊天室生存周期内保持不变,聊天室重建后重新生成。用于在使用相同聊天室 ID 多次开播时,客户端能区分出来。
  • 聊天室属性自定义设置:可在指定聊天室中设置自定义属性,用于语音直播聊天室场景的会场属性同步,或在狼人杀等卡牌类游戏场景中记录用户的角色和牌局状态等。详见「聊天室管理」下的设置聊天室属性。如果 App 业务服务端需要即时通讯服务提供聊天室属性变更数据同步,需要提供可正常访问的回调地址。配置成功后,自动开启即时通讯服务提供的回调服务,详见聊天室属性同步
  • SDK 用户不在聊天室中不能发送消息:默认情况下,用户未加入聊天室时可以向聊天室中发送消息。开启后,不在聊天室的用户不能通过客户端 SDK 在该聊天室发送消息。注意:服务端发送聊天室消息的接口不受此配置影响。
  • 多端同时在线情况下,一端退出聊天室其他端也同步退出聊天室:用户多端同时在线且均加入了同一聊天室时,默认情况下,一端退出聊天室后其他端不退出。开启此功能后,在多端在线情况下,一端退出聊天室则其他端也同步退出。

修改服务配置

访问控制台免费基础功能页面,可调整聊天室业务相关的免费基础功能配置。

(height=400)

IM 旗舰版/尊享版功能

访问控制台 IM 服务管理页面,切换到普通服务标签下,可启用以下聊天室服务配置开关。

提示

开发环境下可以免费使用。生产环境下,IM 旗舰版IM 尊享版才能使用以下服务。

  • 聊天室广播消息:向应用中的所有聊天室发送一条消息,单条消息最大 128 KB,详见发送全体聊天室广播消息
  • 聊天室全局禁言功能:当不想让某一用户在所有聊天室中发言时,可将此用户添加到聊天室全局禁言中。被禁言用户可接收并查看聊天室中用户聊天信息,但不能发送消息,详见全局禁言用户
  • 聊天室消息优先级服务:在指定聊天室中设置指定类型的消息为低级别消息。当服务器负载高时,低级别消息优先被丢弃,这样可以确保重要的消息不被丢弃,详见添加低级别消息
  • 聊天室白名单服务:开通后,可以使用以下功能对应的 Server API:
    • 聊天室用户白名单:可用于保护指定聊天室中的重要用户,支持按聊天室设置白名单用户。例如,App 业务中指定聊天室中的管理员、主播等重要角色的用户。
    • 聊天室消息白名单:可用于保护 App 下所有聊天室中的指定消息类型。例如 App 业务中自定义的红包消息。
  • 聊天室保活服务:当聊天室中 1 小时无成员发言且无成员加入时,融云 IM 服务端会自动将聊天室内所有成员踢出并销毁聊天室。保活的聊天室不会被自动销毁,可以调用 API 接口销毁聊天室。详见「聊天室管理」下的保活聊天室
  • 聊天室消息云端存储:聊天室消息保存在云端。用户进入聊天室后,可以查看聊天室中以前的消息,历史消息默认保存 2 个月。