更新时间：2022-07-13
群组是支持多人沟通的即时通讯系统，本文指导你如何使用环信即时通讯 IM Android SDK 在实时互动 app 中实现群组属性相关功能。
环信即时通讯 IM Android SDK 提供 EMGroupManager 类和 EMGroup 类用于群组管理，支持你通过调用 API 在项目中实现如下功能：
本节介绍如何使用环信即时通讯 IM Android SDK 提供的 API 实现上述功能。
仅群主和群管理员可以调用 changeGroupName 方法设置和修改群组名称，群名称的长度限制为 128 个字符。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncChangeGroupName(String, String, EMCallBack)}。
EMClient.getInstance().groupManager().changeGroupName(groupId,changedGroupName);
仅群主和群管理员可以调用 changeGroupDescription 方法设置和修改群组描述，群描述的长度限制为 512 个字符。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncChangeGroupDescription(String, String, EMCallBack)}。
EMClient.getInstance().groupManager().changeGroupDescription(groupId,description);
仅群主和群管理员可以调用 updateGroupAnnouncement 方法设置和更新群公告，群公告的长度限制为 512 个字符。群公告更新后，其他群成员收到 EMGroupChangeListener#onAnnouncementChanged 回调。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncUpdateGroupAnnouncement(String, String, EMCallBack)}。
EMClient.getInstance().groupManager().updateGroupAnnouncement(groupId, announcement);
所有群成员均可以调用 fetchGroupAnnouncement 方法从服务器获取群公告。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncFetchGroupAnnouncement(String, EMValueCallBack)}。
EMClient.getInstance().groupManager().fetchGroupAnnouncement(groupId);
所有群组成员均可以调用 uploadGroupSharedFile 方法上传共享文件至群组，群共享文件大小限制为 10 MB。上传共享文件后，其他群成员收到 EMGroupChangeListener#OnSharedFileAddedFromGroup 回调。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncUploadGroupSharedFile(String, String, EMCallBack)}。
EMClient.getInstance().groupManager().uploadGroupSharedFile(groupId, filePath, callBack);
所有群成员均可以调用 DeleteGroupSharedFile 方法删除群共享文件。删除共享文件后，其他群成员收到 EMGroupChangeListener#OnSharedFileDeletedFromGroup 回调。
群主和群管理员可删除全部的群共享文件，群成员只能删除自己上传的群文件。
示例代码如下：
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncDeleteGroupSharedFile(String, String, EMCallBack)}。
EMClient.getInstance().groupManager().deleteGroupSharedFile(groupId, fileId);
所有群成员均可以调用 fetchGroupSharedFileList 方法从服务器获取群组的共享文件列表。
// 同步方法，会阻塞当前线程。
// 异步方法见 {@link #asyncFetchGroupSharedFileList(String, int, int, EMValueCallBack)}。
EMClient.getInstance().groupManager().fetchGroupSharedFileList(groupId, pageNum, pageSize);
仅群主和群管理员可以调用 updateGroupExtension 方法更新群组的扩展字段，群组扩展字段设置 JSON 格式的数据，用于自定义更多群组信息。群扩展字段的长度限制为 8 KB。
示例代码如下：
// 同步方法，会阻塞当前线程。
EMClient.getInstance().groupManager().updateGroupExtension(groupId, extension);
你可以参考如下文档，在项目中实现更多的群组相关功能：