第三方聊天---环信

环信 聊天

 框架
    App
    Easy UI    (UI控件)
    SDK        基于核心协议实现的完整的 IM 功能，实现了不同类型消息的收发、会话管理、群组、好友、聊天室等功能
    SDK_CORE   为核心的消息同步协议实现，完成与服务器之间的信息交换
 
 SDK
    EMClient               SDK的入口，主要完成登录、退出、连接管理等功能，也是获取其他模块的入口。
    EMClientManager        管理消息的收发，完成会话管理等功能
    EMContactManager       负责好友的添加删除，黑名单的管理
    EMGroupManager         负责群组的管理，创建、删除群组，管理群组成员等功能
    EMChatroomManager      负责聊天室的管理

配置

1. 苹果开发官网创建 2推送证书（开发证书 和 线上证书）
2. 环信开发者中心注册应用（添加上述2推送证书）（获取KEY）

pod 'Hyphenate'     包含实时语音功能
pod 'EaseUI'        快速集成UI
#import <Hyphenate/Hyphenate.h>

AppDelegate
    
    // 在环信中注册本应用
    EMOptions *options=[EMOptions optionsWithAppkey:@"64619039#kachamao"];
    // 证书
#if DEBUG
    [options setApnsCertName:@"s_dev"];
#else
    [options setApnsCertName:@"s_product"];
#endif
    [[EMClient sharedClient]initializeSDKWithOptions:options];

 
// APP进入后台
- (void)applicationDidEnterBackground:(UIApplication *)application{
    // 环信进入后台
    [[EMClient sharedClient] applicationDidEnterBackground:application];
}


// APP将要从后台返回前台
- (void)applicationWillEnterForeground:(UIApplication *)application{
    // 环信即将进入前台
    [[EMClient sharedClient] applicationWillEnterForeground:application];
}

注册登录

注册
EMError *error = [[EMClient sharedClient] registerWithUsername:@"唯一表示用户" password:@"111111"];
if (error==nil) {
    NSLog(@"注册成功");
}


登陆
[[EMClient sharedClient] loginWithUsername:@"8001"
                                  password:@"111111"
                                completion:^(NSString *aUsername, EMError *aError) {
                                    if (!aError) {
                                        NSLog(@"登录成功");
                                    } else {
                                        NSLog(@"登录失败");
                                    }
                                }];



// 以下情况会导致自动登录失败
  1.用户调用了 SDK 的登出动作；
  2.用户在别的设备上更改了密码，导致此设备上自动登录失败；
  3.用户的账号被从服务器端删除；
  4.用户从另一个设备登录，把当前设备上登录的用户踢出。
自动登录
BOOL isAutoLogin = [EMClient sharedClient].options.isAutoLogin;
if (!isAutoLogin) {
    EMError *error = [[EMClient sharedClient] loginWithUsername:@"8001" password:@"111111"];
    if (!error)
    {
        [[EMClient sharedClient].options setIsAutoLogin:YES];
    }
}
// 自动登录后调用
- (void)autoLoginDidCompleteWithError:(EMError *)error{}
// 重连时回调
- (void)connectionStateDidChange:(EMConnectionState)aConnectionState{}



退出登录
  -》主动退出登录：调用 SDK 的退出接口；
  -》被动退出登录：1. 正在登录的账号在另一台设备上登录；2. 正在登录的账号被从服务器端删除。

// 主动退出登录
EMError *error = [[EMClient sharedClient] logout:YES];
if (!error) {
    NSLog(@"退出成功");
}
// 当用户从另一个设备登录此账号时调用
- (void)userAccountDidLoginFromOtherDevice{}
// 当用户的账号被从服务器端删除时调用
- (void)userAccountDidRemoveFromServer{}

好友

// 从服务器获取所有的好友
[[EMClient sharedClient].contactManager getContactsFromServerWithCompletion:^(NSArray *aList, EMError *aError) {
    if (!aError) {
        NSLog(@"获取成功");
    }
}];
// 从数据库获取所有的好友
NSArray *userlist = [[EMClient sharedClient].contactManager getContacts];

// 发送 添加好友 申请
[[EMClient sharedClient].contactManager addContact:@"8001"
                                           message:@"我想加您为好友"
                                        completion:^(NSString *aUsername, EMError *aError) {
                                            if (!aError) {
                                                NSLog(@"邀请发送成功");
                                            }
                                        }];

// 同意好友申请
[[EMClient sharedClient].contactManager approveFriendRequestFromUser:@"8001"
                                                          completion:^(NSString *aUsername, EMError *aError) {
                                                              if (!aError) {
                                                                  NSLog(@"同意好友成功");
                                                              }
                                                          }];

// 拒绝好友申请
[[EMClient sharedClient].contactManager declineFriendRequestFromUser:@"8001"
                                                          completion:^(NSString *aUsername, EMError *aError) {
                                                              if (!aError) {
                                                                  NSLog(@"拒绝好友成功");
                                                              }
                                                          }];

// 删除好友
[[EMClient sharedClient].contactManager deleteContact:@"8001"
                                 isDeleteConversation: YES
                                           completion:^(NSString *aUsername, EMError *aError) {
                                               if (!aError) {
                                                   NSLog(@"删除成功");
                                               }
                                           }];

    // 注册好友dele <EMContactManagerDelegate>
    [[EMClient sharedClient].contactManager addDelegate:self delegateQueue:nil];
    // 移除dele
    [[EMClient sharedClient].contactManager removeDelegate:self];
    
    // 对方同意加好友请求后回调
    - (void)friendRequestDidApproveByUser:(NSString *)aUsername{}
    // 对方拒绝加好友请求后回调
    - (void)friendRequestDidDeclineByUser:(NSString *)aUsername{}
    // 对方删除我，双方都回调
    - (void)friendshipDidRemoveByUser:(NSString *)aUsername{}
    // 对方同意好友请求后，双方回调
    - (void)friendshipDidAddByUser:(NSString *)aUsername{}
    // 对方发送好友请求后回调
    - (void)friendRequestDidReceiveFromUser:(NSString *)aUsername message:(NSString *)aMessage{}

    // 获取好友黑名单
    EMError *error = nil;
    NSArray *blackList = [[EMClient sharedClient].contactManager getBlackListFromServerWithError:&error];
    if (!error) {
        NSLog(@"获取成功 -- %@",blackList);
    }
    // 从数据库获取黑名单列表
    NSArray *blockList = [[EMClient sharedClient].contactManager getBlackList];
    
    
    // 加入黑名单
    EMError *error = [[EMClient sharedClient].contactManager addUserToBlackList:@"6001" relationshipBoth:YES];
    if (!error) {
        NSLog(@"发送成功");
    }
    
    // 移除黑名单
    EMError *error = [[EMClient sharedClient].contactManager removeUserFromBlackList:@"6001"];
    if (!error) {
        NSLog(@"发送成功");
    }

