Discussion

初始化 SDK 需要设置 TIMSdkConfig 信息，TIMSdkConfig 主要包含 sdkAppId 设置、Log 相关逻辑设置、数据库存储路径设置、网络监听设置等， 其中 sdkAppId 的获取请参考官网文档 跑通Demo(iOS与Mac)。

Discussion

主要用来开启/关闭自动已读上报和已读回执，设置默认拉取的群组资料，群成员资料字段，监听用户登录状态、会话刷新、消息已读回执、文件上传进度、群组事件通知。

1. disableAutoReport 是否开启多终端同步未读提醒，这个选项主要影响多终端登录时的未读消息提醒逻辑。 YES：只有当一个终端调用 setReadMessage() 将消息标记为已读，另一个终端再登录时才不会收到未读提醒； NO：消息一旦被一个终端接收，另一个终端都不会再次提醒。同理，卸载 APP 再安装也无法再次收到这些未读消息。
2. enableReadReceipt 是否开启被阅回执，接收端设置，发送端才会生效。 YES：接收者查看消息（setReadMessage）后，消息的发送者会收到 TIMMessageReceiptListener 的回调提醒； NO: 不开启被阅回执，默认不开启。
3. groupInfoOpt 设置拉取群资料中的自定义字段。
4. groupMemberInfoOpt 设置拉群成员资料中的自定义字段。

Discussion

添加消息监听后，会在 TIMMessageListener 的 onNewMessage 收到回调消息，消息内容通过参数 TIMMessage 传递。 消息的解析可参阅 消息解析 。

Discussion

1. 登录需要设置用户名 userID 和用户签名 userSig，userSig 生成请参 UserSig 后台 API。
2. 如果 userSig 过期，登录会返回 ERR_USER_SIG_EXPIRED：6206 错误码，收到错误码后请生成新的 userSig 重新登录。
3. 用户在线情况下被踢，会在 TIMUserConfig 里面配置的 TIMUserStatusListener 监听器获取 onForceOffline 回调，收到回调后可以选择重新登录。
4. 用户离线状态下被踢，会在用户重新登录时收到 (ERR_IMSDK_KICKED_BY_OTHERS：6208) 错误码，此时需要再次调用 login() 强制上线。

更多详情请参考 用户状态变更。

Discussion

自动登录类似“记住密码”的功能，如果上一次已经成功登录，那么一段时间内都只需要传入用户名就可以完成登录。 相比于普通的 login(TIMLoginParam) 接口，该接口可以减少 IM SDK 向您的服务器索要 UserSig 的频率， 既可以加快登录速度，又能减少你的 UserSig 服务器压力，也在一定程度上降低了 UserSig 泄漏的风险。

1. 首次登录之后，SDK 会把登录信息存在在本地，下次登录即可调用自动登录
2. 如果用户之前没有登录过，或则 APP 被卸载过，自动登录会报 ERR_NO_PREVIOUS_LOGIN：6026 错误，这个时候请调用 login 接口重新登录。

Discussion

退出登录，如果切换账号，需要 logout 回调成功或者失败后才能再次 login，否则 login 可能会失败。

Discussion

一个会话对应一个聊天窗口，比如跟一个好友的 1v1 聊天，或者一个聊天群，都是一个会话。

Discussion

本接口与 deleteConversation() 的差异在于，deleteConversation() 只是删除单个会话，而本接口会额外把本地缓存的消息记录也一并删除掉。

Discussion

token 是苹果后台对客户端的唯一标识，需要主动调用系统 API 向苹果请求获取，请求成功后， 可以在 didRegisterForRemoteNotificationsWithDeviceToken 回调收到对应的 token 信息。 具体实现见下面代码示例：

//获取 token 代码示例
if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0) {
[[UIApplication sharedApplication] registerUserNotificationSettings:
[UIUserNotificationSettings settingsForTypes:
(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:nil]];
[[UIApplication sharedApplication] registerForRemoteNotifications];
}
else{
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:
(UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)];
}

//收到 token 代码示例
-(void)application:(UIApplication *)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
//回调的 deviceToken 就是需要的 token 信息
}

busiId 是推送证书 ID，是向 IM 控制台上传 iOS 证书（p.12）生成的， 具体步骤请参考 离线推送。

Discussion

设置 APNS，可设置单聊、群组推送声音，也可以设置是否开启推送。

Discussion

APP 进后台的时候需要主动调用 doBackground ，这个时候后台知道 APP 的状态，之后的消息会下发推送通知。

- (void)applicationDidEnterBackground:(UIApplication *)application {
[TIMBackgroundParam](../Classes/TIMBackgroundParam.html)  *param = [[TIMBackgroundParam alloc] init];
[param setC2cUnread:unReadCount];
[[TIMManager sharedInstance] doBackground:param succ:^() {
// to do
} fail:^(int code, NSString * err) {
// to do
}];
}

Discussion

APP 进前台的时候需要主动调用 doForeground，这个时候后台知道 APP 的状态，之后的消息不会下发推送通知。

- (void)applicationDidBecomeActive:(UIApplication *)application {
[[TIMManager sharedInstance] doForeground:^() {
//to do
} fail:^(int code, NSString * err) {
//to do
}];
}

Discussion

该接口相当于 login() 函数的无网络版本，适用于在用户没有网络（未登录）的情况下查看用户的本地会话和消息。

Discussion

通过 ImSDK 提供的日志功能打印日志

Discussion

您可以在 initSdk -> TIMSdkConfig -> disableLogPrint 设置日志是否打印

Discussion

此函数待废弃，请直接使用 TIMGroupManager 的 sharedInstance 函数

Discussion

此函数待废弃，请直接使用 TIMFriendshipManager 的 sharedInstance 函数

Discussion

Discussion

不建议客户使用，删除消息和减少未读数是本地操作，没有和服务器做同步，在程序卸载或则多端同步中会出现未读数不一致的问题。