#import <EMClient.h>

类 EMClient 继承关系图:

构造函数
(void)	- addDelegate:delegateQueue:

(void)	- removeDelegate:

(void)	- addMultiDevicesDelegate:delegateQueue:

(void)	- removeMultiDevicesDelegate:

(EMError *)	- initializeSDKWithOptions:

(EMError *)	- changeAppkey:

(EMError *)	- registerWithUsername:password:

(void)	- registerWithUsername:password:completion:

(void)	- fetchTokenWithUsername:password:completion:

(EMError *)	- loginWithUsername:password:

(void)	- loginWithUsername:password:completion:

(EMError *)	- loginWithUsername:token:

(void)	- loginWithUsername:token:completion:

(EMError *)	- logout:

(void)	- logout:completion:

(EMError *)	- bindDeviceToken:

(void)	- registerForRemoteNotificationsWithDeviceToken:completion:

(EMError *)	- setApnsNickname:

(void)	- updatePushNotifiationDisplayName:completion:

(EMPushOptions *)	- getPushOptionsFromServerWithError:

(void)	- getPushNotificationOptionsFromServerWithCompletion:

(EMError *)	- updatePushOptionsToServer

(void)	- updatePushNotificationOptionsToServerWithCompletion:

(EMError *)	- uploadLogToServer

(void)	- uploadDebugLogToServerWithCompletion:

(NSString *)	- getLogFilesPath:

(void)	- getLogFilesPathWithCompletion:

(NSArray *)	- getLoggedInDevicesFromServerWithUsername:password:error:

(void)	- getLoggedInDevicesFromServerWithUsername:password:completion:

(EMError *)	- kickDeviceWithUsername:password:resource:

(void)	- kickDeviceWithUsername:password:resource:completion:

(EMError *)	- kickAllDevicesWithUsername:password:

(void)	- kickAllDevicesWithUsername:password:completion:

(BOOL)	- migrateDatabaseToLatestSDK

(void)	- applicationDidEnterBackground:

(void)	- applicationWillEnterForeground:

(void)	- application:didReceiveRemoteNotification:

(void)	- serviceCheckWithUsername:password:completion:

(void)	- addDelegate:

(void)	- asyncRegisterWithUsername:password:success:failure:

(void)	- asyncLoginWithUsername:password:success:failure:

(void)	- asyncLogout:success:failure:

(void)	- asyncBindDeviceToken:success:failure:

(void)	- asyncSetApnsNickname:success:failure:

(void)	- asyncGetPushOptionsFromServer:failure:

(void)	- asyncUpdatePushOptionsToServer:failure:

(void)	- asyncUploadLogToServer:failure:

("Use -migrateDatabaseToLatestSDK")	- __deprecated_msg

(EMError *)	- kickDevice:username:password:

(void)	- kickDevice:username:password:completion:

类方法
(instancetype)	+ sharedClient

Protected 属性
EMPushOptions *	_pushOptions

属性
NSString *	version

NSString *	currentUsername

EMOptions *	options

EMPushOptions *	pushOptions

id< IEMChatManager >	chatManager

id< IEMContactManager >	contactManager

id< IEMGroupManager >	groupManager

id< IEMChatroomManager >	roomManager

BOOL	isAutoLogin

BOOL	isLoggedIn

BOOL	isConnected

id< IEMCallManager >	callManager

id< IEMConferenceManager >	conferenceManager

详细描述

SDK Client

函数文档

◆ __deprecated_msg

- ("Use -migrateDatabaseToLatestSDK") __deprecated_msg

iOS专用，数据迁移到SDK3.0

同步方法，会阻塞当前线程

升级到SDK3.0版本需要调用该方法，开发者需要等该方法执行完后再进行数据库相关操作

返回: 是否迁移成功

◆ addDelegate:

- (void) addDelegate:	(3_1_0)
	(3_2_2)
	("Use -")	EM_DEPRECATED_IOS[IEMCallManager addDelegate:delegateQueue:]

添加回调代理

参数

aDelegate 要添加的代理

◆ addDelegate:delegateQueue:

- (void) addDelegate:	(id< EMClientDelegate >)	aDelegate
delegateQueue:	(dispatch_queue_t)	aQueue

添加回调代理

参数

aDelegate	要添加的代理
aQueue	执行代理方法的队列

