设计理念
为了让开发者更快更方便的使用 SDK,悟空 SDK 提供了一个唯一的入口来访问 SDK 中的所有功能。就像书籍的目录一样可以通过目录查找对应的内容。如连接 IM:- 统一入口:通过
WKIM.shared访问所有功能 - 模块化管理:每个功能模块职责清晰
- 易于维护:代码结构清晰,便于调试和维护
结构说明
WuKongIM HarmonyOS SDK 采用模块化架构设计,各个模块相互协作,为开发者提供完整的即时通讯功能:核心功能模块
连接管理器 (ConnectionManager)
负责IM的连接、断开、退出登录、监听连接状态等。消息管理器 (MessageManager)
负责消息的增删改查、新消息监听、刷新消息监听、消息入库等。会话管理器 (ConversationManager)
负责会话的增删改查、会话列表监听、会话消息监听等。频道管理器 (ChannelManager)
可获取Channel的信息,刷新Channel缓存,监听Channel更改[置顶、免打扰、禁言]等。频道成员管理器 (ChannelMemberManager)
获取Channel成员列表、设置成员备注、保存修改成员数据、监听刷新成员和移除成员等。提醒项管理器 (ReminderManager)
获取某个会话的提醒如:[有人@我] [入群申请] 等。还可自定义提醒项,如像 语音未读 等。命令管理器 (CMDManager)
负责监听服务器下发的命令消息。SDK 与 APP 交互原则
WuKongIM HarmonyOS SDK 采用事件驱动的交互模式,确保数据流的清晰和可控:交互流程说明
SDK 与 APP 交互流程就是 APP 调用 SDK 提供的方法,SDK 处理完数据后通过事件将数据回调给 APP。如发送消息流程:APP 调用发送消息方法,SDK 将入库后的消息 push 给 APP。- APP 调用 SDK 方法:应用通过 SDK 提供的 API 发起操作
- SDK 处理数据:SDK 内部处理业务逻辑,包括数据验证、格式转换等
- 网络通信:SDK 与服务器进行数据交换
- 事件回调:SDK 通过事件机制将处理结果回调给应用
- UI 更新:应用根据回调数据更新用户界面
事件监听示例
开发优势
1. 简单易用
- 统一入口:所有功能通过
WKIM.shared访问 - 清晰结构:模块化设计,职责分明
- 丰富示例:提供完整的使用示例
2. 功能完整
- 全平台支持:专为 HarmonyOS 平台优化
- 消息类型丰富:支持文本、图片、语音、视频等多种消息类型
- 自定义扩展:支持自定义消息类型和业务逻辑
3. 性能优化
- 本地缓存:智能缓存机制,减少网络请求
- 增量同步:只同步变化的数据,提高效率
- 内存管理:优化内存使用,避免内存泄漏
4. 稳定可靠
- 自动重连:网络异常时自动重连
- 数据一致性:确保数据的完整性和一致性
- 错误处理:完善的错误处理机制
5. HarmonyOS 特性支持
- ArkTS 语言:完全支持 ArkTS 开发语言
- 组件化架构:与 HarmonyOS 组件化架构完美融合
- 生命周期管理:与 HarmonyOS 应用生命周期同步
- 权限管理:遵循 HarmonyOS 权限管理规范

