SDK集成的一些问题
1、只添加环信IM功能
1.1 两个SDK HyphenateLite.framework 和Hyphenate.framework,后者包含实时音视频功能
1.2 环信demo有个EaseUI的包拖进工程,对界面要求不大的直接使用就可以了
2、只添加环信客服功能
1.1 环信客服SDK HelpDesk.framework,由于底层基于HyphenateLite.framework实现通信功能,所以两个库都要导入,1.2 HelpDeskUI拖进工程,界面基本就不用自己搭建了
3、同时接入环信IM和客服功能
3.1 不包含音视频的话,直接添加HyphenateLite.framework和HelpDesk.framework两个库,包含的话就添加Hyphenate.framework和HelpDesk.framework两个库
3.2 由于客服和IM的聊天界面不同,且是根据不同的库获取的数据进行展示,所以UI要导入两套EaseUI和HelpDeskUI
3.3 环信的注册和登录对于两个库都是一样的,所以只需要使用客服的库HelpDesk进行用户系统的建成就可以了,包括SDK的初始化都是用客服的就可以
4、最好设置成自动登录,以免每次进入进入会话列表没有数据
5、登录前一定要确定已经注册,当然注册是授权注册最好放在后台
6、通知回调的deviceToken通过环信SDK绑定的时候,最好确认用户已登录环信,且绑定代码要放在异步线程,否则会造成进入app卡顿
会话列表和聊天显示用户真实昵称和头像
由于环信服务器不存储任何用户的个人资料,所以不管是发送接收消息还是后来的通知内容,都无法获取聊天对方的真实资料
1、EMMessage消息类,包含了消息本身、发送和接受方的id,以及其他一些信息,其中有一个ext的属性,是一个NSDictionary类型,通过它可以使消息额外附带一些你想要的数据,其中就可以把用的name和headerImage存入进去,有两个特定字段
NSDictionary *dic = @{@"userAvatar":[WechatUserInfo shared].headimgurl,@"userNick":[WechatUserInfo shared].nickname};
2、会话列表展示中,鉴于以上ext存储了发送方信息,可以通过会话的lastReceivedMessage获取到ext字段,从而获取发送方的信息; 而对于用户主动发出却没有收到回复的消息就没办法了,如果能在用户发起聊天的消息ext字段中同时存储自己的信息和对方的信息,那么在消息列表展示的时候,及时没有收到对方消息(即没有lastReceivedMessage可以获取对方信息),但是自己发送的消息lastMessage中是有对方信息的呀
环信通知
1、严格按照步骤制作相关证书和文件,从keychain导出p12
文件的时候一定要设置密码
2、首次测试推送,一定要杀死app,因为app在前台或者后台未杀死状态,需要自己去做本地推送
3、因为app在前台或者后台未杀死状态,需要自己去做本地推送;对于app在后台未被杀死的时候,新消息会执行代理的方法,在方法内部自己做一个本地推送;环信demo中有此方法
- (void)messagesDidReceive:(NSArray *)aMessages{
//刷新列表
[[NSNotificationCenter defaultCenter] postNotificationName:NOTI_MESSAGE_RECEIVE object:nil];
UIApplicationState state = [[UIApplication sharedApplication] applicationState];
switch (state) {
case UIApplicationStateActive:
break;
case UIApplicationStateInactive:
break;
case UIApplicationStateBackground:
[self showNotificationWithMessage:aMessages.lastObject];
break;
default:
break;
}
}
4、在通知被用户点击触发的相关方法中,做相应处理
5、如果打包ad_hoc收不到推送,一定先检查自己的证书是否正确
环信消息撤销
一条消息的撤销涉及到两端用户对消息的处理,所以对于接收端是需要受到一个撤销消息的,所以A端撤销消息,需要将撤销的消息封装成透传消息发送给B端
1、撤销方,发送透传消息,发送成功将本地数据清除,刷新列表
- (void)revokeMessageWithMessageId:(NSString *)aMessageId conversationId:(NSString *)conversationId {
EMCmdMessageBody *body = [[EMCmdMessageBody alloc] initWithAction:@"REVOKE_FLAG"];
NSDictionary *ext = @{@"msgId":aMessageId};
NSString *currentUsername = [EMClient sharedClient].currentUsername;
EMMessage *message = [[EMMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:ext];
if (self.conversation.type == EMConversationTypeGroupChat){
message.chatType = EMChatTypeGroupChat;
} else {
message.chatType = EMChatTypeChat;
}
//发送cmd消息
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:^(EMMessage *message, EMError *error) {
if (!error) {
NSLog(@"发送成功");
// 需要自己从dataArray里将聊天消息删掉, 还有self.conversation里,最后刷新
NSMutableIndexSet *indexs = [NSMutableIndexSet indexSetWithIndex:self.menuIndexPath.row];
NSMutableArray *indexPaths = [NSMutableArray arrayWithObjects:self.menuIndexPath, nil];
[self.conversation deleteMessageWithId:aMessageId error:nil];
[self.messsagesSource removeObject:message];
if (self.menuIndexPath.row - 1 >= 0) {
id nextMessage = nil;
id prevMessage = [self.dataArray objectAtIndex:(self.menuIndexPath.row - 1)];
if (self.menuIndexPath.row + 1 < [self.dataArray count]) {
nextMessage = [self.dataArray objectAtIndex:(self.menuIndexPath.row + 1)];
}
if ((!nextMessage || [nextMessage isKindOfClass:[NSString class]]) && [prevMessage isKindOfClass:[NSString class]]) {
[indexs addIndex:self.menuIndexPath.row - 1];
[indexPaths addObject:[NSIndexPath indexPathForRow:(self.menuIndexPath.row - 1) inSection:0]];
}
}
[self.dataArray removeObjectAtIndex:self.menuIndexPath.row];
[self.messsagesSource enumerateObjectsWithOptions:NSEnumerationReverse usingBlock:^(EMMessage *obj, NSUInteger idx, BOOL *stop) {
if ([obj isKindOfClass:[EMMessage class]] && [obj.messageId isEqualToString:aMessageId]) {
[self.messsagesSource removeObject:obj];
}
}];
// [self.tableView beginUpdates];
[self.tableView reloadData];
// [self.tableView endUpdates];
if ([self.dataArray count] == 0) {
self.messageTimeIntervalTag = -1;
}
}else {
NSLog(@"发送失败");
}
}];
}
2、接收方:EMChatManagerDelegate代理方法, 接收透传消息,进行处理,全局的消息工具类和会话类中都需要实现该代理方法,更新相关数据及页面
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages
{
BOOL isRefreshCons = YES;
for (EMMessage *cmdMessage in aCmdMessages) {
EMCmdMessageBody *body = (EMCmdMessageBody *)cmdMessage.body;
if ([body.action isEqualToString:@"REVOKE_FLAG"]) {
NSString *revokeMessageId = cmdMessage.ext[@"msgId"];
BOOL isSuccess = [self removeRevokeMessageWithChatter:cmdMessage.conversationId conversationType:(EMConversationType)cmdMessage.chatType messageId:revokeMessageId];
//发送刷新会话列表通知
[[NSNotificationCenter defaultCenter] postNotificationName:@"conversationListRefresh" object:nil];
[self.tableView reloadData];
}
}
}
- (BOOL)removeRevokeMessageWithChatter:(NSString *)aChatter
conversationType:(EMConversationType)type
messageId:(NSString *)messageId{
EMConversation *conversation = [[EMClient sharedClient].chatManager getConversation:aChatter type:type createIfNotExist:YES];
[conversation deleteMessageWithId:messageId error:nil];
[self.messsagesSource enumerateObjectsWithOptions:NSEnumerationReverse usingBlock:^(EMMessage *obj, NSUInteger idx, BOOL *stop) {
if ([obj isKindOfClass:[EMMessage class]] && [obj.messageId isEqualToString:messageId]) {
[self.messsagesSource removeObject:obj];
}
}];
NSArray *formattedMessages = [self formatMessages:self.messsagesSource];
[self.dataArray removeAllObjects];
[self.dataArray addObjectsFromArray:formattedMessages]; return YES;
}
环信IM中的多代理的使用
[[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];
在设置代理的过程中发现,环信可以设置多代理,但请注意:
1、addDelegate一个类只能一次,不然当前类代理方法调用的次数就是你add的次数(猜想,addDelegate就只添加代理,没有去重,当调用代理方法的时候,遍历了所有的delegate,所以同一个类的delegate方法会执行多次)
2、环信注册一定放在didFinishLaunch最前面,不然后来的环信相关配置都失效