管理群组属性
管理群组属性
群组是支持多人沟通的即时通讯系统,本文介绍如何使用环信即时通讯 IM Flutter SDK 在实时互动 app 中实现群组属性相关功能。
技术原理
环信即时通讯 IM Flutter SDK 提供 EMGroup
、EMGroupManager
和 EMGroupEventHandler
类用于群组管理,支持你通过调用 API 在项目中实现如下功能:
- 修改群组名称、描述
- 获取、设置和修改群头像
- 获取、更新群组公告
- 管理群组共享文件
- 更新群扩展字段
前提条件
开始前,请确保满足以下条件:
实现方法
本节介绍如何使用环信即时通讯 IM Flutter SDK 提供的 API 实现上述功能。
修改群组名称
仅群主和群管理员可以调用 EMGroupManager#updateGroupName
方法设置和修改群组名称,群名称的长度限制为 128 个字符, 其他成员会收到 EMGroupEventHandler#onSpecificationDidUpdate
回调。
示例代码如下:
try {
await EMClient.getInstance.groupManager.updateGroupName(
groupId,
newName,
);
} on EMError catch (e) {
}
修改群组描述
仅群主和群管理员可以调用 EMGroupManager#updateGroupDesc
方法设置和修改群组描述,群描述的长度限制为 512 个字符, 其他成员会收到 EMGroupEventHandler#onSpecificationDidUpdate
回调。
示例代码如下:
try {
await EMClient.getInstance.groupManager.updateGroupDesc(
groupId,
newDesc,
);
} on EMError catch (e) {
}
管理群组头像
自 Flutter SDK 4.15.0 开始,支持群组头像功能。
设置群组头像
- 创建群组时,可设置群组头像:
try {
await EMClient.getInstance.groupManager.createGroup(
groupName: "groupName",
avatarUrl: "avatarUrl",
);
} on EMError catch (e) {
}
- 创建群组后,若设置群组头像,可调用 修改群组头像 API 设置头像。
修改群组头像
创建群组完成后,群主或管理员可调用 EMGroupManager#updateGroupAvatarUrl
设置或修改群组头像:
try {
await EMClient.getInstance.groupManager.updateGroupAvatarUrl(
groupId: 'groupId',
avatarUrl: 'avatarUrl',
);
} on EMError catch (e) {}
群组头像被修改后,其他群成员会收到 EMGroupEventHandler#onSpecificationDidUpdate
回调:
EMClient.getInstance.groupManager.addEventHandler(
'UNIQUE_HANDLER_ID',
EMGroupEventHandler(
onSpecificationDidUpdate: (group) {},
),
);
获取群组头像
群成员可以通过获取群详情的方法 EMGroupManager#fetchGroupInfoFromServer
,获取群组头像:
try {
EMGroup group =
await EMClient.getInstance.groupManager.fetchGroupInfoFromServer(
'groupId',
);
String? avatarUrl = group.avatarUrl;
} on EMError catch (e) {}
更新群公告
仅群主和群管理员可以调用 EMGroupManager#updateGroupAnnouncement
方法设置和更新群公告,群公告的长度限制为 512 个字符。群公告更新后,其他群成员收到 EMGroupEventHandler#onAnnouncementChangedFromGroup
事件。
示例代码如下:
try {
await EMClient.getInstance.groupManager.updateGroupAnnouncement(
groupId,
newAnnouncement,
);
} on EMError catch (e) {
}
获取群公告
所有群成员均可以调用 EMGroupManager#fetchAnnouncementFromServer
方法从服务器获取群公告。
示例代码如下:
try {
String? announcement =
await EMClient.getInstance.groupManager.fetchAnnouncementFromServer(
groupId,
);
} on EMError catch (e) {
}
管理共享文件
上传共享文件
所有群组成员均可以调用 EMGroupManager#uploadGroupSharedFile
方法上传共享文件至群组,单个群共享文件大小限制为 10 MB。上传共享文件后,其他群成员收到 EMGroupEventHandler#onSharedFileAddedFromGroup
事件。
示例代码如下:
try {
await EMClient.getInstance.groupManager.uploadGroupSharedFile(
groupId,
filePath,
);
} on EMError catch (e) {
}
下载共享文件
所有群成员均可调用 downloadGroupSharedFile
方法下载群组共享文件。
try {
// 获取文件列表
List<EMGroupSharedFile> list =
await EMClient.getInstance.groupManager.fetchGroupFileListFromServer(
groupId,
pageNum: 1,
pageSize: 10,
);
if (list.isNotEmpty) {
await EMClient.getInstance.groupManager.downloadGroupSharedFile(
groupId: groupId,
fileId: list.first.fileId!,
savePath: savePath,
);
}
} on EMError catch (e) {
debugPrint('$e');
}
删除共享文件
所有群成员均可以调用 EMGroupManager#removeGroupSharedFile
方法删除群共享文件。删除共享文件后,其他群成员收到 EMGroupEventHandler#onSharedFileDeletedFromGroup
事件。
群主和群管理员可删除全部的群共享文件,群成员只能删除自己上传的群文件。
示例代码如下:
try {
await EMClient.getInstance.groupManager.removeGroupSharedFile(
groupId,
fileId,
);
} on EMError catch (e) {
}
从服务器获取共享文件
所有群成员均可以调用 EMGroupManager#fetchGroupFileListFromServer
方法从服务器获取群组的共享文件列表。
示例代码如下:
try {
List<EMGroupSharedFile> list =
await EMClient.getInstance.groupManager.fetchGroupFileListFromServer(
groupId,
pageNum: pageNum,
pageSize: pageSize,
);
} on EMError catch (e) {
}
更新群扩展字段
仅群主和群管理员可以调用 EMGroupManager#updateGroupExtension
方法更新群组的扩展字段,群组扩展字段设置 JSON 格式的数据,用于自定义更多群组信息。群扩展字段的长度限制为 8 KB。
示例代码如下:
try {
await EMClient.getInstance.groupManager.updateGroupExtension(
groupId,
extension,
);
} on EMError catch (e) {
}
监听群组事件
详见 监听群组事件。