iOS IMLib 初始化

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

初始化选项​

字段类型必填说明
appkeystring是控制台应用 AppKey，必填
serverUrlstring否IM 服务地址（含协议与端口）
timeoutMsuint32否请求超时（毫秒）
transportany否自定义传输实现（高级用法，一般无需设置）

工厂：ImpIaaSIM.client(options: IMPClientOptions) -> IMPClient。

初始化示例​

import ImpIaaSIM
let options = IMPClientOptions(appkey: "YOUR_APP_KEY", serverUrl: "https://im.example.com")
let client = ImpIaaSIM.client(options: options)
print(client.getCurrentUserId())
#import <ImpIaaSIM/ImpIaaSIM.h>

// 工厂：initWithAppkey:serverUrl:（应用内单例见 ImpIaaSIM.client）
IMPOSClient *client = [[IMPOSClient alloc] initWithAppkey:@"YOUR_APP_KEY"
                                                serverUrl:@"https://im.example.com"];

幂等与生命周期​

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

初始化后做什么​

事件与错误

事件名来自 capabilityModel.events（16 个）；失败码见 状态码。绑定状态：ga。