IM 即时通讯
iOS
产品介绍
简介
主要功能
产品优势
功能介绍
帐号集成与登录
基础消息功能
群组功能
聊天室功能
聊天室标签功能
圈组功能
多端登录与互踢策略
质量数据监控台
海外数据中心
IM平滑迁移方案
接口及业务限制
更新日志
IM UIKit 更新日志
NIM SDK 开发版更新日志
NIM SDK 稳定版更新日志
体验 Demo
下载 SDK 与 Demo 源码
快速开始
跑通 IM Demo 源码
跑通圈组 Demo 源码
实现单聊消息收发(不含 UI)
实现圈组消息收发(不含 UI)
含 UI 集成
什么是 IM UIKit
IM UIKit 功能概览
快速集成 IM UIKit
组件导入
初始化与登录
界面跳转
自定义用户信息
会话列表相关
集成会话列表界面
自定义会话列表 UI
会话列表 API 概览
会话消息相关
集成会话消息界面
实现地理位置消息功能
实现音视频通话
实现自定义消息收发
自定义会话消息 UI
会话消息 API 概览
通讯录相关
集成通讯录界面
自定义通讯录 UI
通讯录 API 概览
IM UIKit API 概览
不含 UI 集成
集成 SDK
初始化
登录相关
登录 IM
多端登录与互踢
登出 IM
消息相关
消息概述
消息收发
自定义消息收发
消息配置选项
NOS 资源场景
广播消息收发
消息已读回执
消息撤回
消息重发与转发
消息更新
消息过滤
语音消息处理
本地消息插入
历史消息
最近会话
服务端会话服务
用户资料
用户关系
在线状态订阅
系统通知
离线推送
群组功能
群组概述
群组管理
群成员管理
群消息管理
超大群功能
聊天室
圈组功能
圈组概述
登录管理
服务器相关
服务器概述
服务器管理
服务器成员管理
游客功能
服务器未读数管理
频道相关
频道概述
频道管理
频道黑白名单
实时互动频道
频道分组
频道分组黑白名单
频道未读数管理
搜索服务器与频道
身份组相关
身份组概述
身份组应用场景
服务器身份组
频道身份组
频道分组身份组
用户定制权限
自定义权限项
成员权限查询与判定
身份组相关查询
圈组订阅机制
圈组消息相关
图解圈组消息流转
圈组消息收发
圈组消息撤回
圈组消息更新
圈组消息删除
消息正在输入
会话消息回复(Thread)
圈组快捷评论
圈组消息缓存
圈组消息搜索
查询历史消息
查询@我的消息
圈组系统通知相关
圈组系统通知概述
圈组系统通知收发
圈组系统通知更新
圈组离线推送
圈组内容审核
圈组第三方回调
圈组相关抄送
圈组各端接口命名差异
反垃圾
聊天扩展
其他
最佳实践
IM 登录最佳实践
聊天室重要消息投递
参考文档
iOS PushKit 配置
iOS苹果推送配置
API 参考
iOS SDK API
iOS SDK 状态码
IM 控制台指南
创建应用
注册 IM 账号
升级服务
开通聊天室功能
配置客户端应用标识
常见问题
FAQ
错题集
iOS 推送问题排查
服务协议

IM 登录最佳实践

更新时间: 2023/01/12 20:27:02

登录对于 IM 产品来说至关重要,是后续业务顺利进行的前提条件。开发者集成 NIM SDK 的各项能力时,如果未能正确使用登录接口或处理登录状态,将引发不必要的问题,影响开发进度。本文介绍如何以最佳姿势进行手动登录自动登录,进而实现 IM 登录。

  • 手动登录:首次登录 IM 时调用NIMLoginManager.login:token:completion:方法实现。
  • 自动登录:手动登录 IM 成功之后调用autoLogin:token:。调用时机为:手动登陆成功之后下次启动应用时;自动登录之后的应用存活期间,因为网络断开 SDK 会自己重连,不需要业务层调用。

本文的手动登录仅以静态 Token 登录为例,更多登录相关说明请参见登录 IM

