聊天室服务配置
聊天室业务本身不需要单独申请开通,但部分聊天室服务需要在控制台开通与配置,例如聊天室广播消息、聊天室消息云端存储、以及与聊天室相关的回调地址等。
聊天室服务配置主要在免费基础功能和 IM 服务管理页面。
免费基础功能
以下是聊天室业务提供的免费基础功能:
- 单个用户加入多个聊天室:默认一个用户只能加入一个聊天室中,开启后一个用户可以同时加入到多个聊天室中。
- 聊天室状态同步:聊天室状态同步是融云提供的服务端回调服务,需同时提供可正常访问的回调地址。配置成功后,在应用下聊天室发生状态变化时,将实时同步到开发者的应用服务器地址,目前支持的同步状态包括:创建、销毁、成员加入、成员退出聊天室。详见 IM 服务端文档「聊天室管理」下的聊天室状态同步。
- 加入聊天室获取指定消息设置:默认加入聊天室时可最多获取全部消息类型的最近 50 条消息,开启后可设置指定消息类型获取。
- 聊天室销毁等待时间:
- 可以支持配置不活跃聊天室销毁的等待时间,默认等待时间为1小时,即超过1小时不活跃即被销毁,客户可以按需调整这个时间,最长可设置24小时。
- 聊天室销毁时,会向聊天室成员发送聊天室销毁通知,以方便客户可以在聊天室销毁后,在终端自定义一些操作(依赖 5.1.1 及以后版本)。
- 聊天室增加 sessionid,在聊天室生存周期内保持不变,聊天室重建后重新生成。用于使用相同聊天室ID,多次开播时,客户端能区分出来。
- 聊天室属性自定义设置:可在指定聊天室中设置自定义属性,用于语音直播聊天室场景的会场属性同步或狼人杀等卡牌类游戏场景中记录用户的角色和牌局状态等,详见「聊天室业务」下的聊天室属性管理文档。如果 App 业务服务端需要融云提供聊天室属性变更数据同步,需要提供可正常访问的回调地址,配置成功后,自动开启融云提供的服务端回调服务,详见 IM 服务端文档「聊天室管理」下的聊天室属性同步。
- SDK 用户不在聊天室中不能发送消息:默认情况下,用户未加入聊天室时可以向聊天室中发送消息。开启后,不在聊天室的用户不能通过客户端 SDK 在该聊天室发送消息。注意:服务端发送聊天室消息的接口不受此配置影 响。
- 多端同时在线情况下,一端退出聊天室其他端也同步退出聊天室:用户多端同时在线且都加入了同一聊天室时,默认情况一端退出聊天室后其他端不退出。开启此功能后多端在线情况下,如果需要一端退出后,其他端也退出聊天室。
修改服务配置
访问控制台免费基础功能页面,可调整聊天室业务相关的免费基础功能配置。
IM 旗舰版/尊享版功能
下图显示了控制台 IM 服务管理 页面与聊天室业务相关的普通服务配置。
开发环境下可以免费使用。生产环境下,IM 旗舰版或 IM 尊享版才能使用以下服务。
- 聊天室广播消息:向应用中的所有聊天室发送一条消息,单条消息最大 128k。详见 IM 服务端文档「消息管理」下的发送全体聊天室广播消息。
- 聊天室全局禁言功能:当不想让某一 用户在所有聊天室中发言时,可将此用户添加到聊天室全局禁言中,被禁言用户可接收查看聊天室中用户聊天信息,但不能发送消息。详见 IM 服务端文档「聊天室用户管理」下的全局禁言用户。
- 聊天室消息优先级服务:在指定聊天室中设置指定类型的消息为低级别消息。当服务器负载高时低级别消息优先被丢弃,这样可以确保重要的消息不被丢弃。详见 IM 服务端文档「聊天室消息优先级服务」下的添加低级别消息。
- 聊天室白名单服务:开通后,可以使用以下功能对应的 Server API:
- 聊天室保活服务:当聊天室中 1 小时无人说话,同时没有人加入聊天室时,融云服务端会自动把聊天室内所有成员踢出聊天室并销毁聊天室。保活的聊天室不会被自动销毁,可以调用 API 接口销毁聊天室。详见 IM 服务端文档「聊天室管理」下的保活聊天室。
- 聊天室消息云端存储:聊天消息保存在云端,用户进入聊天室后,可以查看聊天室中以前的消息,历史消息默认保存 2 个月。
- 加入聊 天室获取指定消息配置:加入聊天室时只返回指定类型的消息,不返回其他类型的消息。
修改服务配置
访问开发后台 IM 服务管理页面,切换到普通服务标签下,可启用以下聊天室服务配置开关。您还可以在扩展服务标签下对部分服务的具体配置进行调整。