◆ addMultiDevicesDelegate:delegateQueue:

- (void) addMultiDevicesDelegate:	(id< EMMultiDevicesDelegate >)	aDelegate
delegateQueue:	(dispatch_queue_t)	aQueue

注册多设备回调代理

参数

aDelegate	要添加的代理
aQueue	执行代理方法的队列

◆ application:didReceiveRemoteNotification:

- (void) application:	(id)	application
didReceiveRemoteNotification:	(NSDictionary *)	userInfo

iOS专用，程序在前台收到APNs时，需要调用此方法

参数

application	UIApplication
userInfo	推送内容

◆ applicationDidEnterBackground:

- (void) applicationDidEnterBackground: (id) aApplication

iOS专用，程序进入后台时，需要调用此方法断开连接

参数

aApplication UIApplication

◆ applicationWillEnterForeground:

- (void) applicationWillEnterForeground: (id) aApplication

iOS专用，程序进入前台时，需要调用此方法进行重连

参数

aApplication UIApplication

◆ asyncBindDeviceToken:success:failure:

- (void) asyncBindDeviceToken:	(NSData *)	aDeviceToken
success:	(void(^)())	aSuccessBlock
failure:	("Use -registerForRemoteNotificationsWithDeviceToken:completion:")	__deprecated_msg

绑定device token

参数

aDeviceToken	要绑定的token
aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncGetPushOptionsFromServer:failure:

- (void) asyncGetPushOptionsFromServer:	(void(^)(EMPushOptions *aOptions))	aSuccessBlock
failure:	("Use -getPushOptionsFromServerWithCompletion:")	__deprecated_msg

从服务器获取推送属性

参数

aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncLoginWithUsername:password:success:failure:

- (void) asyncLoginWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
success:	(void(^)())	aSuccessBlock
failure:	("Use -loginWithUsername:password:completion")	__deprecated_msg

登录

参数

aUsername	用户名
aPassword	密码
aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncLogout:success:failure:

- (void) asyncLogout:	(BOOL)	aIsUnbindDeviceToken
success:	(void(^)())	aSuccessBlock
failure:	("Use -logout:completion:")	__deprecated_msg

退出

参数

aIsUnbindDeviceToken 是否解除device token的绑定，解除绑定后设备不会再收到消息推送如果传入YES, 解除绑定失败，将返回error

返回: 错误信息

◆ asyncRegisterWithUsername:password:success:failure:

- (void) asyncRegisterWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
success:	(void(^)())	aSuccessBlock
failure:	("Use -registerWithUsername:password:completion:")	__deprecated_msg

注册用户

不推荐使用，建议后台通过REST注册

参数

aUsername	用户名
aPassword	密码
aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncSetApnsNickname:success:failure:

- (void) asyncSetApnsNickname:	(NSString *)	aNickname
success:	(void(^)())	aSuccessBlock
failure:	("Use -updatePushNotifiationDisplayName:copletion")	__deprecated_msg

设置推送消息显示的昵称

参数

aNickname	要设置的昵称
aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncUpdatePushOptionsToServer:failure:

- (void) asyncUpdatePushOptionsToServer:	(void(^)())	aSuccessBlock
failure:	("Use -updatePushNotificationOptionsToServerWithCompletion:")	__deprecated_msg

更新推送设置到服务器

参数

aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ asyncUploadLogToServer:failure:

- (void) asyncUploadLogToServer:	(void(^)())	aSuccessBlock
failure:	("Use -uploadDebugLogToServerWithCompletion:")	__deprecated_msg

上传日志到服务器

参数

aSuccessBlock	成功的回调
aFailureBlock	失败的回调

◆ bindDeviceToken:

- (EMError *) bindDeviceToken: (NSData *) aDeviceToken

绑定device token

同步方法，会阻塞当前线程

参数

aDeviceToken 要绑定的token

返回: 错误信息

◆ changeAppkey:

- (EMError *) changeAppkey: (NSString *) aAppkey

修改appkey，注意只有在未登录状态才能修改appkey

参数

aAppkey appkey

返回: 错误信息

◆ fetchTokenWithUsername:password:completion:

- (void) fetchTokenWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(NSString aToken, EMError aError))	aCompletionBlock

从服务器获取token

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ getLogFilesPath:

