开通和配置聊天室功能
更新时间: 2024/08/22 17:21:31
网易云信 IM 聊天室采用多层架构设计,可以实现真正意义上的大型聊天室,参与人数无上限,又可满足消息到达的实时性要求,主要应用于娱乐直播、教育直播等场景。聊天室是一项付费拓展能力,需要在选购 IM 基础功能的情况下增购。
本文介绍如何开启和配置聊天室功能。
开启聊天室功能
前提条件
操作步骤
-
在控制台首页应用管理中选择应用,然后单击 IM 即时通讯下的功能配置按钮进入功能配置页。
-
在顶部选择聊天室页签,开启聊天室功能。
-
阅读并确认信息后,单击确认开启聊天室功能。
配置聊天室子功能
对于聊天室功能下的部分子功能,若需要扩展,则需要单独开通,您可以单击子功能配置开通需要的子功能。
![](https://yx-web-nosdn.netease.im/common/28bb6b1867fc957835c4c01ac2ca580d/聊天室子功能配置.png)
聊天室子功能列表说明
需要单独开通和配置的聊天室子功能说明请参考如下表格:
聊天室功能 | 功能介绍 |
---|---|
聊天室全服广播 | 发送聊天室内的全服广播消息,所有聊天室都可以收到该消息 |
聊天室消息回调 | 聊天室消息第三方回调能力 |
单用户可创建聊天室数 | 单个用户可创建的聊天室数量 |
聊天室用户进出消息历史存储 | 聊天室用户进出的消息是否需要存储在历史消息中 |
聊天室用户进出消息系统下发 | 聊天室用户进出时是否要下发消息 |
聊天室历史消息天数 | 聊天室历史消息可存储的时间限制 |
聊天室登录策略 | 设置聊天室用户登录应用服务器或云信服务器的方式 |
聊天室多端登录模式 | 设置用户在不同端的登录模式 |
聊天室进出抄送完全对应 | 登录聊天室过程中因网络异常会出现抄送登录登出不对齐,因此导致状态判断错乱的情况可开启该功能 |
聊天室自动销毁机制 | 聊天室支持根据配置策略自动关闭/销毁,减少资源消耗 |
配置聊天室登录策略
登录策略指应用需要采用的一种或多种 IM 登录方式。云信 SDK 支持以下三种登录方式:
- 静态 token:用户手动登录 IM 时需传入静态 token。静态 token 默认永久有效,且恒定不变,除非主动调用 新版服务端 API刷新。
- 动态 token:用户手动登录 IM 时需传入动态 token。动态 token 具备时效性,适用于对于用户信息安全有较高要求的业务场景。
- 第三方回调:用户手动登录 IM 时的鉴权工作由指定的第三方服务器(可以是应用服务器)进行,云信服务端不做 IM 登录鉴权。选择第三方回调后,请至第三方回调配置进行相关设置。
![](https://yx-web-nosdn.netease.im/common/de6644c8128f77e13cc7e98ede0b2bfc/聊天室登录策略.png)
如未选择相应的登录策略,可能导致用户调用登录接口时因无登录权限而报错(状态码:403)。
配置聊天室多端登录模式
云信 SDK 支持配置两种不同的聊天室多端登录模式:
- 只允许一端登录,Windows、Web、Android、iOS 彼此互踢。同一账号仅允许在一台设备上登录。当该账号在另一台设备上成功登录时,新设备会将旧设备踢下线。
- 各端均可以同时登录在线。最多可支持10个设备同时在线,在设备数上限内,所有的新设备再次登录,均不会将在线的旧设备踢下线。
![](https://yx-web-nosdn.netease.im/common/6ead74d8378ce3fe5c27a659eda38156/聊天室多端登录.png)
- 控制台修改多端互踢的逻辑之后,下次新的设备登录时才会基于新的多端互踢策略进行校验,已经建立连接的设备不会因为策略的修改被强制踢出。
- 如果某台设备重复登录同一个聊天室,后登录的会将前面的长连接断开,此时会再触发一次进入聊天室的抄送,但是不会触发退出聊天室的抄送。关于进出聊天室(eventType=9)的抄送请参见聊天室成员进出聊天室事件抄送。
此文档是否对你有帮助?