多端登录与互踢
更新时间: 2023/05/30 14:56:10
您可通过两种方式实现 IM 的多端登录与互踢。
方式1:通过云信控制台配置
当前 NIM SDK 支持通过云信控制台配置四种不同的 IM 多端登录策略:
- 只允许一端登录,PC、Web、Android、iOS 彼此互踢。
- 桌面端 PC 与 Web 互踢,移动端 Android 和 iOS 互踢,且桌面端与移动端可同时登录
- 各端均可以同时登录在线(最多 10 个设备同时在线)
- 自定义多端登录配置
通过该方式的配置,可实现自动管控 IM 的多端登录。具体如何配置,请参见多端登录与互踢策略。
方式2:主动将其他端踢下线
API 调用时序
踢方操作
步骤1:监听多端登录
注册RegMultispotLoginCb
回调,监听多端登录事件。 当用户在某个客户端登录时,其他已经在线的客户端会触发该回调。
当同账号的其他客户端类型登录或登出,本端都会收到通知,通知信息包括通知类型 notify_type
(NIMMultiSpotNotifyType )和其他在线的客户端列表 other_clients
(OtherClientPres)。
步骤2:将其他端踢下线
调用KickOtherClient
方法将其他同时登录的设备端踢下线。
示例代码如下:
Client::RegMultispotLoginCb(
[](const MultiSpotLoginRes& res) {
// process multispot login res
},
"");
被踢方操作
被踢的设备端,可在登录 IM 前,注册RegKickoutCb
回调,监听被踢事件。
当被其他客户端踢下线后,会收到通知,通知信息包括被踢原因 kick_reason
(NIMKickReason
)和将其踢下线的设备端的客户端类型 client_type
(NIMClientType
)等信息。
收到被踢回调后,建议进行注销并切换到登录界面。
示例代码如下:
Client::RegKickoutCb(
[](const KickoutRes& res) {
// current client is kicked out
// ......
},
"");
此文档是否对你有帮助?