客户端集成

客户端集成提供两条路径：IMLib 只提供通信能力，UI 由你实现；IMKit 提供开箱即用的会话列表、会话页面与输入组件。两者共享同一套连接与数据模型。

集成路径​

路径适用场景包含能力文档
IMLib已有 UI 体系，需要完全自定义连接、消息、会话、群组、聊天室、好友、上传IMLib 集成
IMKit快速上线标准聊天界面IMLib + 会话列表 / 会话页 / 输入区 / 消息气泡 / 未读角标IMKit 集成

平台支持​

平台语言 / 运行时IMLibIMKit文档
AndroidKotlin（JVM / Android）✅ 已交付✅ 已交付IMLib / IMKit
WebJavaScript（ESM）+ TypeScript✅ 已交付✅ 已交付IMLib / IMKit
ElectronElectron 主进程 + preload 桥✅ 已交付✅ 已交付IMLib / IMKit
macOSArkTS（契约预留）✅ 已交付✅ 已交付IMLib / IMKit
FlutterDart（Flutter）✅ 已交付✅ 已交付IMLib / IMKit
Native (C ABI)C ABI（Rust core）✅ 已交付✅ 已交付IMLib / IMKit
iOSSwift（契约预留）✅ 已交付✅ 已交付IMLib / IMKit
HarmonyOSArkTS（契约预留）⏳ 契约预留⏳ 契约预留IMLib / IMKit

集成步骤​

  1. 获取 AppKey 与 Token

    在控制台创建应用获取 AppKey；由业务服务调用 /user/register 签发用户 Token。

  2. 导入 SDK

    按平台选择 IMLib 或 IMKit 包，完成依赖配置。

  3. 初始化与连接

    使用 AppKey 初始化客户端，再调用 connect(token) 建立长连接。

  4. 收发消息与会话

    发送第一条消息，监听 MESSAGES 事件，渲染会话列表。

  5. 上线前自检

    断网重连、离线补发、多端同步、错误码处理逐项验证。

下一步​