EMClient.h

 
#import <Foundation/Foundation.h>
 
#import "EMClientDelegate.h"
#import "EMMultiDevicesDelegate.h"
#import "EMOptions.h"
#import "EMPushOptions.h"
#import "EMError.h"
 
#import "IEMChatManager.h"
#import "IEMContactManager.h"
#import "IEMGroupManager.h"
#import "IEMChatroomManager.h"
 
#import "EMDeviceConfig.h"
 
typedef enum {
    EMServerCheckAccountValidation = 0,     
    EMServerCheckGetDNSListFromServer,      
    EMServerCheckGetTokenFromServer,        
    EMServerCheckDoLogin,                   
    EMServerCheckDoLogout,                  
} EMServerCheckType;
 
@interface EMClient : NSObject
{
    EMPushOptions *_pushOptions;
}
 
@property (nonatomic, strong, readonly) NSString *version;
 
@property (nonatomic, strong, readonly) NSString *currentUsername;
 
@property (nonatomic, strong, readonly) EMOptions *options;
 
@property (nonatomic, strong, readonly) EMPushOptions *pushOptions;
 
@property (nonatomic, strong, readonly) id<IEMChatManager> chatManager;
 
@property (nonatomic, strong, readonly) id<IEMContactManager> contactManager;
 
@property (nonatomic, strong, readonly) id<IEMGroupManager> groupManager;
 
@property (nonatomic, strong, readonly) id<IEMChatroomManager> roomManager;
 
@property (nonatomic, readonly) BOOL isAutoLogin;
 
@property (nonatomic, readonly) BOOL isLoggedIn;
 
@property (nonatomic, readonly) BOOL isConnected;
 
+ (instancetype)sharedClient;
 
 
#pragma mark - Delegate
 
- (void)addDelegate:(id<EMClientDelegate>)aDelegate
      delegateQueue:(dispatch_queue_t)aQueue;
 
- (void)removeDelegate:(id)aDelegate;
 
- (void)addMultiDevicesDelegate:(id<EMMultiDevicesDelegate>)aDelegate
                  delegateQueue:(dispatch_queue_t)aQueue;
 
- (void)removeMultiDevicesDelegate:(id<EMMultiDevicesDelegate>)aDelegate;
 
#pragma mark - Initialize SDK
 
- (EMError *)initializeSDKWithOptions:(EMOptions *)aOptions;
 
 
#pragma mark - Change AppKey
 
- (EMError *)changeAppkey:(NSString *)aAppkey;
 
 
#pragma mark - User Registeration
 
- (EMError *)registerWithUsername:(NSString *)aUsername
                         password:(NSString *)aPassword;
 
- (void)registerWithUsername:(NSString *)aUsername
                    password:(NSString *)aPassword
                  completion:(void (^)(NSString *aUsername, EMError *aError))aCompletionBlock;
 
 
#pragma mark - Login
 
- (void)fetchTokenWithUsername:(NSString *)aUsername
                      password:(NSString *)aPassword
                    completion:(void (^)(NSString *aToken, EMError *aError))aCompletionBlock;
 
- (EMError *)loginWithUsername:(NSString *)aUsername
                      password:(NSString *)aPassword;
 
- (void)loginWithUsername:(NSString *)aUsername
                 password:(NSString *)aPassword
               completion:(void (^)(NSString *aUsername, EMError *aError))aCompletionBlock;
 
- (EMError *)loginWithUsername:(NSString *)aUsername
                         token:(NSString *)aToken;
 
- (void)loginWithUsername:(NSString *)aUsername
                    token:(NSString *)aToken
               completion:(void (^)(NSString *aUsername, EMError *aError))aCompletionBlock;
 
#pragma mark - Logout
 
- (EMError *)logout:(BOOL)aIsUnbindDeviceToken;
 
- (void)logout:(BOOL)aIsUnbindDeviceToken
    completion:(void (^)(EMError *aError))aCompletionBlock;
 
#pragma mark - APNs
 
- (EMError *)bindDeviceToken:(NSData *)aDeviceToken;
 
- (void)registerForRemoteNotificationsWithDeviceToken:(NSData *)aDeviceToken
                                           completion:(void (^)(EMError *aError))aCompletionBlock;
 
- (EMError *)setApnsNickname:(NSString *)aNickname;
 
- (void)updatePushNotifiationDisplayName:(NSString *)aDisplayName
                              completion:(void (^)(NSString *aDisplayName, EMError *aError))aCompletionBlock;
 
- (EMPushOptions *)getPushOptionsFromServerWithError:(EMError **)pError;
 
- (void)getPushNotificationOptionsFromServerWithCompletion:(void (^)(EMPushOptions *aOptions, EMError *aError))aCompletionBlock;
 
- (EMError *)updatePushOptionsToServer;
 
