SDKsWASM
分页获取已加入群组
分页查询当前用户已加入的群组。
getJoinedGroupListPage() 适合群组数量较多的列表。
参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
offset | number | 是 | 起始偏移量,第一页传 0。 |
count | number | 是 | 本次读取数量。 |
const { data: firstPage } = await openimsdk.getJoinedGroupListPage({
offset: 0,
count: 50,
});返回结果
Promise 成功后,data 是当前页 GroupItem[]。继续加载时按已经请求的条目数增加 offset,不要使用事件合并后的数组长度。
群资料字段
| 字段 | 类型 | 说明 |
|---|---|---|
groupID | string | 群组的稳定 ID,也是群组列表和事件的合并标识。 |
groupName | string | 群名称。 |
faceURL | string | 群头像地址。 |
introduction | string | 群简介。 |
notification | string | 当前群公告内容。 |
notificationUserID | string | 最近更新群公告的用户 ID。 |
notificationUpdateTime | number | 群公告最近更新时间。 |
ownerUserID | string | 当前群主的用户 ID。 |
creatorUserID | string | 创建群组的用户 ID。 |
createTime | number | 群组创建时间。 |
memberCount | number | 当前群成员数量快照。 |
groupType | GroupType | 群组类型。 |
status | GroupStatus | 群组当前状态,例如正常、封禁、解散或全员禁言。 |
needVerification | GroupVerificationType | 加群是否需要审核的策略。 |
applyMemberFriend | AllowType | 群成员之间是否允许发起好友申请。 |
lookMemberInfo | AllowType | 普通成员是否可以查看其他群成员资料。 |
displayIsRead | boolean | 该群是否展示群消息已读状态;浏览器客户端不能通过群资料 API 修改此字段。 |
ex | string | 业务约定的群组扩展字符串。 |
群名称、头像和成员数都是调用时的快照。列表打开期间通过群组事件按 groupID 合并变化;需要权限判断时,不要只依赖旧缓存。
分页期间收到群组新增或删除事件时,应重置分页并从第一页重新加载;完整事件处理见群组概览。
这个页面有帮助吗?