跳到主要内容

initSDK

功能介绍

说明

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

注意

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

函数原型

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

输入参数

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

返回结果

名称数值类型描述
successBOOL标识是否初始化成功
onConnectingOIMVoidCallback连接中的回调
onConnectFailureOIMFailureCallback连接失败的回调
onConnectSuccessOIMFailureCallback连接成功的回调
onKickedOfflineOIMVoidCallback踢下线的回调
onUserTokenExpiredOIMVoidCallbacktoken 过期的回调

代码示例

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() 函数重新登录。
}];