文档反馈
文档反馈

多端登录与互踢策略

功能概述

云信SDK支持多终端,并存在多端登录的现象。当前云信SDK支持配置四种不同的多端登录策略:

登录网易云信用户控制台,进入对应应用IM功能下的「功能配置」,可以进行多端登录策略配置。

只允许一端登录

当配置为「只允许一端登录」时,同一账号仅允许在一台设备上登录。当该账号在另一台设备上成功登录时,新设备会将旧设备踢下线。

桌面端互踢、移动端互踢、桌面与移动端同时登录

当配置为「桌面端互踢、移动端互踢、桌面与移动端同时登录」时,同一账号最多允许在1台桌面端设备(PC、Web)和1台移动端设备(iOS、Android)上同时登录并收发消息。

以下情况下新设备会将旧设备踢下线:

以下情况下新设备和旧设备可以共存:

各端均可以同时登录在线

最多可支持10个设备同时在线,在设备数上限内,所有的新设备再次登录,均不会将在线的旧设备踢下线。

自定义多端登录

功能配置

如上述三种登录策略不能满足要求,且SDK版本在7.8.0及以上,云信可提供纯自定义的多端登录策略。登录网易云信用户控制台,进入对应应用IM功能下的「功能配置」,在「多端登录配置」中选择「自定义多端登录配置」,即可进行自定义多端登录策略配置。

如上图所示,云信提供5种内置终端类型,分别是iOS、AOS(安卓)、Mac、PC、Web,内置终端类型之间,如有互踢要求,可在对应的行列中勾选互踢。

例如:需要将iOS与AOS之间实现互踢,则在表格中第二行第三列处勾选互踢,勾选后,第三行第二列处也会自动勾选,需要将iOS与Web共存,则确保第三行第六列不要勾选。如下图所示:

当内置的终端类型不足以覆盖所有终端时,支持添加新的终端类型。点击下方「添加」按钮,选择「自定义」终端类型,并以整数数字命名新的终端类型名称,点击「确定」即可添加自定义的终端类型。

如需删除某一类终端,也可以勾选左侧复选框,点击删除去掉该类型。

配置完成后,点击保存,才可生效。

配置生效

各端登录时,客户端初始化时,需要配置自定义客户端类型。配置该字段后,遵循相应的自定义多端登录逻辑。若没有传,则认为是预定义的客户端类型(PC、AOS、PC、IOS、WEB)。具体方法可参考API文档中相关说明:

×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。