浏览 SDKs · uni-app / uni-app x
平台
SDKsuni-app / uni-app x

查询指定群成员资料

按用户 ID 查询其在目标群组中的成员资料。

复制

按用户 ID 列表批量查询指定群组内的成员资料,适用于在已知用户 ID 时读取其在群内的昵称、角色、头像及禁言状态。

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

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

groupID 和 userIDList 均为必填参数。Promise 成功后返回 OpenIMGroupMemberListResult | null;非空结果的 members 是匹配的 OpenIMGroupMemberItem[]。

结果数组不保证与输入 ID 按位置一一对应。同一用户在不同群组中的昵称、角色和禁言状态可能不同,应使用 groupID:userID 对应和缓存成员资料。字段含义见分页查询群成员。

查询只建立初始快照,不会触发群成员事件;页面保持活跃时,应通过分页查询群成员中说明的成员事件持续同步后续变化。