SDKsuni-app / uni-app x

查询用户入群状态

检查一组用户中哪些用户仍属于指定群组。

只需要判断成员关系、不需要完整群成员资料时，使用 getUsersInGroup()。

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

const presentUserIDs = await getUsersInGroup({
  groupID: groupID,
  userIDList: candidateUserIDs,
})

const confirmedUserIDs = presentUserIDs != null ? presentUserIDs : []

groupID 是目标群组 ID，userIDList 是待检查的用户 ID 数组。Promise 成功后返回 string[] | null；非空数组只包含输入用户中仍属于该群组的用户 ID，不返回完整成员资料。

该查询只反映调用时的状态，不会触发成员事件。需要持续维护成员列表时，应使用分页查询群成员并监听成员变化。

这个页面有帮助吗？