Flutter IMLib 初始化

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

初始化选项​

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

工厂：RCIMIWEngine.create(appKey, options)。

初始化示例​

Dart
import 'package:impaas_imlib/impaas_imlib.dart';

// create 具备单次初始化语义：同 appKey 重复调用返回同一实例，不建立连接。
final engine = await RCIMIWEngine.create(
  'YOUR_APP_KEY',
  RCIMIWEngineOptions.create(naviServer: 'https://im.example.com'),
);

幂等与生命周期​

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

初始化后做什么​

事件与错误

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