- (NSString *) getLogFilesPath: (EMError **) pError

将日志文件压缩成.gz文件，返回gz文件路径。强烈建议方法完成之后删除该压缩文件

同步方法，会阻塞当前线程

参数

pError 错误信息

返回: 文件路径

◆ getLogFilesPathWithCompletion:

- (void) getLogFilesPathWithCompletion: (void(^)(NSString *aPath, EMError *aError)) aCompletionBlock

将日志文件压缩成.gz文件，返回gz文件路径。强烈建议方法完成之后删除该压缩文件

参数

aCompletionBlock 完成的回调

◆ getLoggedInDevicesFromServerWithUsername:password:completion:

- (void) getLoggedInDevicesFromServerWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(NSArray aList, EMError aError))	aCompletionBlock

从服务器获取所有已经登录的设备信息

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ getLoggedInDevicesFromServerWithUsername:password:error:

- (NSArray *) getLoggedInDevicesFromServerWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
error:	(EMError **)	pError

从服务器获取所有已经登录的设备信息

同步方法，会阻塞当前线程

参数

aUsername	用户名
aPassword	密码
pError	错误信息

返回: 所有已经登录的设备信息<EMDeviceConfig>

◆ getPushNotificationOptionsFromServerWithCompletion:

- (void) getPushNotificationOptionsFromServerWithCompletion: (void(^)(EMPushOptions *aOptions, EMError *aError)) aCompletionBlock

从服务器获取推送属性

参数

aCompletionBlock 完成的回调

◆ getPushOptionsFromServerWithError:

- (EMPushOptions *) getPushOptionsFromServerWithError: (EMError **) pError

从服务器获取推送属性

同步方法，会阻塞当前线程

参数

pError 错误信息

返回: 推送属性

◆ initializeSDKWithOptions:

- (EMError *) initializeSDKWithOptions: (EMOptions *) aOptions

初始化sdk

参数

aOptions SDK配置项

返回: 错误信息

◆ kickAllDevicesWithUsername:password:

- (EMError *) kickAllDevicesWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword

强制所有的登录设备退出

同步方法，会阻塞当前线程

参数

aUsername	用户名
aPassword	密码

返回: 错误信息

◆ kickAllDevicesWithUsername:password:completion:

- (void) kickAllDevicesWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(EMError *aError))	aCompletionBlock

强制所有的登录设备退出

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ kickDevice:username:password:

- (EMError *) kickDevice:	(EMDeviceConfig *)	aDevice
username:	(NSString *)	aUsername
password:	("Use - kickDeviceWithUsername:password:resource:")	__deprecated_msg

强制指定的设备退出

同步方法，会阻塞当前线程

参数

aDevice	设备信息
aUsername	用户名
aPassword	密码

返回: 错误信息

◆ kickDevice:username:password:completion:

- (void) kickDevice:	(EMDeviceConfig *)	aDevice
username:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	("Use - kickDeviceWithUsername:password:resource:completion:")	__deprecated_msg

强制指定的设备退出

参数

aDevice	设备信息
aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ kickDeviceWithUsername:password:resource:

- (EMError *) kickDeviceWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
resource:	(NSString *)	aResource

强制指定的设备退出

同步方法，会阻塞当前线程

参数

aUsername	用户名
aPassword	密码
aDevice	设备信息

返回: 错误信息

◆ kickDeviceWithUsername:password:resource:completion:

- (void) kickDeviceWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
resource:	(NSString *)	aResource
completion:	(void(^)(EMError *aError))	aCompletionBlock

强制指定的设备退出

参数

aUsername	用户名
aPassword	密码
aDevice	设备信息
aCompletionBlock	完成的回调

◆ loginWithUsername:password:

- (EMError *) loginWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword

密码登录

同步方法，会阻塞当前线程

参数

aUsername	用户名
aPassword	密码

返回: 错误信息

◆ loginWithUsername:password:completion:

- (void) loginWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(NSString aUsername, EMError aError))	aCompletionBlock

密码登录

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ loginWithUsername:token:

- (EMError *) loginWithUsername:	(NSString *)	aUsername
token:	(NSString *)	aToken

token登录，不支持自动登录

同步方法，会阻塞当前线程

参数

aUsername	用户名
aToken	Token

返回: 错误信息

◆ loginWithUsername:token:completion:

