差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
im:android:basics:group [2020/06/19 08:48] liujn [新建群组] |
im:android:basics:group [2022/06/28 07:16] (当前版本) jennifer.zeng [屏蔽群消息] |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| ====== 群组管理 ====== | ====== 群组管理 ====== | ||
| + | |||
| + | 更新时间：2021-12-31 | ||
| + | |||
| + | 新版文档见：[[ccim:android:group1|群组]]。 | ||
| + | |||
| + | ---- | ||
| + | |||
| 许多群组操作前需要鉴别权限，包括当前用户是否在群里面，是否拥有管理员或者所有者权限。 | 许多群组操作前需要鉴别权限，包括当前用户是否在群里面，是否拥有管理员或者所有者权限。 | ||
| - | 建议用户登录成功后，调用EMClient.getInstance().groupManager().getJoinedGroupsFromServer(); | + | 建议用户登录成功后，调用 EMClient.getInstance().groupManager().getJoinedGroupsFromServer(); |
| 刷新本地群组列表，确保鉴别权限正常工作。 | 刷新本地群组列表，确保鉴别权限正常工作。 | ||
| - | SDK3.3.0 release新增许多群组操作的API，请查看链接[[im:200androidclientintegration:3.3.0apichange|3.3.0api修改]] | + | SDK 3.3.0 release 新增许多群组操作的 API，请查看链接 [[im:200androidclientintegration:3.3.0apichange|3.3.0 api 修改]] |
| - | **注意**：''1、群主+管理员 一起一共不超过100个，也就是不超过99个管理员。2、群组成员最大数（包括群主），默认值200，最大值2000。'' | + | **注意**：''1、群主+管理员 一起一共不超过 100 个，也就是不超过 99 个管理员。2、群组成员最大数（包括群主）取决于所选择的版本，不同版本最大数不同。'' |
| ---- | ---- | ||
| ===== 收发消息 ===== | ===== 收发消息 ===== | ||
| - | 收发消息及聊天记录相关等见[[im:android:basics:message|消息]]。 | + | 收发消息及聊天记录相关内容等详见 [[im:android:basics:message|消息]]。 |
| ===== 新建群组 ===== | ===== 新建群组 ===== | ||
| 行 19: | 行 26: | ||
| * @param groupName 群组名称 | * @param groupName 群组名称 | ||
| * @param desc 群组简介 | * @param desc 群组简介 | ||
| - | * @param allMembers 群组初始成员，如果只有自己传空数组即可 | + | * @param allMembers 群组初始成员，如果只有自己传空数组即可（最多可以传100个成员） |
| * @param reason 邀请成员加入的reason | * @param reason 邀请成员加入的reason | ||
| - | * @param option 群组类型选项，可以设置群组最大用户数(默认200，最大值2000)及群组类型@see {@link EMGroupStyle} | + | * @param option 群组类型选项，可以设置群组最大用户数(取决于所选择的版本，不同版本最大数不同)及群组类型@see {@link EMGroupStyle} |
| - | * option.inviteNeedConfirm表示邀请对方进群是否需要对方同意，默认是需要用户同意才能加群的。 | + | * option.inviteNeedConfirm表示邀请对方进群是否需要对方同意，默认是被邀请方自动进群。 |
| * option.extField创建群时可以为群组设定扩展字段，方便个性化订制。 | * option.extField创建群时可以为群组设定扩展字段，方便个性化订制。 | ||
| * @return 创建好的group | * @return 创建好的group | ||
| 行 33: | 行 40: | ||
| EMClient.getInstance().groupManager().createGroup(groupName, desc, allMembers, reason, option); | EMClient.getInstance().groupManager().createGroup(groupName, desc, allMembers, reason, option); | ||
| </code> | </code> | ||
| + | 注：如果option.inviteNeedConfirm设置为false,即直接加被邀请人进群。在此情况下，被邀请人设置非自动进群是不起作用的。 | ||
| + | |||
| option里的GroupStyle分别为： | option里的GroupStyle分别为： | ||
| 行 178: | 行 187: | ||
| ===== 屏蔽群消息 ===== | ===== 屏蔽群消息 ===== | ||
| - | 不允许 Owner 权限的调用。 | + | |
| <code java> | <code java> | ||
| /** | /** | ||
| 行 250: | 行 259: | ||
| */ | */ | ||
| EMClient.getInstance().groupManager().muteGroupMembers(String groupId, List<String> muteMembers, long duration);//需异步处理 | EMClient.getInstance().groupManager().muteGroupMembers(String groupId, List<String> muteMembers, long duration);//需异步处理 | ||
| - | 目前duration参数不起作用，暂时只支持永久禁言和解除禁言两种操作, duration建议输入12*30*24*60*60*1000 | ||
| </code> | </code> | ||