创建群组

创建普通群与查询群资料；群成员上限 3000，超出请使用超级群。

平台调用风格

进程模型：main（IMLib 客户端 + 本地 SQLite，单写者）/ preload（contextBridge 白名单）/ renderer（薄代理，不直连网络与数据库）。异步接口返回 Promise<RcResult<T>>。

接口一览

操作	语义	传输	返回
`createGroup`	创建群（groupType 缺省 normal；joinPolicy 缺省 open；maxMembers 对 super 有效）。groupId 可由调用方指定（唯一）或服务端生成。	REST（客户端）	`Group`
`getGroupsInfo`	批量查询群信息（<=20）。	REST（客户端）	`Group[]`

本页 2 个操作，其中 2 个在本平台绑定中声明了方法签名。

操作	Android	Web	Electron	macOS	Flutter	Native (C ABI)	iOS
`createGroup`	`createGroup`	`createGroup`	`createGroup`	`createGroup`	`createGroup`	—	`func`
`getGroupsInfo`	`getGroupsInfo`	`getGroupsInfo`	`getGroupsInfo`	`getGroupsInfo`	`getGroupsInfo`	—	`func`

方法名在 GA 平台之间保持一致（规则 A）；Native C ABI 只覆盖部分操作，其余操作以 — 标注。

创建群（groupType 缺省 normal；joinPolicy 缺省 open；maxMembers 对 super 有效）。groupId 可由调用方指定（唯一）或服务端生成。

createGroup(options: {groupId?: string; name: string; owner?: string; members?: string[]; groupType?: GroupType}): Promise<RcResult<Group>>

REST（客户端）since 1.0.0

参数

参数	类型	说明
`options`	`{groupId?:string, name:string, owner?:string, members?:string[], groupType?:GroupType, joinPolicy?:JoinPolicy, maxMembers?:int}`	必填；选项对象（字段见类型列）：{ groupId?:string, name:string, owner?:string, members?:string[], groupType?:GroupType, joinPolicy?:JoinPolicy, maxMembers?:int }

Group 群资料

示例

const res = await client.createGroup({ name: '产品群' });
if (res.code !== 0) throw new Error(res.msg);
const data = res.data;

错误码

批量查询群信息（<=20）。

getGroupsInfo(groupIds: string[]): Promise<RcResult<Group[]>>

REST（客户端）since 1.0.0

参数

参数	类型	说明
`groupIds`	`string[]`	必填；群组 ID 列表

Group[] 群资料列表

示例

const res = await client.getGroupsInfo(['g_1001']);
if (res.code !== 0) throw new Error(res.msg);
const data = res.data;

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误