分页查询对讲群组视角的成员(pageForTalkGroup)

验证状态:已源码核验、未联调;适用基线:源码归纳 @ 2026-09-14

用途与场景

按群组维度分页读取群组及其成员(记录仪)列表,同时返回 SFU/设备 PTT 在线状态快照。本页是 http-post-main-service-main-api-basedata-talk-group-data-acquisition-device-pagefortalkgroup-312fe231 的唯一操作正本。返回的在线状态是查询时刻的缓存快照,不是实时订阅。

使用位置

页面/功能 角色或空间分支
群组卡片列表主查询 需要 talk-group-data-acquisition-device:read 或 administrator(前端 canReverseBind
设备面板的群组候选列表(强制 janusNo: "" 同上

端点

POST /main-service/main-api/basedata/talk-group-data-acquisition-device/pageForTalkGroup — 按群组维度分页读取群组及其成员(记录仪)列表,同时返回 SFU/设备 PTT 在线状态快照。

端点全量事实(参数、请求/响应字段、错误码、权限点)见清单层 basedata · talk-group-data-acquisition-device 对讲组与采集设备关联;业务语义(wire 惯例、限频、租户声明等)见基础数据业务 · talk-group-data-acquisition-device 对讲组与采集设备关联

动线与完成判据

status=200data 为数组即查询成功;空列表是合法结果(无群组或数据权限过滤后为空)。在线状态仅反映缓存快照;实时性由 MQTT 在线状态通道另行刷新(见 list-online-status 正本)。

错误与边界

  • 认证/权限失败适用认证失败权限失败
  • 无 Bean Validation 注解的字段(如 current 非法负数)由服务端钳制,不报 400。
  • sfuOnlineStatus/pttOnlineStatus 为 false 时不能区分"离线"与"未知":缓存键缺失即按 FALSE 填充(fillOnlineStatusesBoolean.TRUE.equals)。

调用关系与资源清理

已知缺口

  1. 未执行真实 HTTP/数据库联调;mapper SQL 的模糊匹配与排序细节未逐字段核验(pageForTalkGroup SQL 未读)。
  2. 在线状态快照的时效(缓存写入方与过期)属在线状态通道正本,本页不承诺刷新间隔。