iOS 环信3.2集成 (一)基本使用
来源:互联网 发布:骂人 知乎 编辑:程序博客网 时间:2024/06/05 02:24
前言
1、本教程对应环信即时聊天 iOS SDK V3.2.0 (2016-10-15)
2、请自行注册好环信APP_ID和APP_KEY
3、请自行下载好环信即时聊天SDK对应的版本(easemob.com/download”>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 <UIKit/UIKit.h>#import <Foundation/Foundation.h>//#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;}
2、在ViewController.m 中添加测试代码:
#import "ViewController.h"#import "ChatViewController.h"@interface ViewController ()@end@implementation ViewController- (void)viewDidLoad { [super viewDidLoad]; UIButton *chat = [[UIButton alloc] initWithFrame:CGRectMake(10, 100, self.view.frame.size.width-20, 40)]; [chat setTitle:@"开始单聊" forState:UIControlStateNormal]; [chat setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal]; [chat setBackgroundColor:[UIColor orangeColor]]; [chat addTarget:self action:@selector(btnClick) forControlEvents:UIControlEventTouchUpInside]; chat.layer.cornerRadius = 5.0f; chat.layer.masksToBounds = YES; [self.view addSubview:chat];}- (void)btnClick{ ChatViewController *chatVC = [[ChatViewController alloc] initWithConversationChatter:@"yuancan002" conversationType:EMConversationTypeChat]; chatVC.title = @"一对一聊天"; [self.navigationController pushViewController:chatVC animated:YES];}@end
效果图
其实,选对了方法,是不是很简单。
- iOS 环信3.2集成 (一)基本使用
- iOS 集成环信(一)
- iOS环信3.0集成 (一)SDK的集成
- iOS环信3.0集成 (一)SDK的集成
- iOS环信3.0集成 (一)SDK的集成
- iOS-集成环信
- iOS集成环信客服
- iOS环信集成<1>
- iOS - IM环信集成
- iOS环信集成心得
- iOS集成环信SDK(一)——关于集成的几点建议
- iOS 环信集成方法之集成环信SDK
- iOS推送详解(一)基本集成操作
- 环信即时通讯的基本集成
- iOS 环信3.2集成单聊教程
- iOS - 集成环信聊天界面
- iOS 环信UI集成步骤
- iOS 集成环信(三) 添加好友
- 优秀设计师应当知道的几大UI设计原则(一)
- 项目截图
- 正则表达式的三种模式【贪婪、勉强、侵占】的分析
- TypeScript 强制类型转换和类型判断 typeof,instanceof
- java8 HashMap解析
- iOS 环信3.2集成 (一)基本使用
- yii框架基本增删改查分页操作
- 【腾讯Bugly干货分享】Android ListView与RecyclerView对比浅析--缓存机制
- Java注解
- activeMQ 与 php的结合使用
- 无需破解:Windows Server 2008 R2 至少免费使用 900天
- Java-获取系统的环境变量
- ora-16038
- hihocoder #24 Rikka with Subsequence