浏览 SDKs · React Native
平台
SDKsReact Native

创建群组

OpenIM React Native SDK 创建群组。

复制

创建群组,并设置初始群成员、管理员和群主。

const 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',
  },
});

参数说明

参数类型必填含义
memberUserIDsstring[]是初始普通成员的用户 ID。
adminUserIDsstring[]否初始管理员的用户 ID。
ownerUserIDstring否群主用户 ID;不传时使用当前用户。
groupInfoPartial<GroupItem>是初始群资料。常用字段包括 groupName、groupType 和 faceURL。

普通成员、管理员和群主不能重复。groupInfo.groupType 使用 GroupType.WorkingGroup 创建普通群组。

返回结果

调用完成后返回新建群组的 GroupItem 对象。可直接使用返回对象中的 groupID 打开群资料或进入群聊。

群组创建成功后,创建者与被拉入的初始成员会收到 OnJoinedGroupAdded 事件通知。客户端应以 groupID 为合并标识将新群组加入已加入的群组列表,并以 groupID:userID 复合标识维护初始成员。完整事件监听说明见群组概览。