浏览 SDKs · Android
平台
SDKsAndroid

分页查询群成员

按成员角色和分页条件读取指定群组的成员列表。

复制

分页获取指定群组的群成员列表。支持通过角色过滤器筛选全部成员、普通成员、群主或管理员,适用于群成员列表展示、选人提及等业务场景。

String groupID = "group_123";
int filter = 0; // 0 表示查询全部成员
int offset = 0;
int count = 50;

OpenIMClient.getInstance().groupManager.getGroupMemberList(
    new OnBase<List<GroupMembersInfo>>() {
        @Override
        public void onSuccess(List<GroupMembersInfo> members) {
            // members 为当前页成员列表
        }

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

角色过滤说明

filter 字段用于筛选不同角色的群成员:

筛选值含义
0查询全部群成员。
1仅查询普通成员。
2仅查询群主。
3仅查询管理员。

参数说明

参数类型是否必填说明
baseOnBase<List<GroupMembersInfo>>是异步请求回调。
groupIDString是目标群组全局唯一 ID。
filterint是成员角色筛选过滤条件。
offsetint是分页起始偏移量,首页从 0 开始。
countint是本次获取的最大记录条数。

返回结果

成功回调返回群成员资料列表 List<GroupMembersInfo>。单条成员资料的核心字段包含:

字段说明
groupID群组 ID。
userID成员用户 ID。
nickname成员在群内的展示昵称。
faceURL成员在群内的头像地址。
roleLevel角色等级:20 为普通成员,60 为管理员,100 为群主。
joinTime入群毫秒级时间戳。
muteEndTime禁言截止毫秒级时间戳(0 表示未被禁言)。

客户端应以 groupID:userID 为组合键进行本地成员缓存的去重与维护。成员变动事件的监听见群组概览。