开通和配置聊天室功能

更新时间: 2024/06/12 17:16:41

网易云信 IM 聊天室采用多层架构设计,可以实现真正意义上的大型聊天室,参与人数无上限,又可满足消息到达的实时性要求,主要应用于娱乐直播、教育直播等场景。聊天室是一项付费拓展能力,需要在选购 IM 基础功能的情况下增购。

本文介绍如何开启和配置聊天室功能。

开启聊天室功能

前提条件

操作步骤

  1. 在控制台首页应用管理中选择应用,然后单击 IM 即时通讯下的功能配置按钮进入功能配置页。

    image.png
  2. 在顶部选择聊天室页签,开启聊天室功能。

  3. 阅读并确认信息后,单击确认开启聊天室功能。

配置聊天室子功能

对于聊天室功能下的部分子功能,若需要扩展,则需要单独开通,您可以单击子功能配置开通需要的子功能。

聊天室子功能列表说明

需要单独开通和配置的聊天室子功能说明请参考如下表格:

聊天室功能 功能介绍
聊天室全服广播 发送聊天室内的全服广播消息,所有聊天室都可以收到该消息
聊天室消息回调 聊天室消息第三方回调能力
单用户可创建聊天室数 单个用户可创建的聊天室数量
聊天室用户进出消息历史存储 聊天室用户进出的消息是否需要存储在历史消息中
聊天室用户进出消息系统下发 聊天室用户进出时是否要下发消息
聊天室历史消息天数 聊天室历史消息可存储的时间限制
聊天室登录策略 设置聊天室用户登录应用服务器或云信服务器的方式
聊天室多端登录模式 设置用户在不同端的登录模式
聊天室进出抄送完全对应 登录聊天室过程中因网络异常会出现抄送登录登出不对齐,因此导致状态判断错乱的情况可开启该功能
聊天室自动销毁机制 聊天室支持根据配置策略自动关闭/销毁,减少资源消耗

配置聊天室登录策略

登录策略指应用需要采用的一种或多种 IM 登录方式。云信 SDK 支持以下三种登录方式:

  • 静态 token:用户手动登录 IM 时需传入静态 token。静态 token 默认永久有效,且恒定不变,除非主动调用 新版服务端 API刷新。
  • 动态 token:用户手动登录 IM 时需传入动态 token。动态 token 具备时效性,适用于对于用户信息安全有较高要求的业务场景。
  • 第三方回调:用户手动登录 IM 时的鉴权工作由指定的第三方服务器(可以是应用服务器)进行,云信服务端不做 IM 登录鉴权。选择第三方回调后,请至第三方回调配置进行相关设置。

如未选择相应的登录策略,可能导致用户调用登录接口时因无登录权限而报错(状态码:403)。

配置聊天室多端登录模式

云信 SDK 支持配置两种不同的聊天室多端登录模式:

  • 只允许一端登录,Windows、Web、Android、iOS 彼此互踢。同一账号仅允许在一台设备上登录。当该账号在另一台设备上成功登录时,新设备会将旧设备踢下线。
  • 各端均可以同时登录在线。最多可支持10个设备同时在线,在设备数上限内,所有的新设备再次登录,均不会将在线的旧设备踢下线。
  • 控制台修改多端互踢的逻辑之后,下次新的设备登录时才会基于新的多端互踢策略进行校验,已经建立连接的设备不会因为策略的修改被强制踢出。
  • 如果某台设备重复登录同一个聊天室,后登录的会将前面的长连接断开,此时会再触发一次进入聊天室的抄送,但是不会触发退出聊天室的抄送。关于进出聊天室(eventType=9)的抄送请参见聊天室成员进出聊天室事件抄送
此文档是否对你有帮助?
有帮助
去反馈
  • 开启聊天室功能
  • 前提条件
  • 操作步骤
  • 配置聊天室子功能
  • 聊天室子功能列表说明
  • 配置聊天室登录策略
  • 配置聊天室多端登录模式