Web

开通和配置聊天室功能

更新时间: 2024/03/14 19:21:17

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

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

开通 IM 专业版时开启聊天室功能

聊天室功能可在您开通 IM 专业版时开通。

前提条件

已在云信控制台创建应用

操作步骤

  1. 在控制台首页应用管理选择应用进入应用配置页面,然后单击 IM即时通讯 专业版下的正式开通

    开通专业版.png

  2. 在该页面的开通功能下,选择开启聊天室

    开通聊天室.png

  3. 完成日活估算和使用时长等其他专业版配置项后,确认实付金额,并在阅读《网易云信服务条款》后勾选我已阅读并同意《网易云信服务器条款》

  4. 单击提交订单,完成升级 IM 专业版,同时开通聊天室功能。

开通 IM 专业版后开启聊天室功能

如果您在正式开通专业版时未选择开启聊天室,您可参照以下步骤开通该功能。

前提条件

已开通 IM 专业版。

操作步骤

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

    功能配置.png

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

    开启聊天室.png

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

配置聊天室子功能

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

聊天室子功能.png

聊天室子功能列表说明

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

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

配置聊天室登录策略

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

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

聊天室登录策略.png

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

配置聊天室多端登录模式

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

  • 只允许一端登录,Windows、Web、Android、iOS 彼此互踢。同一账号仅允许在一台设备上登录。当该账号在另一台设备上成功登录时,新设备会将旧设备踢下线。
  • 各端均可以同时登录在线。最多可支持10个设备同时在线,在设备数上限内,所有的新设备再次登录,均不会将在线的旧设备踢下线。

聊天室多端登录.png

  • 控制台修改多端互踢的逻辑之后,下次新的设备登录时才会基于新的多端互踢策略进行校验,已经建立连接的设备不会因为策略的修改被强制踢出。
  • 如果某台设备重复登录同一个聊天室,后登录的会将前面的长连接断开,此时会再触发一次进入聊天室的抄送,但是不会触发退出聊天室的抄送。关于进出聊天室(eventType=9)的抄送请参见聊天室成员进出聊天室事件抄送
此文档是否对你有帮助?
有帮助
去反馈
  • 开通 IM 专业版时开启聊天室功能
  • 前提条件
  • 操作步骤
  • 开通 IM 专业版后开启聊天室功能
  • 前提条件
  • 操作步骤
  • 配置聊天室子功能
  • 聊天室子功能列表说明
  • 配置聊天室登录策略
  • 配置聊天室多端登录模式