管理群组属性
管理群组属性
群组是支持多人沟通的即时通讯系统,本文介绍如何使用环信即时通讯 IM SDK 在实时互动 app 中实现群组属性相关功能。
技术原理
环信即时通讯 IM iOS SDK 提供 IEMGroupManager
类和 EMGroup
类用于群组管理,支持你通过调用 API 在项目中实现如下功能:
- 修改群组名称及描述
- 创建、修改、获取群头像
- 获取、更新群组公告
- 管理群组共享文件
- 更新群扩展字段
前提条件
开始前,请确保满足以下条件:
实现方法
本节介绍如何使用环信即时通讯 IM SDK 提供的 API 实现上述功能。
修改群组名称
仅群主和群管理员可以调用 changeGroupSubject
方法设置和修改群组名称,其他群成员都会收到 EMGroupManagerDelegate#groupSpecificationDidUpdate
回调,群名称的长度限制为 128 个字符。
[[EMClient sharedClient].groupManager changeGroupSubject:@"subject"];
修改群组描述
仅群主和群管理员可以调用 changeDescription
方法设置和修改群组描述,其他群成员都会收到 EMGroupManagerDelegate#groupSpecificationDidUpdate
回调,群描述的长度限制为 512 个字符。
[[EMClient sharedClient].groupManager changeDescription:@"desc"
forGroup:@"groupID"
error:nil];
管理群组头像
自 iOS SDK 4.14.0 开始,支持群组头像功能。
设置群组头像
- 创建群组时,可设置群组头像:
EMGroupOptions *options = [[EMGroupOptions alloc] init];
NSString *groupAvatar = @"group avatar";
[EMClient.sharedClient.groupManager createGroupWithSubject:@"group name" avatar:groupAvatar description:@"group description" invitees:@[@"user1", @"user2"] message:@"group message" setting:options completion:^(EMGroup * _Nullable group, EMError * _Nullable error) {
}];
- 创建群组后,若设置群组头像,可调用 修改群组头像 API 设置头像。
修改群组头像
创建群组完成后,群主或管理员可调用 EMGroupManager#updateGroupAvatar
设置或修改群组头像:
[EMClient.sharedClient.groupManager updateGroupAvatar:@"new group avatar" groupId:@"groupId" completion:^(EMGroup * _Nullable group, EMError * _Nullable error) {
if(error == nil) {
// 更新成功
} else {
// 更新失败
}
}];
群头像被修改后,其他群成员会收到 EMGroupManagerDelegate#groupSpecificationDidUpdate
回调:
- (void)groupSpecificationDidUpdate:(EMGroup *)aGroup
{
// 群组信息更新
NSString *groupId = aGroup.groupId;
// 群组头像
NSString *groupAvatar = aGroup.groupAvatar;
}
获取群组头像
群成员可以通过获取群详情的方法,获取群组头像:
[EMClient.sharedClient.groupManager getGroupSpecificationFromServerWithId:@"groupId" completion:^(EMGroup * _Nullable aGroup, EMError * _Nullable aError) {
if (aError == nil) {
// 获取成功,群头像为
NSString *groupAvatar = aGroup.groupAvatar;
} else {
// 获取失败
}
}];
更新群公告
仅群主和群管理员可以调用 updateGroupAnnouncementWithId
方法设置和更新群公告,群公告的长度限制为 512 个字符。群公告更新后,其他群成员收到 EMGroupManagerDelegate#groupAnnouncementDidUpdate
回调。
示例代码如下:
// 同步方法,异步方法见 [EMGroupManager updateGroupAnnouncementWithId:announcement:completion:]
[[EMClient sharedClient].groupManager updateGroupAnnouncementWithId:@"groupID"
announcement:@"announcement"
error:nil];
获取群公告
所有群成员均可以调用 getGroupAnnouncementWithId
方法从服务器获取群公告。
示例代码如下:
// 同步方法,异步方法见 [EMGroupManager getGroupAnnouncementWithId:completion:]
[[EMClient sharedClient].groupManager getGroupAnnouncementWithId:@"groupID" error:nil];
管理共享文件
上传共享文件
所有群组成员均可以调用 uploadGroupSharedFileWithId
方法上传共享文件至群组,单个群共享文件大小限制为 10 MB。上传共享文件后,其他群成员收到 EMGroupManagerDelegate#addedSharedFile
回调。
示例代码如下:
// 异步方法
[[EMClient sharedClient].groupManager uploadGroupSharedFileWithId:@"groupID"
filePath:@"filePath"
progress:nil
completion:nil];
下载共享文件
所有群成员均可调用 downloadGroupSharedFileWithId
方法下载群组共享文件。
[EMClient.sharedClient.groupManager downloadGroupSharedFileWithId:@"groupId" filePath:@"filePath" sharedFileId:@"fileId" progress:nil completion:^(EMGroup * _Nullable aGroup, EMError * _Nullable aError) {
}];
删除共享文件
所有群成员均可以调用 removeGroupSharedFileWithId
方法删除群共享文件。删除共享文件后,其他群成员收到 EMGroupManagerDelegate#groupFileListDidUpdate
回调。
群主和群管理员可删除全部的群共享文件,群成员只能删除自己上传的群文件。
// 同步方法,异步方法见 [EMGroupManager removeGroupSharedFileWithId:sharedFileId:completion:]
[[EMClient sharedClient].groupManager removeGroupSharedFileWithId:@"groupID"
sharedFileId:@"fileID"
error:nil];
从服务器获取群组的共享文件
所有群成员均可以调用 getGroupFileListWithId
方法获取群共享文件。
// 同步方法,异步方法见 [EMGroupManager getGroupFileListWithId:pageNumber:pageSize:completion:]
[[EMClient sharedClient].groupManager getGroupFileListWithId:@"groupID"
pageNumber:pageNumber
pageSize:pageSize
error:nil];
更新群扩展字段
仅群主和群管理员可以调用 updateGroupExtWithId
方法更新群组的扩展字段,群组扩展字段设置 JSON 格式的数据,用于自定义更多群组信息。群扩展字段的长度限制为 8 KB。
示例代码如下:
// 同步方法,异步方法见 [EMGroupManager updateGroupExtWithId:ext:completion:]
[[EMClient sharedClient].groupManager updateGroupExtWithId:@"groupID"
ext:@"ext"
error:nil];
更多操作
详见监听群组事件。