浏览 SDKs · WASM
SDKsWASM

分页获取已加入群组

分页查询当前用户已加入的群组。

复制

getJoinedGroupListPage() 适合群组数量较多的列表。

参数说明

参数类型是否必填说明
offsetnumber起始偏移量,第一页传 0
countnumber本次读取数量。
const { data: firstPage } = await openimsdk.getJoinedGroupListPage({
  offset: 0,
  count: 50,
});

返回结果

Promise 成功后,data 是当前页 GroupItem[]。继续加载时按已经请求的条目数增加 offset,不要使用事件合并后的数组长度。

群资料字段

字段类型说明
groupIDstring群组的稳定 ID,也是群组列表和事件的合并标识。
groupNamestring群名称。
faceURLstring群头像地址。
introductionstring群简介。
notificationstring当前群公告内容。
notificationUserIDstring最近更新群公告的用户 ID。
notificationUpdateTimenumber群公告最近更新时间。
ownerUserIDstring当前群主的用户 ID。
creatorUserIDstring创建群组的用户 ID。
createTimenumber群组创建时间。
memberCountnumber当前群成员数量快照。
groupTypeGroupType群组类型。
statusGroupStatus群组当前状态,例如正常、封禁、解散或全员禁言。
needVerificationGroupVerificationType加群是否需要审核的策略。
applyMemberFriendAllowType群成员之间是否允许发起好友申请。
lookMemberInfoAllowType普通成员是否可以查看其他群成员资料。
displayIsReadboolean该群是否展示群消息已读状态;浏览器客户端不能通过群资料 API 修改此字段。
exstring业务约定的群组扩展字符串。

群名称、头像和成员数都是调用时的快照。列表打开期间通过群组事件按 groupID 合并变化;需要权限判断时,不要只依赖旧缓存。

分页期间收到群组新增或删除事件时,应重置分页并从第一页重新加载;完整事件处理见群组概览