SDK 初始化
小于 1 分钟
Flutter 集成文档
SDK 初始化
初始化是使用 SDK 的必要步骤,需在所有接口方法调用前完成。
如果进行多次初始化操作,只有第一次初始化以及相关的参数生效。
提示
需要在主进程中进行初始化。
前提条件
有效的环信即时通讯 IM 开发者账号和 App key,详见环信即时通讯云控制台的相关文档。
初始化
初始化示例代码:
EMOptions options = EMOptions.withAppKey(appKey);
await EMClient.getInstance.init(options);
对于 Flutter SDK 4.13.0 及以上版本,初始化时支持设置 ExtSettings.kDisableIosEnterBackground
参数,用于控制是否在 iOS 端应用进入和返回后台时调用 iOS SDK 的以下两种方法:
applicationDidEnterBackground
:调用该方法会断开连接。applicationWillEnterForeground
:调用该方法后会重新链接。
该功能默认开启,若要关闭,可进行如下设置:
EMOptions options = EMOptions.withAppKey(
appKey,
extSettings: {ExtSettings.kDisableIosEnterBackground: false},
);
await EMClient.getInstance.init(options);