浏览 SDKs · Android
SDKsAndroid

创建群组

使用 createGroup 创建群资料并指定初始成员、管理员和群主。

复制

使用 createGroup() 创建群组。GroupInfo 填写群资料;初始普通成员、管理员和群主分别通过独立参数传入。成功回调返回创建后的完整 GroupInfo,其中包含新群组的 groupID

参数说明

参数类型是否必填说明
memberUserIDsList<String>初始普通成员的用户 ID;没有普通成员时传空列表。
adminUserIDsList<String>初始管理员的用户 ID;不能与普通成员或群主重复。
infoGroupInfo要创建的群资料,至少设置业务所需的群名称等字段。
ownerUserIDString群主用户 ID;不能同时出现在成员或管理员列表中。
GroupInfo info = new GroupInfo();
info.setGroupName("项目讨论");
info.setIntroduction("仅限项目成员");

OpenIMClient.getInstance().groupManager.createGroup(
    memberUserIDs, adminUserIDs, info, ownerUserID,
    new OnBase<GroupInfo>() {
        @Override public void onSuccess(GroupInfo group) { /* group 包含新群组信息。 */ }
        @Override public void onError(int code, String error) { /* code 和 error 说明失败原因。 */ }
    }
);

返回结果

成功回调返回创建后的 GroupInfo。使用其中的 groupID 进入群聊、查询群资料或继续管理成员;不要在请求发出前自行生成并保存群组标识。

创建成功表示本次请求已经完成,不代表所有客户端已经更新群组列表。当前用户及相关成员随后可能通过 onJoinedGroupAdded 收到新增群组信息,应按 groupID 合并;完整 listener 见群组概览