- (void) loginWithUsername:	(NSString *)	aUsername
token:	(NSString *)	aToken
completion:	(void(^)(NSString aUsername, EMError aError))	aCompletionBlock

token登录，不支持自动登录

参数

aUsername	用户名
aToken	Token
aCompletionBlock	完成的回调

◆ logout:

- (EMError *) logout: (BOOL) aIsUnbindDeviceToken

退出

同步方法，会阻塞当前线程

参数

aIsUnbindDeviceToken 是否解除device token的绑定，解除绑定后设备不会再收到消息推送如果传入YES, 解除绑定失败，将返回error

返回: 错误信息

◆ logout:completion:

- (void) logout:	(BOOL)	aIsUnbindDeviceToken
completion:	(void(^)(EMError *aError))	aCompletionBlock

退出

参数

aIsUnbindDeviceToken	是否解除device token的绑定，解除绑定后设备不会再收到消息推送如果传入YES, 解除绑定失败，将返回error
aCompletionBlock	完成的回调

◆ migrateDatabaseToLatestSDK

- (BOOL) migrateDatabaseToLatestSDK

iOS专用，数据迁移到SDK3.0

同步方法，会阻塞当前线程

升级到SDK3.0版本需要调用该方法，开发者需要等该方法执行完后再进行数据库相关操作

返回: 是否迁移成功

◆ registerForRemoteNotificationsWithDeviceToken:completion:

- (void) registerForRemoteNotificationsWithDeviceToken:	(NSData *)	aDeviceToken
completion:	(void(^)(EMError *aError))	aCompletionBlock

绑定device token

参数

aDeviceToken	要绑定的token
aCompletionBlock	完成的回调

◆ registerWithUsername:password:

- (EMError *) registerWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword

注册用户

同步方法，会阻塞当前线程. 不推荐使用，建议后台通过REST注册

参数

aUsername	用户名
aPassword	密码

返回: 错误信息

◆ registerWithUsername:password:completion:

- (void) registerWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(NSString aUsername, EMError aError))	aCompletionBlock

注册用户

不推荐使用，建议后台通过REST注册

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ removeDelegate:

- (void) removeDelegate: (id) aDelegate

移除回调代理

参数

aDelegate 要移除的代理

◆ removeMultiDevicesDelegate:

- (void) removeMultiDevicesDelegate: (id< EMMultiDevicesDelegate >) aDelegate

移除多设备回调代理

参数

aDelegate 要移除的代理

◆ serviceCheckWithUsername:password:completion:

- (void) serviceCheckWithUsername:	(NSString *)	aUsername
password:	(NSString *)	aPassword
completion:	(void(^)(EMServerCheckType aType, EMError *aError))	aCompletionBlock

服务诊断接口，根据EMServerCheckType枚举的顺序依次诊断当前服务，并回调给开发者如果已经登录，默认使用登录账号

参数

aUsername	用户名
aPassword	密码
aCompletionBlock	完成的回调

◆ setApnsNickname:

- (EMError *) setApnsNickname: (NSString *) aNickname

设置推送消息显示的昵称

同步方法，会阻塞当前线程

参数

aNickname 要设置的昵称

返回: 错误信息

◆ sharedClient

+ (instancetype) sharedClient

获取SDK实例

◆ updatePushNotifiationDisplayName:completion:

- (void) updatePushNotifiationDisplayName:	(NSString *)	aDisplayName
completion:	(void(^)(NSString aDisplayName, EMError aError))	aCompletionBlock

设置推送的显示名

参数

aDisplayName	推送显示名
aCompletionBlock	完成的回调

◆ updatePushNotificationOptionsToServerWithCompletion:

- (void) updatePushNotificationOptionsToServerWithCompletion: (void(^)(EMError *aError)) aCompletionBlock

更新推送设置到服务器

参数

aCompletionBlock 完成的回调

◆ updatePushOptionsToServer

- (EMError *) updatePushOptionsToServer

更新推送设置到服务器

同步方法，会阻塞当前线程

返回: 错误信息

◆ uploadDebugLogToServerWithCompletion:

- (void) uploadDebugLogToServerWithCompletion: (void(^)(EMError *aError)) aCompletionBlock

上传日志到服务器

参数

aCompletionBlock 完成的回调

◆ uploadLogToServer