前提条件

  • 已创建应用并获取 App Key 1. 在左侧导航栏中找到“应用”,并单击“创建”。
    创建应用
    2. 填写应用的基本信息后,单击“创建”。
    创建应用
    3. 创建应用后,可以在左侧导航栏中查看该应用,并单击 “App Key 管理”,并获取 App Key 和 App Secret。
    查看应用的AppKey
  • 集成 NIM SDK

  • 已通过云信服务端注册 IM 账号 ,获取 IM 账号(accid)和对应的静态token

    您也可通过控制台注册 IM 测试账号。测试账号及对应的token仅适用于调试环境,线上生产环境必须将测试账号及其token替换为云信服务端生成的正式accidtoken

实现方案

手动登录

IM 手动登录接口的调用,对应用户手动输入账号和密码进行登录的场景。一般情况下,该接口需在应用的didFinishLaunchingWithOptions启动后,用户在登录界面点击登录时调用。其他情况一般不需要调用手动登录接口,除非是账号被踢下线、切换账号、注销登录后重新登录等情况。在登录界面中,IM 登录可以作为整个应用登录过程的一个环节。常见的方案是先实现应用自身账号体系的登录,成功后再使用返回的accidtoken进行 IM 的登录。

  • 手动登录流程


    手动登录流程图.png

  • 接口调用

    1. 调用login:token:completion:方法手动登录云信IM。

      可以在调用手动登录接口时,在登录界面加上等待加载框,等收到登录结果之后再隐藏该等待加载框。登录没有返回 error 就是登录成功。

    2. 调用后处理。

      • 如果登录成功,保存 IM 的accidtoken到本地,方便下次应用启动自动登录时使用。
      • 如果登录失败,清理本地保存的用户登录信息,防止下次启动走自动登录逻辑。

    示例代码如下:

    [[[NIMSDK sharedSDK] loginManager] login:accid token:token completion:^(NSError * _Nullable error) {
                
                if (error) {
                    
                } else {
                    
                    [[NSUserDefaults standardUserDefaults] setObject:accid forKey:@"NIMAccid"];
                    [[NSUserDefaults standardUserDefaults] setObject:token forKey:@"NIMToken"];
                    
                    FirstViewController *mainTab = [[FirstViewController alloc] init];
                    [UIApplication sharedApplication].delegate.window.rootViewController = mainTab;
                }
            }];
    

自动登录

手动登录 IM 成功后,下次启动应用可以使用云信 IM 的自动登录模式。自动登录后,即使登录未完成或者网络无法访问,应用也可以直接访问用户本地 SDK 数据。

自动登录主要针对应用被清理掉后,再次点击图标启动时,无需输入用户名和密码即可完成登录的场景。自动登录还有一个作用,即在网络不佳且账号和密码本身正常(未被封禁,且账号密码均正确)时,如果启动应用时调用手动登录接口未成功,SDK 会自动进行重连登录,不需要上层开发者去做额外的重登逻辑。

  • 自动登录流程


  • 接口调用

    调用autoLogin:token:autoLogin:方法进行自动登录。一般在应用启动和初始化 SDK 之后,如果判断本地已经有持久化的账号和密码即可进行自动登录,自动登录没有回调结果,在跳转到应用首页之前调用一次即可。

    自动登录的使用限制如下:

    • 自动登录只能登录上次登录的IM 账号,不能登录其他账号。
    • 需要某个 IM 账号曾经通过手动登录接口登录成功后才可以调用。
    • 无论之前是否曾经手动登录成功,只要最近一次手动登录接口调用失败,则不可以继续自动登录。
    • 在被云信服务端踢下线、被同时在线的其他端踢下线、被封禁账号、登录密码错误等情况下,后续自动登录将无效,需要用户通过手动登录接口重新登录。更多相关说明,见下文的登录状态处理

    实现自动登录的示例代码如下(仅以autoLogin:token:的调用为例):

    [[NIMSDK sharedSDK].loginManager addDelegate:self];
        NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];
        
        if ([[userDefaults objectForKey:@"NIMToken"] length] > 0) {
            //自动登录
            
            [[NIMSDK sharedSDK].loginManager autoLogin:[userDefaults objectForKey:@"NIMAccid"] token:[userDefaults objectForKey:@"NIMToken"]];
            
            FirstViewController *firstVc = [[FirstViewController alloc] init];
            UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:firstVc];
            firstVc.title = @"第一个页面";
            self.window.rootViewController = nav;
        } else {
            //登录
            LoginViewController *loginVc = [[LoginViewController alloc] init];
            UINavigationController *loginNav = [[UINavigationController alloc] initWithRootViewController:loginVc];
            loginVc.title = @"登录";
            self.window.rootViewController = loginNav;
        }
    
    

