群成员查询概览

群成员资料由 GroupMembersInfo 对象表示。同一个用户在不同群组中的群昵称、角色等级和禁言状态各不相同，因此本地缓存管理与增量事件合并均必须使用复合标识 groupID:userID 作为唯一主键。

查询入口

• 分页查询群成员
• 查询指定群成员资料
• 查询用户入群状态
• 搜索群成员
• 获取群主和管理员

查询接口仅负责获取当前群成员的数据快照，不会触发群成员事件通知。在分页拉取群成员期间若发生人员变动，建议重置分页偏移量并重新拉取第一页数据。

成员事件

Flutter 的群成员变更通知统一通过全局的 OnGroupListener 接收。新成员入群（onGroupMemberAdded）、成员退群或被移出（onGroupMemberDeleted）以及成员资料变更（onGroupMemberInfoChanged）均应基于复合标识 groupID:userID 幂等合并本地状态；这些事件可能由其他端或其他成员操作触发，不能视为某个本地调用的专属回调。

全局 listener 的集中设置与解绑清理入口请参考事件概览。