WildfireChat IM 服务端多端登录策略解析

多端登录策略概述

WildfireChat IM 服务端提供了灵活的多端登录控制机制，通过 server.multi_endpoint 配置项可以控制同一账号是否允许在不同设备上同时登录。当该配置项设置为 false 时，系统会强制单设备登录，新设备登录会自动踢出旧设备。

鸿蒙系统的特殊处理

在实际使用中发现，当运行在鸿蒙系统的客户端登录时，即使 server.multi_endpoint 设置为 false，系统也不会自动踢出其他已登录设备。这是由于服务端默认只对 Android 和 iOS 平台实现了强制单设备登录的逻辑。

解决方案

对于鸿蒙系统设备，可以通过将其平台类型标识为 Android 手机平台（platform=2）来解决这个问题。这种处理方式是因为：

1. 鸿蒙系统保持了与 Android 的兼容性
2. 服务端已经完善了对 Android 平台的多设备登录控制逻辑
3. 这种处理方式不需要修改服务端代码，只需在客户端进行适配

技术实现原理

WildfireChat 服务端通过以下机制实现多设备登录控制：

1. 每个登录会话都会记录客户端平台类型
2. 当新设备登录时，服务端会检查同平台类型的已有会话
3. 如果 multi_endpoint 为 false，则会终止同平台的旧会话
4. 平台类型检测基于客户端上报的元数据

最佳实践建议

对于需要支持鸿蒙系统的项目，建议：

1. 在客户端初始化时明确设置平台类型
2. 如果需要严格单设备控制，确保所有移动端设备都使用相同的平台标识
3. 测试不同场景下的会话保持和踢出逻辑
4. 考虑业务需求是否需要真正的跨平台单设备控制

这种设计体现了 WildfireChat 在保持核心功能稳定性的同时，也提供了足够的灵活性来适应不同的操作系统生态。