iOS 环信3.2集成单聊教程

第一次集成环信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,完了,到点了吃中饭去了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349

推荐阅读更多精彩内容