会话

获取所有会话(内存中有则从内存中取，没有则从db中取)
 NSArray *conversations = [[EMClient sharedClient].chatManager getAllConversations];

获取或创建会话
 EMConversation *conversation = [[EMClient sharedClient].chatManager getConversation:@"8001" type:EMConversationTypeChat createIfNotExist:YES];
     EMConversationTypeChat            单聊会话
     EMConversationTypeGroupChat       群聊会话
     EMConversationTypeChatRoom        聊天室会话
 
删除会话
 [[EMClient sharedClient].chatManager deleteConversation:@"8001" isDeleteMessages:YES completion:^(NSString *aConversationId, EMError *aError){
 //code
 }];
 
根据 conversationId 批量删除会话
 EMConversation *conversation = [[EMClient sharedClient].chatManager getConversation:@"8001" type:EMConversationTypeChat createIfNotExist:NO];
 [[EMClient sharedClient].chatManager deleteConversations:@[conversation] isDeleteMessages:YES completion:^(EMError *aError){
 //code
 }];

获取会话未读消息数
 [EMConversation unreadMessagesCount];


获取会话中的消息
    // 从数据库获取时间段内的消息（时间单位：毫秒），最大数量10
    [conversion loadMessagesFrom:1000 to:1000 count:10 completion:^(NSArray *aMessages, EMError *aError) {
        // 获取完毕后回调
    }];
    //  从数据库获取指定id的消息
    [conversion loadMessageWithId:@"messageId" error:nil];
    // 从数据库获取从指定id的消息（不包含）后开始10条消息
    [conversion loadMessagesStartFromId:@"messageId" count:10 searchDirection:EMMessageSearchDirectionUp completion:^(NSArray *aMessages, EMError *aError) {
    }];
    // 从数据库获取从指定时间（毫秒）指定发送人，从上到下10条消息
    [conversion loadMessagesWithType:EMMessageBodyTypeText timestamp:1000 count:10 fromUser:@"" searchDirection:EMMessageSearchDirectionUp completion:^(NSArray *aMessages, EMError *aError) {
    }];
    // 从数据库获取从指定时间（毫秒）指定发送人包含关键字，从上到下10条消息
    [conversion loadMessagesWithKeyword:@"keyWord" timestamp:1000 count:10 fromUser:@"" searchDirection:EMMessageSearchDirectionUp completion:^(NSArray *aMessages, EMError *aError) {
    }];

消息

1.消息体
文本消息
 EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"要发送的消息"];
图片消息
 EMImageMessageBody *body = [[EMImageMessageBody alloc] initWithData:data displayName:@"image.png"];
位置消息
 EMLocationMessageBody *body = [[EMLocationMessageBody alloc] initWithLatitude:39 longitude:116 address:@"地址"];
语音消息
 EMVoiceMessageBody *body = [[EMVoiceMessageBody alloc] initWithLocalPath:@"audioPath" displayName:@"audio"];
 body.duration = duration;
视频消息
 EMVideoMessageBody *body = [[EMVideoMessageBody alloc] initWithLocalPath:@"videoPath" displayName:@"video.mp4"];
文件消息
 EMFileMessageBody *body = [[EMFileMessageBody alloc] initWithLocalPath:@"filePath" displayName:@"file"];
