快速入門（五分鐘執行環信demo)

下載環信demo (iOS)

什麼是環信demo

環信demo展示了怎樣使用環信SDK快速建立一個完整的類微信聊天APP。展示的功能包括：環信SDK初始化，登入，登出，註冊訊息接收listener, 傳送訊息。

環信demo原始碼已在github上開源供開發者下載，以幫助開發者更好的學習瞭解環信SDK。

下載環信demo

1. 下載環信Demo及SDK： 下載

2. 解壓縮iOSSDK.zip後會得到以下目錄結構：

執行環信demo (iOS)

在模擬器中執行chatdemo-nonui工程。

執行chatdemo-nonui:

點選“傳送文字訊息”，會發送訊息給測試機器人（其賬號為”bot”）。該測試機器人接收到訊息後會把接收的訊息原封不動的自動傳送回來，顯示如下圖。

快速整合

下載EaseMobSDK:

下載EaseMobSDK 下載連結

將EaseMobSDK拖入到專案中

SDK依賴庫

UIDemo依賴庫

設定Linker

向Other Linker Flags 中新增 -ObjC。(如果已有，則不需要再新增)

設定Architectures

初始化EaseMobSDK

在AppDelegate中註冊SDK

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary 	*)launchOptions
 

{
	self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
	self.window.backgroundColor = [UIColor whiteColor];

	// 真機的情況下,notification提醒設定
	UIRemoteNotificationType notificationTypes = UIRemoteNotificationTypeBadge |
	UIRemoteNotificationTypeSound |
	UIRemoteNotificationTypeAlert
 
;
	[[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes];

	//註冊 APNS檔案的名字, 需要與後臺上傳證書時的名字一一對應
	NSString *apnsCertName = @"chatdemo";
	[[EaseMob sharedInstance] registerSDKWithAppKey:@"easemob-demo#chatdemo" apnsCertName:apnsCertName];
	[[EaseMob sharedInstance] enableBackgroundReceiveMessage];
	[[EaseMob sharedInstance] application:application didFinishLaunchingWithOptions:launchOptions];

	[self.window makeKeyAndVisible];
	return YES;
}

關於EASEMOB_APPKEY，請登入或註冊[環信開發者後臺(https://console.easemob.com),申請APPKEY後，進行相關配置。

從原始碼級別深入瞭解環信demo (iOS)

深入理解環信demo背後的程式碼

註冊listener,以接收聊天訊息:RootViewController.m

    [[EaseMob sharedInstance].chatManager addDelegate:self
                                        delegateQueue:nil];

登入：見RandViewController+Login

    [[EaseMob sharedInstance].chatManager asyncLoginWithUsername:username
                                                        password:@"123456"
                                                      completion:
     ^(NSDictionary *loginInfo, EMError *error) {
         if (!error) {
             NSLog(@"登入成功");         
         }
     } onQueue:nil];

退出登入：見RandViewController+Login.m

	[[EaseMob sharedInstance].chatManager asyncLogoff];

傳送訊息：見RootViewController+sendChat.m

	EMChatText *text = [[EMChatText alloc] initWithText:message];
    EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:text];
    
    EMMessage *msg = [[EMMessage alloc]
                      initWithReceiver:@"bot"
                      bodies:[NSArray arrayWithObject:body]];
    
    [[EaseMob sharedInstance].chatManager sendMessage:msg
                                             progress:nil
                                                error:nil];

接收聊天訊息並顯示：見RootViewController.m

	-(void)didReceiveMessage:(EMMessage *)message {
    	id body = [message.messageBodies firstObject];
		if (body.messageBodyType == eMessageBodyType_Text) {
			NSString *msg = ((EMTextMessageBody *)body).text;
			NSLog(@"收到的訊息---%@",msg);
	    }
	}