initSDK

功能介绍

说明

初始化是客户端调用 SDK 的第一步，在应用的生命周期内只能调用一次，重复调用可能会导致未知的问题。

注意

（1）初始化成功后，再设置各种监听器，并进行登录，确保在同步等待登陆回调完成后再调用其他API。具体流程在各端的快速集成中有示例；
（2）客户端的底层日志会存放在指定目录，供调试查看，但不建议在生产环境中启用。

iOS

函数原型

    // 方法一
   Future<dynamic> initSDK({
      required int platform,
      required String apiAddr,
      required String wsAddr,
      required String dataDir,
      required OnConnectListener listener,
      int logLevel = 6,
      bool isLogStandardOutput = true,
      String? logFilePath,
      String? operationID,
    });

    // 方法二
    Future<bool?> init(
    InitConfig config,
    OnConnectListener listener, {
    String? operationID,
  });

输入参数

参数名称	参数类型	是否必填	描述
config	InitConfig	是	初始化参数

返回结果

名称	数值类型	描述
~	dynamic	标识是否初始化成功

代码示例

     OpenIM.iMManager.initSDK(
          platform: IMPlatform.android,
          apiAddr: '',
          wsAddr: '',
          dataDir: '',
          listener: OnConnectListener(
            onConnectFailed: (code, errorMsg) {},
            onConnecting: () {},
            onConnectSuccess: () {},
            onKickedOffline: () {},
            onUserTokenExpired: () {},
          ),
        );

Android

函数原型

- (BOOL)initSDKWithConfig:(OIMInitConfig *)config
             onConnecting:(nullable OIMVoidCallback)onConnecting
         onConnectFailure:(nullable OIMFailureCallback)onConnectFailure
         onConnectSuccess:(nullable OIMVoidCallback)onConnectSuccess
          onKickedOffline:(nullable OIMVoidCallback)onKickedOffline
       onUserTokenExpired:(nullable OIMVoidCallback)onUserTokenExpired;

输入参数

参数名称	参数类型	是否必填	描述
config	OIMInitConfig	是	初始化参数

返回结果

名称	数值类型	描述
success	BOOL	标识是否初始化成功
onConnecting	OIMVoidCallback	连接中的回调
onConnectFailure	OIMFailureCallback	连接失败的回调
onConnectSuccess	OIMFailureCallback	连接成功的回调
onKickedOffline	OIMVoidCallback	踢下线的回调
onUserTokenExpired	OIMVoidCallback	token 过期的回调

代码示例

OIMInitConfig *config = [OIMInitConfig new];
config.apiAddr = @"";
config.wsAddr = @"";
config.objectStorage = @"";

BOOL success = [OIMManager.manager initSDKWithConfig:config
                                        onConnecting:^{

} onConnectFailure:^(NSInteger code, NSString * _Nullable msg) {
    // 连接失败的回调函数
    // code 错误码
    // error 错误信息
} onConnectSuccess:^{
    // SDK 已经成功连接到IM服务器
} onKickedOffline:^{
    // SDK 正在连接到IM服务器
} onUserTokenExpired:^{
    // 在线时票据过期：此时您需要生成新的 token 并再次调用 的 login() 函数重新登录。
}];

Flutter

参数详解

public boolean initSDK(Application application, InitConfig initConfig, @NotNull OnConnListener listener)

参数名称	参数类型	是否必填	描述
application	Application	是	Application
initConfig	InitConfig	是	初始化参数
listener	OnConnectListener	是	监听

代码示例

InitConfig initConfig=new InitConfig(
            Constant.getImApiUrl(),//SDK api地址
            Constant.getImWsUrl(),//SDK WebSocket地址
            getStorageDir(),//SDK数据库存储目录
            );
     OpenIMClient.getInstance().initSDK(application,
          initConfig,
          new OnConnListener() {
                 @Override
                public void onConnectFailed(long code, String error) {
                    //连接服务器失败
                }

                @Override
                public void onConnectSuccess() {
                    //连接服务器成功
                }

                @Override
                public void onConnecting() {
                    //连接服务器中...
                }

                @Override
                public void onKickedOffline() {
                    //当前用户被踢下线
                }

                @Override
                public void onUserTokenExpired() {
                    //登录票据已经过期
                }
            });

