OpenIM HarmonyOS SDK 概览

OpenIM HarmonyOS SDK 以 HAR 形式提供类型化 ArkTS API，底层通过 N-API 调用 OpenIMClientSDK。应用可以使用同一套接口实现用户、关系链、会话、群组、消息、本地数据、音视频通话信令和实时事件能力。

适用范围

HarmonyOS SDK 支持以下设备类型与原生架构：

三类设备均使用 Platform.HarmonyOS，不需要维护不同的业务 API。窗口较多的 2in1 应用应由进程统一持有 SDK 实例和数据库目录，关闭单个窗口不等于销毁 SDK。

HarmonyOS SDK 属于商业版交付能力。具体发行包、授权范围和商业能力以实际取得的 HAR 与商业协议为准。

接入模型

SDK 默认导出一个进程级实例：

import sdk, { OpenIMSDKEvent } from '@openimsdk/imsdk';

• 异步 API 返回 Promise，成功后直接得到声明中的响应对象，不包含额外的 { data } 外层。
• 调用失败时 Promise 会被拒绝，并携带 errCode 与 errMsg，可据此区分参数、连接和服务端错误。
• sdk.on() 返回取消订阅函数。查询 API 建立当前数据，事件合并后续变化，必要时再查询校准。
• 本地数据库、日志和媒体文件必须使用应用沙盒内真实、可写或可读的路径。

推荐接入顺序

1. 按开始之前准备 OpenIMServer、登录凭据和 DevEco Studio 环境。
2. 按工程与设备接入安装 HAR、声明权限并初始化 SDK。
3. 在登录前注册连接和同步事件，再按认证与管理登录会话登录。
4. 等待连接成功与服务端同步完成后，按发送第一条消息验证消息收发。

推荐运行顺序为：initSDK → 注册事件 → login → 等待连接成功和同步完成 → 调用业务 API。