浏览 SDKs · Android
平台
SDKsAndroid

分页获取已加入群组

分页读取当前登录用户已加入的群组列表。

复制

分页获取当前登录用户已加入的所有群组列表。通过指定起始偏移量与拉取条数分批读取,用于通讯录群聊列表或选群组件展示。

int offset = 0;
int count = 20;

OpenIMClient.getInstance().groupManager.getJoinedGroupListPage(
    new OnBase<List<GroupInfo>>() {
        @Override
        public void onSuccess(List<GroupInfo> groups) {
            // groups 为当前页群组列表
        }

        @Override
        public void onError(int code, String error) {
            // 处理获取失败
        }
    },
    offset,
    count
);

参数说明

参数类型是否必填说明
baseOnBase<List<GroupInfo>>是异步请求回调。
offsetint是分页起始偏移量,首页从 0 开始。
countint是本次获取的最大记录条数。

返回结果

成功回调返回已加入群组资料列表 List<GroupInfo>。单条群资料的核心字段包含:

字段说明
groupID群组全局唯一 ID。
groupName群组名称。
faceURL群组头像地址。
memberCount群成员总人数。
ownerUserID群主用户 ID。
status群状态(0 正常,1 被封禁,2 已解散)。

客户端应以 groupID 为标识进行本地群组列表的合并与去重。后续加群或退群时,SDK 会通过 onJoinedGroupAdded 与 onJoinedGroupDeleted 推送增量事件;完整监听见群组概览。