透传消息
 EMCmdMessageBody *body = [[EMCmdMessageBody alloc] initWithAction:action];

 2.消息
 // 消息
 NSString *from = [[EMClient sharedClient] currentUsername];
 EMMessage *message = [[EMMessage alloc] initWithConversationID:@"6001" from:from to:@"6001" body:body ext:messageExt];
 message.chatType = EMChatTypeChat;         // 单聊,EMChatTypeGroupChat群聊 EMChatTypeChatRoom聊天室
 message.ext = @{@"key":@"value"};          // 扩展消息
 
 3.插入消息
 [[EMClient sharedClient].chatManager importMessages:@[message] completion:^(EMError *aError) {
 //code
 }];

 3.发送消息(异步)
 [[EMClient sharedClient].chatManager sendMessage:[EMMessage new] progress:^(int progress) {
 } completion:^(EMMessage *message, EMError *error) {
 }];
 

 // 更新消息到 DB
 [[EMClient sharedClient].chatManager updateMessage:aMessage];

 // 添加dele   <EMChatManagerDelegate>
 [[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
 // 移除dele
 [[EMClient sharedClient].chatManager removeDelegate:self];


// 收到消息（非透传）后回调
- (void)messagesDidReceive:(NSArray *)aMessages{
    
    //
    for (EMMessage *message in aMessages) {
        // 消息中的扩展属性
        NSDictionary *ext = message.ext;
    
        
        EMMessageBody *msgBody = message.body;
        switch (msgBody.type) {
            case EMMessageBodyTypeText:{
                // 收到的文字消息
                EMTextMessageBody *textBody = (EMTextMessageBody *)msgBody;
                NSString *txt = textBody.text;
                NSLog(@"收到的文字是 txt -- %@",txt);
            }
                break;
            case EMMessageBodyTypeImage:{
                // 得到一个图片消息body
                EMImageMessageBody *body = ((EMImageMessageBody *)msgBody);
                NSLog(@"大图remote路径 -- %@"   ,body.remotePath);
                NSLog(@"大图local路径 -- %@"    ,body.localPath); // // 需要使用sdk提供的下载方法后才会存在
                NSLog(@"大图的secret -- %@"    ,body.secretKey);
                NSLog(@"大图的W -- %f ,大图的H -- %f",body.size.width,body.size.height);
                NSLog(@"大图的下载状态 -- %lu",body.downloadStatus);
                
                
                // 缩略图sdk会自动下载
                NSLog(@"小图remote路径 -- %@"   ,body.thumbnailRemotePath);
                NSLog(@"小图local路径 -- %@"    ,body.thumbnailLocalPath);
                NSLog(@"小图的secret -- %@"    ,body.thumbnailSecretKey);
                NSLog(@"小图的W -- %f ,大图的H -- %f",body.thumbnailSize.width,body.thumbnailSize.height);
                NSLog(@"小图的下载状态 -- %lu",body.thumbnailDownloadStatus);
            }
                break;
            case EMMessageBodyTypeLocation:{
                
                EMLocationMessageBody *body = (EMLocationMessageBody *)msgBody;
                NSLog(@"纬度-- %f",body.latitude);
                NSLog(@"经度-- %f",body.longitude);
                NSLog(@"地址-- %@",body.address);
            }
                break;
            case EMMessageBodyTypeVoice:{
                
                // 音频sdk会自动下载
                EMVoiceMessageBody *body = (EMVoiceMessageBody *)msgBody;
                NSLog(@"音频remote路径 -- %@"      ,body.remotePath);
                NSLog(@"音频local路径 -- %@"       ,body.localPath); // 需要使用sdk提供的下载方法后才会存在（音频会自动调用）
                NSLog(@"音频的secret -- %@"        ,body.secretKey);
                NSLog(@"音频文件大小 -- %lld"       ,body.fileLength);
                NSLog(@"音频文件的下载状态 -- %lu"   ,body.downloadStatus);
                NSLog(@"音频的时间长度 -- %lu"      ,body.duration);
            }
                break;
            case EMMessageBodyTypeVideo:{
                
                EMVideoMessageBody *body = (EMVideoMessageBody *)msgBody;
                
                NSLog(@"视频remote路径 -- %@"      ,body.remotePath);
                NSLog(@"视频local路径 -- %@"       ,body.localPath); // 需要使用sdk提供的下载方法后才会存在
                NSLog(@"视频的secret -- %@"        ,body.secretKey);
                NSLog(@"视频文件大小 -- %lld"       ,body.fileLength);
                NSLog(@"视频文件的下载状态 -- %lu"   ,body.downloadStatus);
                NSLog(@"视频的时间长度 -- %lu"      ,body.duration);
                NSLog(@"视频的W -- %f ,视频的H -- %f", body.thumbnailSize.width, body.thumbnailSize.height);
                
                // 缩略图sdk会自动下载
                NSLog(@"缩略图的remote路径 -- %@"     ,body.thumbnailRemotePath);
                NSLog(@"缩略图的local路径 -- %@"      ,body.thumbnailLocalPath);
                NSLog(@"缩略图的secret -- %@"        ,body.thumbnailSecretKey);
                NSLog(@"缩略图的下载状态 -- %lu"      ,body.thumbnailDownloadStatus);
            }
                break;
            case EMMessageBodyTypeFile:{
                
                EMFileMessageBody *body = (EMFileMessageBody *)msgBody;
                NSLog(@"文件remote路径 -- %@"      ,body.remotePath);
                NSLog(@"文件local路径 -- %@"       ,body.localPath); // 需要使用sdk提供的下载方法后才会存在
                NSLog(@"文件的secret -- %@"        ,body.secretKey);
                NSLog(@"文件文件大小 -- %lld"       ,body.fileLength);
                NSLog(@"文件文件的下载状态 -- %lu"   ,body.downloadStatus);
            }
                break;
                
            default:
                break;
        }
    }
}
// 收到透传(cmd)在线消息后回调
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages{
    for (EMMessage *message in aCmdMessages) {
        
        // cmd消息中的扩展属性
        NSDictionary *ext = message.ext;
        
        
        EMCmdMessageBody *body = (EMCmdMessageBody *)message.body;
        NSLog(@"收到的action是 -- %@",body.action);
    }
}


// 会话列表变动后调用
- (void)conversationListDidUpdate:(NSArray *)aConversationList{}
// 收到消息后调用
- (void)messagesDidReceive:(NSArray *)aMessages{}
// 收到cmd透传消息后调用
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages{}
// 消息已读后回调
- (void)messagesDidRead:(NSArray *)aMessages{}
// 消息送达后回调
- (void)messagesDidDeliver:(NSArray *)aMessages{}
// 消息撤回后回调
- (void)messagesDidRecall:(NSArray *)aMessages{}
// 消息状态改变时调用
- (void)messageStatusDidChange:(EMMessage *)aMessage error:(EMError *)aError{}
// 消息附件状态改变时调用
- (void)messageAttachmentStatusDidChange:(EMMessage *)aMessage error:(EMError *)aError{}

群组

群组类型（4种）
    EMGroupStylePrivateOnlyOwnerInvite 私有群组，创建完成后，只允许 Owner 邀请用户加入
    EMGroupStylePrivateMemberCanInvite 私有群组，创建完成后，只允许 Owner 和群成员邀请用户加入
    EMGroupStylePublicJoinNeedApproval 公开群组，创建完成后，只允许 Owner 邀请用户加入; 非群成员用户需发送入群申请，Owner 同意后才能入组
    EMGroupStylePublicOpenJoin         公开群组，创建完成后，允许非群组成员加入，不需要管理员同意

创建群组
    EMError *error = nil;
    EMGroupOptions *setting = [[EMGroupOptions alloc] init];
    setting.maxUsersCount = 500;
    setting.style = EMGroupStylePublicOpenJoin;// 创建不同类型的群组，这里需要才传入不同的类型
    EMGroup *group = [[EMClient sharedClient].groupManager createGroupWithSubject:@"群组名称" description:@"群组描述" invitees:@[@"6001",@"6002"] message:@"邀请您加入群组" setting:setting error:&error];
    if(!error){
        NSLog(@"创建成功 -- %@",group);
    }

获取群详情
    // 获取群详情
    EMGroup *group=[[EMClient sharedClient].groupManager getGroupSpecificationFromServerWithId:@"groupId" error:nil];
    // 获取群详情
    [[EMClient sharedClient].groupManager getGroupSpecificationFromServerWithId:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    
    // 申请加入群组
    EMError *error = nil;
    [[EMClient sharedClient].groupManager applyJoinPublicGroup:@"groupId" message:@"" error:nil];
    // 管理员 加人进群
    EMError *error = nil;
    [[EMClient sharedClient].groupManager addOccupants:@[@"user1"] toGroup:@"groupId" welcomeMessage:@"message" error:&error];
    // 管理员 同意进群申请
    EMError *error = [[EMClient sharedClient].groupManager acceptJoinApplication:@"groupId" applicant:@"user1"];
    // 管理员 拒绝加群申请
    EMError *error = [[EMClient sharedClient].groupManager declineJoinApplication:@"groupId" groupname:@"subject" applicant:@"user1" reason:@"拒绝的原因"];
    
    // 加入公开群
    MError *error = nil;
    [[EMClient sharedClient].groupManager joinPublicGroup:@"1410329312753" error:&error];
    
    // 主动退群
    EMError *error = nil;
    [[EMClient sharedClient].groupManager leaveGroup:@"1410329312753" error:&error];
    
    // 解散群组
    EMError *error = nil;
    [[EMClient sharedClient].groupManager destroyGroup:@"groupId" error:&error];
    if (!error) {
        NSLog(@"解散成功");
    }
    
    // 修改群名称
    EMError *error = nil;
    [[EMClient sharedClient].groupManager changeGroupSubject:@"要修改的名称" forGroup:@"1410329312753" error:&error];
    if (!error) {
        NSLog(@"修改成功");
    }
    // 修改群描述
    EMError *error = nil;
    EMGroup* group = [[EMClient sharedClient].groupManager changeDescription:@"修改的群描述" forGroup:@"1410329312753" error:&error];
    if (!error) {
        NSLog(@"修改成功");
    }
    
    // 获取群成员列表
    EMError *error = nil;
    EMCursorResult* result = [[EMClient sharedClient].groupManager getGroupMemberListFromServerWithId:@"groupId" cursor:@"cursor" pageSize:50 error:&error];
    if (!error) {
        NSLog(@"获取成功");
        // result.list: 返回的成员列表，内部的值是成员的环信id。
        // result.cursor: 返回的cursor，如果要取下一页的列表，需要将这个cursor当参数传入到获取群组成员列表中。
    }
    // 异步 
    [[EMClient sharedClient].groupManager getGroupMemberListFromServerWithId:@"" cursor:@"" pageSize:50 completion:^(EMCursorResult *aResult, EMError *aError) {
    }];
    
    // 获取群黑名单列表
    EMError *error = nil;
    EMGroup* group = [[EMClient sharedClient].groupManager getGroupBlacklistFromServerWithId:@"groupId" pageNumber:1 pageSize:50 error:&error];
    if (!error) {
        NSLog(@"获取成功");
    }
    // 异步
    [[EMClient sharedClient].groupManager getGroupBlacklistFromServerWithId:@"" pageNumber:@1 pageSize:@50 completion:^(NSArray *aList, EMError *aError) {
    }];

    // 获取被禁言列表
    EMError *error = nil;
    EMGroup* group = [[EMClient sharedClient].groupManager getGroupMuteListFromServerWithId:@"groupId" pageNumber:1 pageSize:50 error:&error];
    if (!error) {
        NSLog(@"获取成功");
    }
    // 异步
    [[EMClient sharedClient].groupManager getGroupMuteListFromServerWithId:@"" pageNumber:1 pageSize:50 completion:^(NSArray *aList, EMError *aError) {
}];
    
    // 获取群公告
    [[EMClient sharedClient].groupManager getGroupAnnouncementWithId:@"groupId"
                                                          completion:^(NSString *aAnnouncement, EMError *aError) {
                                                              if (!aError) {
                                                                  NSLog(@"获取成功");
                                                              }
                                                          }];
    // 异步
    [[EMClient sharedClient].groupManager updateGroupAnnouncementWithId:@"" announcement:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    
    // 修改群公告
    [[EMClient sharedClient].groupManager updateGroupAnnouncementWithId:@"groupid"
                                                           announcement:@"群公告"
                                                             completion:^(EMGroup *aGroup, EMError *aError) {
                                                                 if (!aError) {
                                                                     NSLog(@"修改成功");
                                                                 }
                                                             }];
    
    
    // 获取群共享文件列表
    // 同步
    NSArray *arr=[[EMClient sharedClient].groupManager getGroupFileListWithId:@"" pageNumber:1 pageSize:10 error:nil];
    // 异步
    [[EMClient sharedClient].groupManager getGroupFileListWithId:@"groupId"
                                                      pageNumber:1
                                                        pageSize:10
                                                      completion:^(NSArray *aList, EMError *aError) {
                                                          if (!aError) {
                                                              NSLog(@"获取成功");
                                                          }
                                                      }];
    
    // 上传群文件
    [[EMClient sharedClient].groupManager uploadGroupSharedFileWithId:@"groupId"
                                                             filePath:@"filePath"
                                                             progress:^(int progress){
                                                             } completion:^(EMGroupSharedFile *aSharedFile, EMError *aError) {
                                                                 if (!aError) {
                                                                     NSLog(@"上传成功");
                                                                 }
                                                             }];
    // 下载群文件
    [[EMClient sharedClient].groupManager downloadGroupSharedFileWithId:@"groupId"
                                                               filePath:@"filePath"
                                                           sharedFileId:@"fileId"
                                                               progress:^(int progress) {
                                                               } completion:^(EMGroup *aGroup, EMError *aError) {
                                                                   if (!aError) {
                                                                       NSLog(@"下载成功");
                                                                   }
                                                               }];
    // 删除共享文件 同步
    EMError *error = nil;
    [[EMClient sharedClient].groupManager removeGroupSharedFileWithId:@"groupId" sharedFileId:@"fileId" error:&error];
    if (!error) {
        NSLog(@"删除成功");
    }
     // 异步
    [[EMClient sharedClient].groupManager removeGroupSharedFileWithId:@"" sharedFileId:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    
    // 修改群扩展信息(同步／异步)
    [[EMClient sharedClient].groupManager updateGroupExtWithId:@"" ext:@"" error:nil];
    [[EMClient sharedClient].groupManager updateGroupExtWithId:@"groupId"
                                                           ext:@"ext"
                                                    completion:^(EMGroup *aGroup, EMError *aError) {
                                                        if (!aError) {
                                                            NSLog(@"修改成功");
                                                        }
                                                    }];
    

    // 改变群主（必须是群主）
    EMError *error = nil;
    [[EMClient sharedClient].groupManager updateGroupOwner:@"groupId" newOwner:@"newOwner" error:&error];
    // 改变群主（异步）
    [[EMClient sharedClient].groupManager updateGroupOwner:@"" newOwner:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 添加群管理员
    EMError *error = nil;
    [[EMClient sharedClient].groupManager addAdmin:@"adminName" toGroup:@"groupId" error:&error];
    [[EMClient sharedClient].groupManager addAdmin:@"" toGroup:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 移除群管理员
    EMError *error = nil;
    [[EMClient sharedClient].groupManager removeAdmin:@"adminName" fromGroup:@"groupId" error:&error];
    [[EMClient sharedClient].groupManager removeAdmin:@"" fromGroup:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 移除群成员
    EMError *error = nil;
    [[EMClient sharedClient].groupManager removeOccupants:@[@"user1"] fromGroup:@"1410329312753" error:&error];
    [[EMClient sharedClient].groupManager removeMembers:@[] fromGroup:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 禁言群成员
    EMError *error = nil;
    [[EMClient sharedClient].groupManager muteMembers:@[userName] muteMilliseconds:-1 fromGroup:@"groupId" error:&error];
    [[EMClient sharedClient].groupManager muteMembers:@"" muteMilliseconds:30 fromGroup:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 解禁言群成员
    EMError *error = nil;
    [[EMClient sharedClient].groupManager unmuteMembers:@[userName] fromGroup:@"groupId" error:&error];
    [[EMClient sharedClient].groupManager unmuteMembers:@[] fromGroup:@"" completion:^(EMGroup *aGroup, EMError *aError) {
    }];
    // 加入群黑名单
    EMError *error = nil;
    EMGroup *group = [[EMClient sharedClient].groupManager blockOccupants:@[@"user1"] fromGroup:@"1410329312753" error:&error];
    // 移除群黑名单
    EMError *error = nil;
    EMGroup *group = [[EMClient sharedClient].groupManager unblockOccupants:@[@"user1"] forGroup:@"1410329312753" error:&error];
    
    
    // 屏蔽／取消屏蔽 群消息
    [[EMClient sharedClient].groupManager blockGroup:@"groupId" error:nil];
    [[EMClient sharedClient].groupManager unblockGroup:@"groupId" error:nil];
    
    
    // 内存中获取所有群组，第一次从数据库加载
    NSArray *groupList = [[EMClient sharedClient].groupManager getJoinedGroups];
    // 获取和登录者相关的群组
    EMError *error = nil;
    NSArray *myGroups = [[EMClient sharedClient].groupManager getJoinedGroupsFromServerWithPage:1 pageSize:50 error:&error];
    if (!error) {
        NSLog(@"获取成功 -- %@",myGroups);
    }
    // 获取公开群组
    EMError *error = nil;
    EMCursorResult *result = [[EMClient sharedClient].groupManager getPublicGroupsFromServerWithCursor:nil pageSize:50 error:&error];
    if (!error) {
        NSLog(@"获取成功 -- %@",result);
    }

    // 群组dele <EMGroupManagerDelegate>
    [[EMClient sharedClient].groupManager addDelegate:self delegateQueue:nil];
    // 移除群组dele
    [[EMClient sharedClient].groupManager removeDelegate:self];

    // 对方邀请我加入某群时调用
    - (void)groupInvitationDidReceive:(NSString *)aGroupId inviter:(NSString *)aInviter message:(NSString *)aMessage{}
    // 对方同意我的加群邀请时调用
    - (void)groupInvitationDidAccept:(EMGroup *)aGroup invitee:(NSString *)aInvitee{}
    // 对方拒绝我的加群邀请时调用
    - (void)groupInvitationDidDecline:(EMGroup *)aGroup invitee:(NSString *)aInvitee reason:(NSString *)aReason{}
    // 自动加入群后回调（对方邀请）（EMOptions的isAutoAcceptGroupInvitation为YES）
    - (void)didJoinGroup:(EMGroup *)aGroup inviter:(NSString *)aInviter message:(NSString *)aMessage{}
    // 离开群组后回调
    - (void)didLeaveGroup:(EMGroup *)aGroup reason:(EMGroupLeaveReason)aReason{}
    // 收到入群请求后回调（群的类型是EMGroupStylePublicJoinNeedApproval）
    - (void)joinGroupRequestDidReceive:(EMGroup *)aGroup user:(NSString *)aUsername reason:(NSString *)aReason{}
    // 申请入群被拒后回调（群的类型是EMGroupStylePublicJoinNeedApproval）
    - (void)joinGroupRequestDidDecline:(NSString *)aGroupId reason:(NSString *)aReason{}
    // 申请入群被同意后回调（群的类型是EMGroupStylePublicJoinNeedApproval）
    - (void)joinGroupRequestDidApprove:(EMGroup *)aGroup{}
    // 群组列表更新后回调
    - (void)groupListDidUpdate:(NSArray *)aGroupList{}
    // 有成员被加入禁言列表后调用
    - (void)groupMuteListDidUpdate:(EMGroup *)aGroup addedMutedMembers:(NSArray *)aMutedMembers muteExpire:(NSInteger)aMuteExpire{}
    // 有成员被移除禁言列表后调用
    - (void)groupMuteListDidUpdate:(EMGroup *)aGroup removedMutedMembers:(NSArray *)aMutedMembers{}
    // 有成员被加入管理员列表后调用
    - (void)groupAdminListDidUpdate:(EMGroup *)aGroup addedAdmin:(NSString *)aAdmin{}
    // 有成员被移除管理员列表后调用
    - (void)groupAdminListDidUpdate:(EMGroup *)aGroup removedAdmin:(NSString *)aAdmin{}
    // 群组创建者更新后回调
    - (void)groupOwnerDidUpdate:(EMGroup *)aGroup newOwner:(NSString *)aNewOwner oldOwner:(NSString *)aOldOwner{}
    // 有用户加入群组后回调
    - (void)userDidJoinGroup:(EMGroup *)aGroup user:(NSString *)aUsername{}
    // 有用户离开群组后调用
    - (void)userDidLeaveGroup:(EMGroup *)aGroup user:(NSString *)aUsername{}
    // 群公告更新后调用
    - (void)groupAnnouncementDidUpdate:(EMGroup *)aGroup announcement:(NSString *)aAnnouncement{}
    // 有用户上传文件后调用
    - (void)groupFileListDidUpdate:(EMGroup *)aGroup addedSharedFile:(EMGroupSharedFile *)aSharedFile{}
    // 有用户删除群共享文件
    - (void)groupFileListDidUpdate:(EMGroup *)aGroup removedSharedFile:(NSString *)aFileId{}

群主
// 作为群主 收到入群申请时调用
- (void)didReceiveJoinGroupApplication:(EMGroup *)aGroup applicant:(NSString *)aApplicant reason:(NSString *)aReason{}

聊天页面

进入系统单聊页面
 EaseMessageViewController *chatController = [[EaseMessageViewController alloc] initWithConversationChatter:@"8001" conversationType:EMConversationTypeChat];

进入系统群聊页面
 EaseMessageViewController *chatController = [[EaseMessageViewController alloc] initWithConversationChatter:@"groupId" conversationType:EMConversationTypeGroupChat];

    // 下载消息中的附件
    [[EMClient sharedClient].chatManager downloadMessageThumbnail:message progress:^(int progress) {
    } completion:^(EMMessage *message, EMError *error) {
    }];
    // 下载消息中的原始附件
    [[EMClient sharedClient].chatManager downloadMessageAttachment:message progress:^(int progress) {
    } completion:^(EMMessage *message, EMError *error) {
    }];
    
    // 发送已读回执（需要开发者手动调用）
    [[EMClient sharedClient].chatManager sendMessageReadAck:message completion:^(EMMessage *aMessage, EMError *aError) {
        if(!aError){
            NSLog(@"send success");
        }
    }];
    
    // 获取消息漫游
    [[EMClient sharedClient].chatManager fetchHistoryMessagesFromServer:@"要获取漫游消息的Conversation id" conversationType:EMConversationTypeChat startMessageId:@"参考起始消息的ID" pageSize:10 error:nil];
    // 获取消息漫游（异步）
    [[EMClient sharedClient].chatManager asyncFetchHistoryMessagesFromServer:@"" conversationType:EMConversationTypeChat startMessageId:@"" pageSize:10 complation:^(EMCursorResult *aResult, EMError *aError) {
    }];
    // 撤回消息
    [[EMClient sharedClient].chatManager recallMessage:message completion:^(EMMessage *aMessage, EMError *aError) {
    }];

聊天室

   // 获取聊天室
    EMError *error = nil;
    NSArray *list = [[EMClient sharedClient].roomManager getChatroomsFromServerWithPage:0 pageSize：50 error:&error];
    [[EMClient sharedClient].roomManager getChatroomsFromServerWithPage:0 pageSize:10 completion:^(EMPageResult *aResult, EMError *aError) {
    }];
    // 加入聊天室
    EMError *error = nil;
    EMChatroom *chatroom = [[EMClient sharedClient].roomManager joinChatroom:@"chatroomId" error:&error];
    [[EMClient sharedClient].roomManager joinChatroom:@"" completion:^(EMChatroom *aChatroom, EMError *aError) {
    }];
    // 移除聊天室
    EMError *error = nil;
    [[EMClient sharedClient].roomManager leaveChatroom:@"chatroomId" error:&error];
    [[EMClient sharedClient].roomManager leaveChatroom:@"" completion:^(EMError *aError) {
}];
    // 获取聊天室详情
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager getChatroomSpecificationFromServerWithId:@"roomId"error:&error];
    [[EMClient sharedClient].roomManager getChatroomSpecificationFromServerWithId:@"" completion:^(EMChatroom *aChatroom, EMError *aError) {
    }];
    // 获取聊天室成员列表
    EMError *error = nil;
    EMCursorResult *result = [[EMClient sharedClient].roomManager getChatroomMemberListFromServerWithId:@"roomId" cursor:@"cursor" pageSize:50 error:&error];
    [[EMClient sharedClient].roomManager getChatroomMemberListFromServerWithId:@"" cursor:@"" pageSize:10 completion:^(EMCursorResult *aResult, EMError *aError) {
 }];
    // 获取聊天室黑名单
    EMError *error = nil;
    NSArray *list = [[EMClient sharedClient].roomManager getChatroomBlacklistFromServerWithId:@"roomId" pageNumber:1 pageSize:50 error:&error];
    [[EMClient sharedClient].roomManager getChatroomBlacklistFromServerWithId:@"" pageNumber:0 pageSize:10 completion:^(NSArray *aList, EMError *aError) {
    }];
    // 获取聊天室禁言列表
    EMError *error = nil;
    NSArray *list = [[EMClient sharedClient].roomManager getChatroomMuteListFromServerWithId:@"roomId" pageNumber:1 pageSize:50 error:&error];
    [[EMClient sharedClient].roomManager getChatroomMuteListFromServerWithId:@"" pageNumber:0 pageSize:10 completion:^(NSArray *aList, EMError *aError) {
    }];
    // 更新聊天室名称
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager updateSubject:@"newSubject" forChatroom:@"roomId" error:&error];
    [[EMClient sharedClient].roomManager updateSubject:@"" forChatroom:@"" completion:^(EMChatroom *aChatroom, EMError *aError) {
    }];
    // 更新聊天室说明
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager updateDescription:@"newDes" forChatroom:@"roomId" error:&error];
    [[EMClient sharedClient].roomManager getChatroomAnnouncementWithId:@"" completion:^(NSString *aAnnouncement, EMError *aError) {
    }];
    // 获取聊天室公告
    NSString *content=[[EMClient sharedClient].roomManager getChatroomAnnouncementWithId:@"" error:nil];
    [[EMClient sharedClient].roomManager getChatroomAnnouncementWithId:@"chatroomId"
                                                            completion:^(NSString *aAnnouncement, EMError *aError) {
                                                                if (!aError) {
                                                                    NSLog(@"获取成功");
                                                                }
                                                            }];
    // 更新聊天室公告
    EMChatroom *room=[[EMClient sharedClient].roomManager updateChatroomAnnouncementWithId:@"" announcement:@"" error:nil];
    [[EMClient sharedClient].roomManager updateChatroomAnnouncementWithId:@"chatroomId"
                                                             announcement:@"announcement"
                                                               completion:^(EMChatroom *aChatroom, EMError *aError) {
                                                                   if (!aError) {
                                                                       NSLog(@"修改成功");
                                                                   }
                                                               }];
    
    // 以下相关方法都有同步异步执行，就省略了

    // 将某成员移除聊天室
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager removeMembers:@[@"username"] fromChatroom:@"roomId" error:&error];
    // 将某成员加入黑名单
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager blockMembers:@[@"username"] fromChatroom:@"roomId" error:&error];
    // 将某成员移除黑名单
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager unblockMembers:@[@"username"] fromChatroom:@"roomId" error:&error];
    // 改变聊天室创建者时调用
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager updateChatroomOwner:@"roomId" newOwner:@"newOwner" error:&error];
    // 添加聊天室管理员
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager addAdmin:@"adminName" toChatroom:@"roomId" error:&error];
    // 移除聊天室管理员
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager removeAdmin:@"adminName" fromChatroom:@"roomId" error:&error];
    
    // 禁言聊天室成员
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager muteMembers:@[@"userName"] muteMilliseconds:100 aChatroomId:@"roomId" error:&error];
    
    // 解禁言聊天室成员
    EMError *error = nil;
    EMChatroom *room = [[EMClient sharedClient].roomManager unmuteMembers:@[@"userName"] fromChatroom:@"roomId" error:&error];

    // 添加dele <EMChatroomManagerDelegate>
    [[EMClient sharedClient].roomManager addDelegate:self delegateQueue:nil];
    // 移除dele
    [[EMClient sharedClient].roomManager removeDelegate:self];
    
    // 有用户加入聊天室后调用
    - (void)userDidJoinChatroom:(EMChatroom *)aChatroom user:(NSString *)aUsername{}
    // 有用户离开聊天室后调用
    - (void)userDidLeaveChatroom:(EMChatroom *)aChatroom user:(NSString *)aUsername{}
    // 被踢出聊天室后调用
    - (void)didDismissFromChatroom:(EMChatroom *)aChatroom reason:(EMChatroomBeKickedReason)aReason{}
    // 有成员被禁言时调用
    - (void)chatroomMuteListDidUpdate:(EMChatroom *)aChatroom addedMutedMembers:(NSArray *)aMutes muteExpire:(NSInteger)aMuteExpire{}
    // 有成员被移除禁言列表时调用
    - (void)chatroomMuteListDidUpdate:(EMChatroom *)aChatroom removedMutedMembers:(NSArray *)aMutes{}
    // 有成员被加入管理员列表时调用
    - (void)chatroomAdminListDidUpdate:(EMChatroom *)aChatroom addedAdmin:(NSString *)aAdmin
    // 有成员被移出管理员列表时调用
    - (void)chatroomAdminListDidUpdate:(EMChatroom *)aChatroom removedAdmin:(NSString *)aAdmin
    // 聊天室创建者更新时调用
    - (void)chatroomOwnerDidUpdate:(EMChatroom *)aChatroom newOwner:(NSString *)aNewOwner oldOwner:(NSString *)aOldOwner{}
    // 聊天室公告有更新时调用
    - (void)chatroomAnnouncementDidUpdate:(EMChatroom *)aChatroom announcement:(NSString *)aAnnouncement{}

