SDKsuni-app

查询指定群成员资料

按用户 ID 列表批量读取指定群成员。

getSpecifiedGroupMembersInfo() 批量查询指定用户在目标群组中的成员资料。

参数说明

参数	类型	是否必填	说明
`groupID`	`string`	是	目标群组 ID。
`userIDList`	`string[]`	是	要查询的成员用户 ID。

import { getSpecifiedGroupMembersInfo } from '@/uni_modules/unix-openim-sdk'

const result = await getSpecifiedGroupMembersInfo({
  groupID,
  userIDList,
})
const members = result?.members ?? []

Promise 成功后，result?.members 是匹配的 OpenIMGroupMemberItem[]，字段含义见分页查询群成员。返回数组不保证与输入 ID 按位置一一对应；结果也可能少于输入，未返回用户可能不在群内或不可访问。

同一用户在不同群中的昵称、角色和禁言状态可能不同，应按 groupID:userID 缓存，不要使用普通用户资料替代群成员资料。查询不会触发成员事件；后续增量见分页查询群成员。

这个页面有帮助吗？