浏览 SDKs · WASM
SDKsWASM

创建群组

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

复制

createGroup() 接收群资料以及初始普通成员、管理员和群主配置。

参数说明

参数类型是否必填说明
memberUserIDsstring[]是初始普通成员用户 ID。
adminUserIDsstring[]否初始管理员用户 ID。
ownerUserIDstring否群主用户 ID;省略时使用当前用户。
groupInfoPartial<GroupItem>是初始群资料。
groupInfo.groupNamestring否群名称;创建可展示群组时应提供。
groupInfo.groupTypeGroupType否群类型;常规群聊使用 GroupType.WorkingGroup。
groupInfo.faceURLstring否群头像地址。

普通成员、管理员和群主不能重复。应用应在调用前完成去重和交集检查。

import { GroupType } from '@openim/wasm-client-sdk';

const { data: group } = await openimsdk.createGroup({
  memberUserIDs: ['user-003', 'user-004'],
  adminUserIDs: ['user-002'],
  ownerUserID: currentUserID,
  groupInfo: {
    groupName: '项目讨论组',
    groupType: GroupType.WorkingGroup,
    faceURL: 'https://example.com/group.png',
  },
});

返回结果

Promise 成功后,data 是新建群组的 GroupItem。可以立即使用 groupID、groupName 和 faceURL 打开群资料或群聊页面;完整字段见分页获取已加入群组。

已加入群组列表的增量通过 OnJoinedGroupAdded 合并,完整监听见群组概览。