iOS 环信3.2集成单聊教程

2017-01-14 10:06:35来源:http://www.jianshu.com/p/81a788675c70作者:喵喵i人点击

第七城市

第一次集成环信SDK应该是在去年吧,那个时候还是2.0的版本,没想到后面做的几个APP都用到了环信的及时聊天,用过2.0、3.0、3.1的,现在到了3.2的版本了。这篇博客水平并不是很深,只是作为刚接触环信的小伙伴一个参考的文章而已,让你们少走点弯路,但是该跳的坑还是需要自己亲自去跳。

前言

1、本教程对应环信即时聊天 iOS SDK V3.2.0 (2016-10-15)

2、请自行注册好环信APP_ID和APP_KEY

3、请自行下载好环信即时聊天SDK对应的版本(iOS SDK V3.2.0)

一、集成环信SDK

1、导入SDK

下载SDK到本地,进行解压,包含以下几个文件。



如果你的项目中需要用到语音电话和语音视频请把HyphenateFullSDK拖入你的工程;

如果你的项目中只不需要语音电话和语音视频请把HyphenateSDK拖入你的工程;

这个两个只需要拖入一个,区别就是一个包含语音电话、视频,一个不不含,其他的都是一样的。

2、添加对应的依赖库

(1) 在 Build Phases -> Link Binary With Libraries 添加以下依赖库:

CoreMedia.framework

AudioToolbox.framework

AVFoundation.framework

MobileCoreServices.framework

ImageIO.framework

libc++.tbd

libz.tbd

libstdc++.6.0.9.tbd

libsqlite3.tbd

libiconv.tbd

如果你选择的是不包含语音电话、视频的SDK,最后一个依赖库(libiconv.tbd)不需添加。

(2) SDK 不支持 bitcode,向 Build Settings → Linking → Enable Bitcode 中设置 NO。



3、登录环信

在AppDelegate.m 中添加欢喜初始化和登录的代码,如果编译成功,则说明你导入SDK成功了。

#define EaseMob_Appkey    @"1101#testnickname"  //环信AppKey#import "AppDelegate.h"#import "EMSDK.h"@interface AppDelegate ()@end@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    //AppKey:注册的AppKey,详细见下面注释。    //apnsCertName:推送证书名(不需要加后缀),详细见下面注释。    EMOptions *options =[EMOptions optionsWithAppkey:EaseMob_Appkey];    options.apnsCertName = @"";[[EMClient sharedClient] initializeSDKWithOptions:options];    EMError *error =[[EMClient sharedClient] loginWithUsername:@"yuancan001" password:@"123456"];    if (!error) {        NSLog(@"登录成功");    }    return YES;}

提醒:记得在plist文件中设置https请求喔

4、添加EaseUI文件 要想实现环信的及时聊天,只加入SDK是不够的,还需要添加其他的一些相关的文件。回到我们之前下载环信SDK的文件中,有一个EaseUI的文件,把这个文件加入你的工程中。



这个文件夹中包含了一些与聊天相关的类,比如说聊天的界面、聊天的键盘等,总之是为了帮助开发者快速实现聊天功能。 编译一下,结果编译失败,因为还需要做一步操作,添加pch文件的路径。



EaseUI目录下有一个pch文件,你把它的路径添加到Prefix Header中。怎么添加呢?最简单的办法,就是先选择EaseUI-Prefix.pch文件,然后按住它,把它拖过去。不过这个要看人品,人品好一次就可以拖成功,如果没有拖成功,就多试几次。要是人品太差,就只能手动添加了

$(SRCROOT)/EaseMob3.2/EaseMob/EaseUI/EaseUI-Prefix.pch

$(SRCROOT):这是一个宏,代表你这个项目文件的相对路径;

EaseMob3.2:这个是我的工程名,需要替换成你自己的工程名;

EaseMob/EaseUI/EaseUI-Prefix.pch:这个是pch文件在工程中的相对路径,需要替换成你自己对应的.

再编译一下,就可以成功了。

二、实现单聊

集成环信SDK,我们已经完成了第一步工作,接着我们来实现一下聊天的功能。

1、添加与聊天相关的文件

环信官方提供的Demo中集成了所有的功能,对于开发者来说既是一件好事也是一件坏事。之所以说是好事是因为所有功能都有,之所以说坏事是因为功能太多,都杂糅在一起,对于新手来说却是感觉无从下手。下面,就随我一起慢慢来深入了解环信。

实现单聊还需要添加一些文件,这些文件我们可以从官方的Demo中拷贝过来。我们需要添加的文件叫做 Chat,Chat目录下包含两个文件夹。ChatList里面的东西是与回话列表相关的,ChatView里面的东西是与聊天界面相关的 , 把Chat整个文件夹都拖入工程中。编译之后,你会发现会出现很多报错的,不要怀疑你自己,这是正常的。因为这些文件是从环信官方Demo中拷贝过来,里面用了很多其他的文件,但是我们不需要那些文件,没有添加到我们的工程中,所以会报错。其实,这几个步骤很关键,但是官方文档却没有说明,估计把新手坑死了,幸亏有小编来拯救你们,哈哈。这里好心的小编提供一个已经处理好的下载Chat文件,下载可以直接使用。不然,你就需要自己手动去注释一些报错的地方,知道编译成功。



2、修改pch文件

在我们之前用的那个EaseUI-Prefix.pch中添加一些头文件:

#ifdef __OBJC__

#import

#import

//#import "ChatDemoUIDefine.h"

//#import "EMAlertView.h"

//#import "TTGlobalUICommon.h"

#import "EMSDKFull.h"

#import "EaseUI.h"

#endif

3、测试单聊

(1) 在AppDelegate.m 中创建一个UINavigationController :

#define EaseMob_Appkey    @"1101#testnickname"  //环信AppKey#import "AppDelegate.h"#import "EMSDK.h"#import "ViewController.h"@interface AppDelegate ()@end@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    //AppKey:注册的AppKey,详细见下面注释。    //apnsCertName:推送证书名(不需要加后缀),详细见下面注释。    EMOptions *options =[EMOptions optionsWithAppkey:EaseMob_Appkey];    options.apnsCertName = @"";[[EMClient sharedClient] initializeSDKWithOptions:options];    EMError *error =[[EMClient sharedClient] loginWithUsername:@"yuancan001" password:@"123456"];    if (!error) {        NSLog(@"登录成功");    }    ViewController *vc =[[ViewController alloc] init];    UINavigationController *navigation =[[UINavigationController alloc] initWithRootViewController:vc];    self.window.rootViewController = navigation;    self.window.backgroundColor =[UIColor whiteColor];    return YES;}



OK,完了,到点了吃中饭去了。




第七城市

最新文章

123

最新摄影

微信扫一扫

第七城市微信公众平台