Native (C ABI) IMLib 初始化

初始化构造客户端实例：初始化 SDK（构造客户端实例）。幂等：同 appkey 重复初始化返回同一实例。

初始化选项​

初始化示例​

im_client_t* client = im_client_new("YOUR_APP_KEY", "https://im.example.com");
if (client == NULL) {
    fprintf(stderr, "im_client_new failed\n");
}

幂等与生命周期​

• init 幂等：同 appkey 重复初始化返回同一实例（IDL init.idempotent = true），不会重复建立连接。
• 初始化不建立长连接；必须再调用 connect(token)。
• 应用退出 / 页面销毁时调用 disconnect() 停止重连并清理心跳；需要释放句柄时使用平台对应释放接口（如 Native im_client_free）。
• 不要绕过 SDK 直接连接 WebSocket 或直接操作本地数据库，否则会破坏离线补发、去重与多端一致性。

初始化后做什么​

• 建立连接并收发消息
• 订阅连接与消息事件
• 核对初始化选项
• IMKit 初始化（若使用 UI 组件）