iOS环信3.1·集成·功能的实现
-
SDK集成
1.准备工作：
·此处假设你已经申请过环信的开发者账号。
·此处假设你已经在Apple开发者中心配置好证书，并上传至环信。
·如果你不需要离线消息的推送功能，可以不必配置证书。
·从环信官网下载好的最新SDK，解压缩到一易找的地方。
2.将ios_IM_sdk_V3.1.5文件夹中的HyphenateFullSDK文件夹拷贝到你的工程目录文件夹下。
Paste_Image.png
3.打开Xcode，按下快捷键：Alt+Command+A，将
HyphenateFullSDK添加到工程目录里。
Paste_Image.png
4.将
HyphenateFullSDK目录下的
include中的
EMSDK.h中的代码注释掉一部分：
Paste_Image.png
5.将
HyphenateFullSDK目录下的
include中的
EMSDKFull.h中的代码注释掉一部分：
Paste_Image.png
6.点
Build Phases →
Link Binary With Libraries，添加依赖库
SDK 包含实时语音依赖库有：
CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.dylib
libz.dylib
libstdc++.6.0.9.dylib
libsqlite3.dylib
libiconv.dylib
**（如果使用的是 xcode7，后缀为 tbd。）**
Paste_Image.png
7.将
ios_IM_sdk_V3.1.5文件夹中的
EaseUI文件夹
拷贝到你的
工程目录文件夹下。
Paste_Image.png
8.打开Xcode，按下快捷键：Alt+Command+A，将
EaseUI添加到工程目录里。
Paste_Image.png
9.在你的
XXX.pch头文件的首尾部分，加入两行代码：
Paste_Image.png
//另，注意：必须引入这两个系统库。否则会报错。
#import <UIKit/UIKit.h>
#import <Foundation/Foundation.h>
错误是这样：
Paste_Image.png
10.可能存在的
Error·
需要解决：
环信中有MJRefresh，若你的工程中也引入了MJRefresh，请自行删除你的或者环信EaseUI中的MJRefresh任一即可。
当然，前提是，保证你的MJRefresh是最新的
环信中有SDWebImage库，所以，如果你有用到SDWebImage库，请自行删除你引入的SDWebImage。
当然，你可以选择不删除。但是，要做一点简单的操作。
只需在XXX.pch中删除之前的引用#import "UIImage+WebCache"，换成引用#import "UIImage+EMWebCache"
11.集成的结尾，说明部分：
经过上面一系列的修改以及添加库。此时，需要测试一下。
按下快捷键：Command+B，编译应该会无误通过。
-
功能实现
包含：位置发送、语音发送、图片发送、拍照发送、语音通讯、视频通讯
1.引入环信官方Demo中的:ChatViewController.h、ChatViewController.m
注释掉ChatViewController.m如下代码部分，解决Error：
简单来讲，就是注释掉红色警告行的代码即可。
//#import "ChatGroupDetailViewController.h"
//#import "ChatroomDetailViewController.h"
//#import "UserProfileViewController.h"
//#import "UserProfileManager.h"
//#import "ContactListSelectViewController.h"
//#import "ChatDemoHelper.h"
//#import "EMChooseViewController.h"
//#import "ContactSelectionViewController.h"
//if (ext && ext[kHaveUnreadAtMessage] != nil)
// {
// NSMutableDictionary *newExt = [ext mutableCopy];
// [newExt removeObjectForKey:kHaveUnreadAtMessage];
// self.conversation.ext = newExt;
// }
//UserProfileViewController *userprofile = [[UserProfileViewController alloc] initWithUsername:messageModel.message.from];
//[self.navigationController pushViewController:userprofile animated:YES];
//ContactSelectionViewController *selectController = [[ContactSelectionViewController alloc] initWithContacts:members];
//selectController.mulChoice = NO;
//selectController.delegate = self;
//[self.navigationController pushViewController:selectController animated:YES];
//ContactSelectionViewController *selectController = [[ContactSelectionViewController alloc] initWithContacts:members];
//selectController.mulChoice = NO;
//selectController.delegate = self;
//[self.navigationController pushViewController:selectController animated:YES];
//UserProfileEntity *profileEntity = [[UserProfileManager sharedInstance] getUserProfileByUsername:model.nickname];
//if (profileEntity) {
// model.avatarURLPath = profileEntity.imageUrl;
// model.nickname = profileEntity.nickname;
//}
// [[ChatDemoHelper shareHelper] setChatVC:nil];
// ChatGroupDetailViewController *detailController = [[ChatGroupDetailViewController alloc] initWithGroupId:self.conversation.conversationId];
// [self.navigationController pushViewController:detailController animated:YES];
// ChatroomDetailViewController *detailController = [[ChatroomDetailViewController alloc] initWithChatroomId:self.conversation.conversationId];
// [self.navigationController pushViewController:detailController animated:YES];
// id<IMessageModel> model = [self.dataArray objectAtIndex:self.menuIndexPath.row];
// ContactListSelectViewController *listViewController = [[ContactListSelectViewController alloc] initWithNibName:nil bundle:nil];
// listViewController.messageModel = model;
// [listViewController tableViewDidTriggerHeaderRefresh];
// [self.navigationController pushViewController:listViewController animated:YES];
//- (BOOL)viewController:(EMChooseViewController *)viewController didFinishSelectedSources:(NSArray *)selectedSources
//{
// if ([selectedSources count]) {
// EaseAtTarget *target = [[EaseAtTarget alloc] init];
// target.userId = selectedSources.firstObject;
// UserProfileEntity *profileEntity = [[UserProfileManager sharedInstance] getUserProfileByUsername:target.userId];
// if (profileEntity) {
// target.nickname = profileEntity.nickname == nil ? profileEntity.username : profileEntity.nickname;
// }
// if (_selectedCallback) {
// _selectedCallback(target);
// }
// }
// else {
// if (_selectedCallback) {
// _selectedCallback(nil);
// }
// }
// return YES;
//}
//- (void)viewControllerDidSelectBack:(EMChooseViewController *)viewController
//{
// if (_selectedCallback) {
// _selectedCallback(nil);
// }
//}
2.引入环信官方Demo中的:ChatDemoHelper.h、ChatDemoHelper.m、 CallViewController.h、CallViewController.m
删除ChatDemoHelper.m中的
介于
-(void) initHelper {
#ifdef REDPACKET_AVALABLE
[[RedPacketUserConfig sharedConfig] beginObserveMessage];
#endif
[[EMClient sharedClient] addDelegate:self delegateQueue:nil];
[[EMClient sharedClient].groupManager addDelegate:self delegateQueue:nil];
[[EMClient sharedClient].contactManager addDelegate:self delegateQueue:nil];
[[EMClient sharedClient].roomManager addDelegate:self delegateQueue:nil];
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
#if DEMO_CALL == 1
[[EMClient sharedClient].callManager addDelegate:self delegateQueue:nil];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(makeCall:) name:KNOTIFICATION_CALL object:nil];
#endif
}
与
#pragma mark - EMCallManagerDelegate
之间的所有代码。
当然，还是会有报错。
下面的代码也要删除：
-(void)_clearHelper {
self.mainVC = nil;
self.conversationListVC = nil;
self.chatVC = nil;
self.contactViewVC = nil;
[[EMClient sharedClient] logout:NO];
#if DEMO_CALL == 1
[self hangupCallWithReason:EMCallEndReasonFailed];
#endif
}
当然，你这样点击音视频按钮，还是不能弹出通话界面。
所以，你需要在你的XXX.pch头文件里加入这么一行代码即可。
#define DEMO_CALL 1
Paste_Image.png
要若想能弹出通话界面，设置根控制器，必须是这样的。
也就是在ChatDemoHelper.h中必须将你的聊天界面的控制器声明，命名最好是
mainVC。这样会比较省事儿。
Paste_Image.png
在AppDelegate.m，加入这样的一句代码：
//tabBarCtr为你的聊天界面的视图控制器。可以是Tabbar，或者别的。
[ChatDemoHelper shareHelper].mainVC = tabBarCtr;
CECNavigationViewController *callNav = nil;
CECChatRootController *tabBarCtr = [[CECChatRootController alloc] init];
[ChatDemoHelper shareHelper].mainVC = tabBarCtr;
callNav = [[CECNavigationViewController alloc] initWithRootViewController:tabBarCtr];
callNav.navigationBarHidden = YES;
self.window.rootViewController = callNav;
