IChatManagerLogin

Extends Protocol:	IChatManagerBase
Declared In:	IChatManagerLogin.h

Introduction

本协议包括：登录、退出、修改密码等方法

Discussion

所有不带Block回调的异步方法, 需要监听回调时, 需要先将要接受回调的对象注册到delegate中, 示例代码如下: [[[EaseMob sharedInstance] chatManager] addDelegate:self delegateQueue:dispatch_get_main_queue()]

Methods

-2_0_6: 异步方法, 注销当前登录用户
-asyncLoginWithUsername:password:: 异步方法, 使用用户名密码登录聊天服务器
-asyncLoginWithUsername:password:completion:onQueue:: 异步方法, 使用用户名密码登录聊天服务器
-asyncLogoffWithCompletion:onQueue:: 异步方法, 注销当前登录用户
-asyncLogoffWithUnbindDeviceToken:: 异步方法, 注销当前登录用户
-asyncLogoffWithUnbindDeviceToken:completion:onQueue:: 异步方法, 注销当前登录用户
-asyncRegisterNewAccount:password:: 异步方法, 在聊天服务器上创建账号
-asyncRegisterNewAccount:password:withCompletion:onQueue:: 异步方法, 在聊天服务器上创建账号
-importDataToNewDatabase: 将数据库数据导入新的数据库，旧版sdk数据库采用CoreData,从2.1.0版本开始，换成Sqlite
-loadDataFromDatabase: 调用sdk登录接口，登陆成功之后，sdk内部会默认调用一次该函数从数据库获取信息，包括自己相关的群组，被屏蔽的群组的id数组，会话，消息
-loginWithUsername:password:error:: 使用用户名密码登录聊天服务器
-logoffWithError:: 注销当前登录用户
-logoffWithUnbindDeviceToken:error:: 注销当前登录用户
-registerNewAccount:password:error:: 在聊天服务器上创建账号

2_0_6

异步方法, 注销当前登录用户

@optional

- (void)asyncLogoff EM_DEPRECATED_IOS(2_0_6, 2_1_1, "Use - asyncLogoffWithUnbindDeviceToken:");

Discussion

在注销过程中, EMChatManagerLoginDelegate中的didLogoffWithError:回调会被触发.

asyncLoginWithUsername:password:

异步方法, 使用用户名密码登录聊天服务器

- (void)asyncLoginWithUsername:(NSString *)username password:(NSString *)password;

Parameters

username: 用户名
password: 密码

Discussion

在登陆过程中, EMChatManagerLoginDelegate中的didLoginWithInfo:error:回调会被触发

asyncLoginWithUsername:password:completion:onQueue:

异步方法, 使用用户名密码登录聊天服务器

- (void)asyncLoginWithUsername:(NSString *)username password:(NSString *)password 
        completion:(void (^)(NSDictionary *loginInfo, EMError *error))completion 
        onQueue:(dispatch_queue_t)aQueue;

Parameters

username: 用户名
password: 密码
completion: 回调
aQueue: 回调时的线程

asyncLogoffWithCompletion:onQueue:

异步方法, 注销当前登录用户

@optional

- (void)asyncLogoffWithCompletion:(void (^)(NSDictionary *info, EMError *error))completion 
        onQueue:(dispatch_queue_t)aQueue EM_DEPRECATED_IOS(2_0_6, 2_1_1, "Use - asyncLogoffWithUnbindDeviceToken:completion:onQueue:");

Parameters

completion: 回调
aQueue: 回调时的线程

asyncLogoffWithUnbindDeviceToken:

异步方法, 注销当前登录用户

- (void)asyncLogoffWithUnbindDeviceToken:(BOOL)isUnbind;

Return Value

完成后【didLogoffWithError:】回调会被触发.

Discussion

当接收到【didLoginFromOtherDevice】和【didRemovedFromServer】的回调时，调用此方法，isUnbind传NO

asyncLogoffWithUnbindDeviceToken:completion:onQueue:

异步方法, 注销当前登录用户

- (void)asyncLogoffWithUnbindDeviceToken:(BOOL)isUnbind 
        completion:(void (^)(NSDictionary *info, EMError *error))completion 
        onQueue:(dispatch_queue_t)aQueue;

Parameters

completion: 回调
aQueue: 回调时的线程

Discussion

当接收到【didLoginFromOtherDevice】和【didRemovedFromServer】的回调时，调用此方法，isUnbind传NO

asyncRegisterNewAccount:password:

异步方法, 在聊天服务器上创建账号

- (void)asyncRegisterNewAccount:(NSString *)username password:(NSString *)password;

Parameters

username: 用户名
password: 密码

Discussion

在注册过程中, EMChatManagerLoginDelegate中的didRegisterNewAccount:password:error:回调会被触发

asyncRegisterNewAccount:password:withCompletion:onQueue:

异步方法, 在聊天服务器上创建账号

- (void)asyncRegisterNewAccount:(NSString *)username password:(NSString *)password 
        withCompletion:(void (^)(NSString *username, NSString *password, EMError *error))completion 
        onQueue:(dispatch_queue_t)aQueue;

Parameters

username: 用户名
password: 密码
completion: 回调
aQueue: 回调时的线程

importDataToNewDatabase

将数据库数据导入新的数据库，旧版sdk数据库采用CoreData,从2.1.0版本开始，换成Sqlite

- (EMError *)importDataToNewDatabase;

Return Value

错误信息

Discussion

同步方法，登录成功之后调用

loadDataFromDatabase

调用sdk登录接口，登陆成功之后，sdk内部会默认调用一次该函数从数据库获取信息，包括自己相关的群组，被屏蔽的群组的id数组，会话，消息

- (EMError *)loadDataFromDatabase;

Return Value

错误信息

Discussion

登录成功之后调用

loginWithUsername:password:error:

使用用户名密码登录聊天服务器

- (NSDictionary *)loginWithUsername:(NSString *)username 
        password:(NSString *)password error:(EMError **)pError;

Parameters

username: 用户名
password: 密码
pError: 错误信息

Return Value

登录后返回的用户信息

Discussion

如果登陆失败, 返回nil

logoffWithError:

注销当前登录用户

@optional

- (NSDictionary *)logoffWithError:(EMError **)pError EM_DEPRECATED_IOS(2_0_6, 2_1_1, "Use - logoffWithUnbindDeviceToken:error:");

Parameters

pError: 错误信息

Return Value

返回注销信息

logoffWithUnbindDeviceToken:error:

注销当前登录用户

- (NSDictionary *)logoffWithUnbindDeviceToken:(BOOL)isUnbind 
        error:(EMError **)pError;

Parameters

isUnbind: 是否解除device token
pError: 错误信息

Return Value

返回注销信息

Discussion

当接收到【didLoginFromOtherDevice】和【didRemovedFromServer】的回调时，调用此方法，isUnbind传NO

registerNewAccount:password:error:

在聊天服务器上创建账号

- (BOOL)registerNewAccount:(NSString *)username password:(NSString *)password 
        error:(EMError **)pError;

Parameters

username: 用户名
password: 密码
pError: 错误信息

Return Value

是否注册成功

Properties

isConnected: 是否连上聊天服务器
isLoggedIn: 当前是否已有登录的用户
loginInfo: 当前登录的用户信息

isConnected

是否连上聊天服务器

@property (nonatomic,
    readonly) BOOL isConnected;

isLoggedIn

当前是否已有登录的用户

@property (nonatomic,
    readonly) BOOL isLoggedIn;

loginInfo

当前登录的用户信息

@property (nonatomic,
    strong,
    readonly) NSDictionary *loginInfo;

Last Updated: Friday, May 11, 2018