5分钟集成即时通讯功能——ios版

快速入门（五分钟运行环信demo)

下载环信demo (iOS)

什么是环信demo

环信demo展示了怎样使用环信SDK快速创建一个完整的类微信聊天APP。展示的功能包括：环信SDK初始化，登录，登出，注册消息接收listener, 发送消息。

环信demo源代码已在github上开源供开发者下载，以帮助开发者更好的学习了解环信SDK。

下载环信demo

1. 下载环信Demo及SDK： 下载

2. 解压缩iOSSDK.zip后会得到以下目录结构：

运行环信demo (iOS)

在模拟器中运行chatdemo-nonui工程。

或者使用手机上的Safari浏览器访问 www.easemob.com/downloads/chatdemo.html直接安装

运行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);
	    }
	}