浏览 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。可以立即使用 groupIDgroupNamefaceURL 打开群资料或群聊页面;完整字段见分页获取已加入群组

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