通话

    // 1.option配置
    EMCallOptions *options = [[EMClient sharedClient].callManager getCallOptions];
    // 当对方不在线时，是否给对方发送离线消息和推送，并等待对方回应
    options.isSendPushIfOffline = NO;
    // 设置视频分辨率：自适应分辨率、352 * 288、640 * 480、1280 * 720
    options.videoResolution = EMCallVideoResolutionAdaptive;
    // 最大视频码率，范围 50 < videoKbps < 5000, 默认0, 0为自适应，建议设置为0
    options.maxVideoKbps = 0;
    // 最小视频码率
    options.minVideoKbps = 0;
    // 是否固定视频分辨率，默认为NO
    options.isFixedVideoResolution = NO;
    [[EMClient sharedClient].callManager setCallOptions:options];
    // 2.发起通话
    [[EMClient sharedClient].callManager startCall:EMCallTypeVideo remoteName:@"被呼叫的用户" ext:nil completion:^(EMCallSession *aCallSession, EMError *aError) {
        if(!aError){
        }
    }];
    // 2.同意通话
    EMError *error = nil;
    error = [[EMClient sharedClient].callManager answerIncomingCall:@"sessionId"];
    // 3.结束通话
    [[EMClient sharedClient].callManager endCall:@"sessionId" reason:EMCallEndReasonHangup];
    /
     EMCallEndReasonHangup   = 0,   对方挂断
    EMCallEndReasonNoResponse,      对方没有响应
    EMCallEndReasonDecline,         对方拒接
    EMCallEndReasonBusy,            对方占线
    EMCallEndReasonFailed,          失败
    EMCallEndReasonUnsupported,     功能不支持
    EMCallEndReasonRemoteOffline,   对方不在线
     /
    
    //
    EMCallSession *callSession=[EMCallSession new];
    // 本地视频
    callSession.localVideoView = [[EMCallLocalView alloc] initWithFrame:CGRectMake(0,0,0,0)];
    [self.view addSubview:callSession.localVideoView];
    // 对方视频
    callSession.remoteVideoView = [[EMCallRemoteView alloc] initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.height)];
    // 缩放Mode
    callSession.remoteVideoView.scaleMode = EMCallViewScaleModeAspectFill;
    [self.view addSubview:_callSession.remoteVideoView];
    
     // 暂停语音数据传输
    [callSession pauseVideo];
    // 恢复语音数据传输
    [callSession resumeVideo];
    // 暂停视图数据传输
    [callSession pauseVideo];
    // 恢复视频数据传输
    [callSession resumeVideo];
    // 是否使用前置摄像头,false:后置
    [callSession switchCameraPosition:true];

    // 添加dele  <EMCallManagerDelegate>
    [[EMClient sharedClient].callManager addDelegate:self delegateQueue:nil];
    // 移除dele
    [[EMClient sharedClient]removeDelegate:self];
    // 收到视频请求后调用
    - (void)callDidReceive:(EMCallSession *)aSession
    // 统一通话后双方都回调
    - (void)callDidConnect:(EMCallSession *)aSession
    // 对方同意通话后回调
    - (void)callDidAccept:(EMCallSession *)aSession
    // 通话结束（包括出现错误）双方都回调
    - (void)callDidEnd:(EMCallSession *)aSession reason:(EMCallEndReason)aReason error:(EMError *)aError{}
    // 对方中断或者继续数据流传输时调用
    - (void)callStateDidChange:(EMCallSession *)aSession type:(EMCallStreamingStatus)aType{}
    // 网络状态不稳定时调用
    - (void)callNetworkDidChange:(EMCallSession *)aSession status:(EMCallNetworkStatus)aStatus{}

    // 离线dele <EMCallBuilderDelegate>
    [[EMClient sharedClient].callManager setBuilderDelegate:self];
    - (void)callRemoteOffline:(NSString *)aRemoteName{
        
        //
        NSString *text = [[EMClient sharedClient].callManager getCallOptions].offlineMessageText;
        EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:text];
        NSString *fromStr = [EMClient sharedClient].currentUsername;
        EMMessage *message = [[EMMessage alloc] initWithConversationID:aRemoteName from:fromStr to:aRemoteName body:body ext:@{@"em_apns_ext":@{@"em_push_title":text}}];
        message.chatType = EMChatTypeChat;
        
        [[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
    }

多设备

    // 获取当前帐号在其他设备上的ID列表
    NSArray *otherPlatformIds = [[EMClient sharedClient].contactManager getSelfIdsOnOtherPlatformWithError:nil];
    if ([otherPlatformIds count] > 0) {
        NSString *chatter = otherPlatformIds[0];
        //获取会话
        EMConversation *conversation = [[EMClient sharedClient].chatManager getConversation:chatter type:EMConversationTypeChat createIfNotExist:YES];
        
        //发送消息
        NSString *sendText = @"test";
        EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:sendText];
        NSString *from = [[EMClient sharedClient] currentUsername];
        EMMessage *message = [[EMMessage alloc] initWithConversationID:conversation.conversationId from:from to:chatter body:body ext:nil];
        message.chatType = EMChatTypeChat;
        [[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
    }
    
    

    // <EMMultiDevicesDelegate>
    [[EMClient sharedClient] addMultiDevicesDelegate:self delegateQueue:nil];
    // 多设备收到好友时调用
    - (void)multiDevicesContactEventDidReceive:(EMMultiDevicesEvent)aEvent
username:(NSString *)aTarget
ext:(NSString *)aExt{
        NSString *message = [NSString stringWithFormat:@"%li-%@-%@", (long)aEvent, aTarget, aExt];
        UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:NSLocalizedString(@"alert.multi.contact", @"Contact Multi-devices") message:message delegate:self cancelButtonTitle:NSLocalizedString(@"ok", @"OK") otherButtonTitles:nil, nil];
        [alertView show];
    }
    // 多设备收到群组时调用
    - (void)multiDevicesGroupEventDidReceive:(EMMultiDevicesEvent)aEvent
groupId:(NSString *)aGroupId
ext:(id)aExt{
        NSString *message = [NSString stringWithFormat:@"%li-%@-%@", (long)aEvent, aGroupId, aExt];
        UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:NSLocalizedString(@"alert.multi.group", @"Group Multi-devices") message:message delegate:self cancelButtonTitle:NSLocalizedString(@"ok", @"OK") otherButtonTitles:nil, nil];
        [alertView show];
    }