- (EMError *) uploadLogToServer

上传日志到服务器

同步方法，会阻塞当前线程

返回: 错误信息

属性说明

◆ callManager

- (id<IEMCallManager>) callManager

readnonatomicstrong

实时通讯模块

由 category EMClient(Call) 提供.

◆ chatManager

- (id<IEMChatManager>) chatManager

readnonatomicstrong

聊天模块

◆ conferenceManager

- (id<IEMConferenceManager>) conferenceManager

readnonatomicstrong

多人会议模块

由 category EMClient(Conference) 提供.

◆ contactManager

- (id<IEMContactManager>) contactManager

readnonatomicstrong

好友模块

◆ currentUsername

- (NSString*) currentUsername

readnonatomicstrong

当前登录账号

◆ groupManager

- (id<IEMGroupManager>) groupManager

readnonatomicstrong

群组模块

◆ isAutoLogin

- (BOOL) isAutoLogin

readnonatomicassign

SDK是否自动登录上次登录的账号

◆ isConnected

- (BOOL) isConnected

readnonatomicassign

是否连上聊天服务器

◆ isLoggedIn

- (BOOL) isLoggedIn

readnonatomicassign

用户是否已登录

◆ options

- (EMOptions*) options

readnonatomicstrong

SDK属性

◆ pushOptions

- (EMPushOptions*) pushOptions

readnonatomicstrong

推送设置

◆ roomManager

- (id<IEMChatroomManager>) roomManager

readnonatomicstrong

聊天室模块

◆ version

- (NSString*) version

readnonatomicstrong

SDK版本号

该类的文档由以下文件生成:

EMClient.h

构造函数

类方法

Protected 属性

属性

详细描述

函数文档

◆ __deprecated_msg

◆ addDelegate:

◆ addDelegate:delegateQueue:

◆ addMultiDevicesDelegate:delegateQueue:

◆ application:didReceiveRemoteNotification:

◆ applicationDidEnterBackground:

◆ applicationWillEnterForeground:

◆ asyncBindDeviceToken:success:failure:

◆ asyncGetPushOptionsFromServer:failure:

◆ asyncLoginWithUsername:password:success:failure:

◆ asyncLogout:success:failure:

◆ asyncRegisterWithUsername:password:success:failure:

◆ asyncSetApnsNickname:success:failure:

◆ asyncUpdatePushOptionsToServer:failure:

◆ asyncUploadLogToServer:failure:

◆ bindDeviceToken:

◆ changeAppkey:

◆ fetchTokenWithUsername:password:completion:

◆ getLogFilesPath:

◆ getLogFilesPathWithCompletion:

◆ getLoggedInDevicesFromServerWithUsername:password:completion:

◆ getLoggedInDevicesFromServerWithUsername:password:error:

◆ getPushNotificationOptionsFromServerWithCompletion:

◆ getPushOptionsFromServerWithError:

◆ initializeSDKWithOptions:

◆ kickAllDevicesWithUsername:password:

◆ kickAllDevicesWithUsername:password:completion:

◆ kickDevice:username:password:

◆ kickDevice:username:password:completion:

◆ kickDeviceWithUsername:password:resource:

◆ kickDeviceWithUsername:password:resource:completion:

◆ loginWithUsername:password:

◆ loginWithUsername:password:completion:

◆ loginWithUsername:token:

◆ loginWithUsername:token:completion:

◆ logout:

◆ logout:completion:

◆ migrateDatabaseToLatestSDK

◆ registerForRemoteNotificationsWithDeviceToken:completion:

◆ registerWithUsername:password:

◆ registerWithUsername:password:completion:

◆ removeDelegate:

◆ removeMultiDevicesDelegate:

◆ serviceCheckWithUsername:password:completion:

◆ setApnsNickname:

◆ sharedClient

◆ updatePushNotifiationDisplayName:completion:

◆ updatePushNotificationOptionsToServerWithCompletion:

◆ updatePushOptionsToServer

◆ uploadDebugLogToServerWithCompletion:

◆ uploadLogToServer

属性说明

◆ callManager

◆ chatManager

◆ conferenceManager

◆ contactManager

◆ currentUsername

◆ groupManager

◆ isAutoLogin

◆ isConnected

◆ isLoggedIn

◆ options

◆ pushOptions

◆ roomManager

◆ version