登录状态处理

IM 登录状态表示当前登录的 NIM SDK 实例与云信服务端的长连接状态,也可以理解为用户设备和云信服务端的网络连接状态。

初始化 SDK 之后,可调用NIMLoginManager.addDelegate方法注册onLogin:登录回调、onKickout:被踢回调和onAutoLoginFailed:自动登录失败回调,监听当前的登录状态,并通过 UI 层提示用户。其他使用场景一般只需要在手动登录成功后或者自动登录期间才需要处理 IM 登录状态。

登录的状态监听建议放在您应用的AppDelegate里。


登录状态处理的流程图如下:

示例代码如下:

监听登录状态
@interface AppDelegate ()<NIMLoginManagerDelegate>
@end
[[NIMSDK sharedSDK].loginManager addDelegate:self];
#pragma mark - 登录状态监听
- (void)onLogin:(NIMLoginStep)step {
    switch (step) {
        case NIMLoginStepLinking: {
            NSLog(@"---# 连接服务器ing");
            break;
        }
        case NIMLoginStepLinkOK: {
            NSLog(@"---# 连接服务器成功");
            break;
        }
        case NIMLoginStepLinkFailed: {
            NSLog(@"---# 连接服务器失败");
            break;
        }
        case NIMLoginStepLogining: {
            NSLog(@"---# 登录ing");
            break;
        }
        case NIMLoginStepLoginOK: {
            NSLog(@"---# 登录成功");
            break;
        }
        case NIMLoginStepLoginFailed: {
            NSLog(@"---# 登录失败");
            break;
        }
        case NIMLoginStepSyncing: {
            NSLog(@"---# 开始同步数据");
            break;
        }
        case NIMLoginStepSyncOK: {
            NSLog(@"---# 同步数据完成");
            break;
        }
        case NIMLoginStepLoseConnection: {
            NSLog(@"---# 连接断开");
            break;
        }
        case NIMLoginStepNetChanged: {
            NSLog(@"---# 网络切换");
            break;
        }
        case NIMLoginStepLogout: {
            NSLog(@"---# 登出");
            break;
        }
    }
}
监听被云信服务端或其他设备端踢下线
@interface AppDelegate ()<NIMLoginManagerDelegate>
@end
[[NIMSDK sharedSDK].loginManager addDelegate:self];
#pragma mark - 被踢(服务器/其他端)回调
- (void)onKickout:(NIMLoginKickoutResult *)result {
    //被踢的回调,有被踢的原因,需要在这里logout。
    [[NIMSDK sharedSDK].loginManager logout:^(NSError * _Nullable error) {
        //这里跳回登录页面
        
        self.window.rootViewController = [LoginViewController new];
        
        [[NSUserDefaults standardUserDefaults] setObject:@"" forKey:@"NIMAccid"];
        [[NSUserDefaults standardUserDefaults] setObject:@"" forKey:@"NIMToken"];
        
    }];
}
监听自动登录失败
@interface AppDelegate ()<NIMLoginManagerDelegate>
@end
[[NIMSDK sharedSDK].loginManager addDelegate:self];
#pragma mark - 自动登录失败
- (void)onAutoLoginFailed:(NSError *)error {
    //这里跳转到登录页面重新登录
    if (error) {
        self.window.rootViewController = [LoginViewController new];
    }
}

Sample Code 下载


点击下载
Sample Code
点击下载...
Text is not SVG - cannot display

此文档是否对你有帮助?
有帮助
我要吐槽
  • 前提条件
  • 实现方案
  • 手动登录
  • 自动登录
  • 登录状态处理
  • Sample Code 下载