浏览 SDKs · Android
平台
SDKsAndroid

创建群组

创建群组并配置初始成员、管理员及群主。

复制

创建群组并配置初始群资料。通过 GroupInfo 设置群名称、简介等基础信息,并通过对应参数指定初始普通成员、管理员和群主。成功回调返回创建完成的完整 GroupInfo,其中包含服务端分配的群组唯一标识 groupID。

GroupInfo info = new GroupInfo();
info.setGroupName("项目讨论");
info.setIntroduction("仅限项目成员");

List<String> memberUserIDs = Arrays.asList("user_a", "user_b");
List<String> adminUserIDs = Arrays.asList("user_c");
String ownerUserID = "user_owner";

OpenIMClient.getInstance().groupManager.createGroup(
    memberUserIDs,
    adminUserIDs,
    info,
    ownerUserID,
    new OnBase<GroupInfo>() {
        @Override
        public void onSuccess(GroupInfo group) {
            // group 包含新群组信息与 groupID
        }

        @Override
        public void onError(int code, String error) {
            // 处理创建失败
        }
    }
);

参数说明

参数类型是否必填说明
memberUserIDsList<String>否初始普通成员的用户 ID 列表;没有普通成员时可传空列表。
adminUserIDsList<String>否初始管理员的用户 ID 列表;不能与普通成员或群主重复。
infoGroupInfo是要创建的群资料对象,至少设置群名称 groupName 等必要属性。
ownerUserIDString是指定群主的用户 ID;不能同时出现在普通成员或管理员列表中。
baseOnBase<GroupInfo>是异步请求回调。

返回结果

成功回调返回创建后的 GroupInfo。获取其中的 groupID 用于发起群聊、查询群资料或管理成员。

创建成功代表服务端建群操作已完成。当前用户及相关成员随后会通过 onJoinedGroupAdded 事件接收新增群组通知,客户端应按 groupID 进行状态合并;完整监听见群组概览。