- (void)updatePushNotificationOptionsToServerWithCompletion:(void (^)(EMError *aError))aCompletionBlock;
 
#pragma mark - Log
 
- (EMError *)uploadLogToServer;
 
- (void)uploadDebugLogToServerWithCompletion:(void (^)(EMError *aError))aCompletionBlock;
 
- (NSString *)getLogFilesPath:(EMError **)pError;
 
- (void)getLogFilesPathWithCompletion:(void (^)(NSString *aPath, EMError *aError))aCompletionBlock;
 
#pragma mark - Multi Devices
 
- (NSArray *)getLoggedInDevicesFromServerWithUsername:(NSString *)aUsername
                                             password:(NSString *)aPassword
                                                error:(EMError **)pError;
 
- (void)getLoggedInDevicesFromServerWithUsername:(NSString *)aUsername
                                        password:(NSString *)aPassword
                                      completion:(void (^)(NSArray *aList, EMError *aError))aCompletionBlock;
 
- (EMError *)kickDeviceWithUsername:(NSString *)aUsername
                           password:(NSString *)aPassword
                           resource:(NSString *)aResource;
 
 
 
- (void)kickDeviceWithUsername:(NSString *)aUsername
                      password:(NSString *)aPassword
                      resource:(NSString *)aResource
                    completion:(void (^)(EMError *aError))aCompletionBlock;
 
- (EMError *)kickAllDevicesWithUsername:(NSString *)aUsername
                               password:(NSString *)aPassword;
 
- (void)kickAllDevicesWithUsername:(NSString *)aUsername
                          password:(NSString *)aPassword
                        completion:(void (^)(EMError *aError))aCompletionBlock;
 
#pragma mark - iOS
 
- (BOOL)migrateDatabaseToLatestSDK;
 
- (void)applicationDidEnterBackground:(id)aApplication;
 
- (void)applicationWillEnterForeground:(id)aApplication;
 
- (void)application:(id)application didReceiveRemoteNotification:(NSDictionary *)userInfo;
 
#pragma mark - Service Check
 
- (void)serviceCheckWithUsername:(NSString *)aUsername
                        password:(NSString *)aPassword
                      completion:(void (^)(EMServerCheckType aType, EMError *aError))aCompletionBlock;
 
#pragma mark - EM_DEPRECATED_IOS 3.2.3
 
- (void)addDelegate:(id<EMClientDelegate>)aDelegate EM_DEPRECATED_IOS(3_1_0, 3_2_2, "Use -[IEMCallManager addDelegate:delegateQueue:]");
 
#pragma mark - EM_DEPRECATED_IOS < 3.2.3
 
- (void)asyncRegisterWithUsername:(NSString *)aUsername
                         password:(NSString *)aPassword
                          success:(void (^)())aSuccessBlock
                          failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -registerWithUsername:password:completion:");
 
- (void)asyncLoginWithUsername:(NSString *)aUsername
                      password:(NSString *)aPassword
                       success:(void (^)())aSuccessBlock
                       failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -loginWithUsername:password:completion");
 
- (void)asyncLogout:(BOOL)aIsUnbindDeviceToken
            success:(void (^)())aSuccessBlock
            failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -logout:completion:");
 
- (void)asyncBindDeviceToken:(NSData *)aDeviceToken
                     success:(void (^)())aSuccessBlock
                     failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -registerForRemoteNotificationsWithDeviceToken:completion:");
 
- (void)asyncSetApnsNickname:(NSString *)aNickname
                     success:(void (^)())aSuccessBlock
                     failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -updatePushNotifiationDisplayName:copletion");
 
- (void)asyncGetPushOptionsFromServer:(void (^)(EMPushOptions *aOptions))aSuccessBlock
                              failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -getPushOptionsFromServerWithCompletion:");
 
- (void)asyncUpdatePushOptionsToServer:(void (^)())aSuccessBlock
                               failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -updatePushNotificationOptionsToServerWithCompletion:");
 
- (void)asyncUploadLogToServer:(void (^)())aSuccessBlock
                       failure:(void (^)(EMError *aError))aFailureBlock __deprecated_msg("Use -uploadDebugLogToServerWithCompletion:");
 
- (BOOL)dataMigrationTo3 __deprecated_msg("Use -migrateDatabaseToLatestSDK");
 
 
- (EMError *)kickDevice:(EMDeviceConfig *)aDevice
               username:(NSString *)aUsername
               password:(NSString *)aPassword __deprecated_msg("Use - kickDeviceWithUsername:password:resource:");
 
 
- (void)kickDevice:(EMDeviceConfig *)aDevice
          username:(NSString *)aUsername
          password:(NSString *)aPassword
        completion:(void (^)(EMError *aError))aCompletionBlock __deprecated_msg("Use - kickDeviceWithUsername:password:resource:completion:");
@end