登录及登出
[TOC]
登录
手动登录
@protocol QDIMLoginManager <NSObject>
/**
登录
@param account 用户ID;账号;手机号
@param completion 完成回调
*/
- (void)loginWithAccount:(NSString *)account password:(NSString *)password completion:(void (^)(NSString * __nullable token, NSError * __nullable error))completion;
/**
* 短信登录
*
* @param mobile 手机号
* @param vcode 验证码
* @param completion 完成回调
*/
- (void)loginWithMoblie:(NSString *)mobile vcode:(NSString *)vcode completion:(void (^)(NSString * __nullable token, NSError * __nullable error))completion;
/**
自动登录
@param account 账户
@param token 令牌
*/
- (void)autoLoginWithAccount:(NSString *)account token:(NSString *)token;
@end
示例
NSString *account = @"your account";
NSString *password = @"your password";
[[QDClient sharedClient].loginManager loginWithAccount:account password:password completion:^(NSString * _Nullable token, NSError * _Nullable error) { }];
error 为登录错误信息,成功则为 nil。
自动登录
APP 启动时,如果已保存用户名和密码可以选择调用自动登录接口,并立刻打开主界面。此类登录需要调用如下接口:
@protocol QDIMLoginManager <NSObject>
/**
自动登录
@param account 账户
@param token 令牌
*/
- (void)autoLoginWithAccount:(NSString *)account token:(NSString *)token;
@end
登录的过程中会有回调,APP需要实现如下回调
@protocol QDLoginManagerDelegate <NSObject>
/**
* 登录回调
*
* @param step 登录步骤
* @discussion 这个回调主要用于客户端UI的刷新
*/
- (void)onLogin:(QDLoginStep)step;
@end
QDLoginStep 枚举列表
值 | 说明 |
---|---|
QDLoginStepLinking | 连接服务器 |
QDLoginStepLinkOK | 连接服务器成功 |
QDLoginStepLinkFailed | 连接服务器失败 |
QDLoginStepLogining | 登录 |
QDLoginStepLoginOK | 登录成功 |
QDLoginStepLoginFailed | 登录失败 |
QDLoginStepSyncing | 开始同步 |
QDLoginStepSyncOK | 同步成功 |
QDLoginStepLoseConnection | 连接断开 |
QDLoginStepNetChanged | 网络切换 |
自动登录失败的回调
- (void)onAutoLoginFailed:(NSError *)error;
自动登录除了会触发相应步骤变化回调外,在发生错误时也会触发如上回调。在碰到一些 SDK 无法自动解决的错误时,开发者需要在此回调里做出相应的处理。
举例来说,当前网络状态较差时,容易导致自动登录发生网络超时错误,此时上层无需处理,SDK 会持续有策略地重连,而一旦发生用户名密码不匹配的错误时,则需要上层做出相应处理:登出并提示用户手动登录或是从自己的应用服务器刷新相应的用户名密码。
登出
应用层登出/注销自己的账号时需要调用 SDK 的登出操作,该操作会通知服务器进行 APNs 推送信息的解绑操作,避免用户已登出但推送依然发送到当前设备的情况发生。
@protocol QDIMLoginManager <NSObject>
- (void)logout:(void(^)(NSError * __nullable error))completion;
@end
考虑到用户体验,登出的超时时间会比其他请求短一些。上层应用不管登出请求是否成功,UI 表现上都应该做出登出行为。
示例:
[[QDClient sharedClient].loginManager logout:^(NSError * _Nullable error) {
//jump to login page
}];
互踢
内置踢人策略为:移动端(Android,iOS)互踢, 移动端和web共存,和pc端共存
被踢的回调
/**
* 被踢(服务器/其他端)回调
*
* @param code 被踢原因
* @param clientType 发起踢出的客户端类型
*/
- (void)onKick:(QDKickReason)code clientType:(QDPlatfromType)clientType;
APP收到被踢回调后需要进行注销并切换到登录界面。
账号信息获取
在登录成功后,我们可以通过如下接口获取用户id
NSString *userID = [QDClient sharedClient].loginInfo.userId;
登录与用户信息同步
QD_IMSDK 的登录一共有大约十个步骤,包括正在连接,连接成功,正在登录等。详见 QDLoginStep 枚举。其中重要的两个步骤为:登录成功 (QDLoginStepLoginOK) 和 同步成功 (QDLoginStepSyncOK)。
登录成功 SDK 已成功登录,获取到基本信息,并开始同步数据 同步成功 SDK 已同步完成所有 IM 信息 QD_IMSDK 在登录后会同步群信息,离线消息,系统通知等数据。