浏览 SDKs · Android
平台
SDKsAndroid

查询用户入群状态

从候选用户列表中筛选已加入指定群组的用户 ID。

复制

从一组候选用户中快速筛选出当前已加入指定群组的用户 ID 列表。常用于发起群邀请前的前置校验,以剔除已在群内的成员。

String groupID = "group_123";
List<String> candidateUserIDs = Arrays.asList("user_a", "user_b", "user_c");

OpenIMClient.getInstance().groupManager.getUsersInGroup(
    new OnBase<List<String>>() {
        @Override
        public void onSuccess(List<String> joinedUserIDs) {
            // joinedUserIDs 为候选名单中已在群内的用户 ID 列表
        }

        @Override
        public void onError(int code, String error) {
            // 处理查询失败
        }
    },
    groupID,
    candidateUserIDs
);

参数说明

参数类型是否必填说明
baseOnBase<List<String>>是异步请求回调。
groupIDString是目标群组全局唯一 ID。
candidateUserIDsList<String>是待校验的候选用户 ID 列表。建议传入前剔除空字符串及重复项。

返回结果

成功回调返回已在群内的用户 ID 列表 List<String>。

本接口仅返回在群用户的 ID 集合,不包含成员群内昵称或角色等级等详细资料。若需进一步读取对应成员在群内的详细信息,请参阅查询指定群成员资料。