uni-app

注意

open-im-sdk和open-im-sdk-wasm 不需要初始化，直接调用 login 即可。只有在electron中引入@openim/electron-client-sdk采用了ffi的方式，才需要调用initSDK初始化。

参数详解

IMSDK.initSDK(config: InitConfig, operationID?: string):Promise<boolean>

输入参数

参数名称	参数类型	是否必填	描述
config	InitConfig	是	初始化参数
operationID	string	否	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<boolean>	调用成功回调
Promise.catch()	Promise<void>	调用失败回调

代码示例

import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';

const { instance: IMSDK } = getWithRenderProcess();

IMSDK.initSDK({
  platformID: 'your-platform-id',
  apiAddr: 'http://your-server-ip:10002',
  wsAddr: 'ws://your-server-ip:10001',
  dataDir: 'your-db-dir',
  logFilePath: 'your-log-file-path',
  logLevel: LogLevel.Debug,
  isLogStandardOutput: true,
});

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi("initSDK",operationID: string, config: InitConfig): Promise<boolean>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
config	InitConfig	是	初始化参数

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<boolean>	是否初始化成功
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

// App.vue
import IMSDK from 'openim-uniapp-polyfill';

const path = await getDbDir();
const config = {
  apiAddr: 'http://xxx:10002', // IM的API接口地址。如：http://xxx:10002
  wsAddr: 'ws://xxx:10001', // IM的websocket地址。如： ws://xxx:10001
  platformID: uni.$u.os() === 'ios' ? 1 : 2, // 平台，参照Platform类,
  dataDir: path, // 数据存储路径
  logLevel: 6, // 日志打印级别
  logFilePath: path, // 日志存储的目录
  isLogStandardOutput: true, // 是否输出到控制台
};
const flag = await IMSDK.asyncApi('initSDK', IMSDK.uuid(), config);

// utils.js
export const getDbDir = () =>
  new Promise((resolve, reject) => {
    plus.io.requestFileSystem(plus.io.PRIVATE_DOC, (fs) => {
      fs.root.getDirectory(
        'user',
        {
          create: true,
        },
        (entry) => {
          resolve(entry.fullPath);
        },
        (error) => {
          reject(error);
        }
      );
    });
  });

React-Native

函数原型

OpenIMSDKRN.initSDK(config: InitConfig, optionalID:string): Promise<boolean>

输入参数

参数名称	参数类型	是否必填	描述
config	InitConfig	是	初始化参数
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<boolean>	是否初始化成功
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import OpenIMSDKRN from 'open-im-sdk-rn';
import RNFS from 'react-native-fs';

RNFS.mkdir(RNFS.DocumentDirectoryPath + '/tmp');

OpenIMSDKRN.initSDK({
  platformID: 2,  // 1: ios, 2: android
  apiAddr: 'http://your-server-ip:10002',
  wsAddr: 'ws://your-server-ip:10001',
  dataDir: RNFS.DocumentDirectoryPath + '/tmp',
  logLevel: 5,
  isLogStandardOutput: true,
}, 'operationID');

Unity

函数原型

public static bool InitSDK(IMConfig config, IConnCallBack cb)

输入参数

参数名称	参数类型	是否必填	描述
config	IMConfig	是	SDK配置
cb	IConnCallBack	是	网络连接状态回调

代码示例

#if UNITY_EDITOR
        string dataDir = "./OpenIM";
        string logDir = "./OpenIM/Logs";
#else
        string dataDir = Application.persistentDataPath + "/OpenIM";
        string logDir = Application.persistentDataPath + "/OpenIM/Logs";
#endif
        var config = new IMConfig()
        {
            PlatformID = (int)PlatformID,
            WsAddr = wsAddr,
            ApiAddr = apiAddr,
            DataDir = dataDir,
            LogLevel = 5,
            IsLogStandardOutput = true,
            LogFilePath = logDir,
            IsExternalExtensions = true,
        };
        // this 实现IConnCallBack接口
        var res = IMSDK.InitSDK(config, this);
        if (!res)
        {
            Debug.Log("InitSDK:" + false);
            return false;
        }
        Debug.Log("InitSDK:" + res);