StatusPanel 副面板
约 2596 字
StatusPanel 位于 ControlBoard 与主场地画面之间,用于集中查看视觉和策略帧率、录制状态、网络端口、系统负载及裁判数据。它还提供紧急终止和球速曲线,适合在启动、比赛和问题排查时快速判断整条数据链路是否正常。

信息总览
| 区域 | 主要内容 | 优先检查时机 |
|---|---|---|
| FPS | Vision、蓝方 Medusa、黄方 Medusa 的数据帧率 | 视觉连接后、启动策略后 |
| LOG | 开始/停止 REC 录制、LOG 总大小和当前文件大小 | 测试开始前、磁盘空间告警时 |
| Network | Vision 端口、Referee 端口和本机 IP | 没有视觉或裁判数据时 |
| Performance | CPU 核心数、CPU 使用率、内存与缓存 | Client 卡顿、帧率下降时 |
| Game Data | 比分、允许上场数、裁判指令、阶段时间和判罚 | 正式比赛和裁判联调时 |
| Process Kill | 停止受管进程并退出 Client | 环境异常或测试结束时 |
| Ball Speed | 处理后的球速历史和速度限制线 | 射门测试、视觉数据检查时 |
推荐检查顺序
连接 Vision 后看 FPS
Vision应持续出现稳定帧率。若为0,先检查 Vision 页面中的网卡、数据源 IP、相机和 Simulation / Real 模式。启动 Medusa 后看对应颜色
启动蓝方后检查
Blue,启动黄方后检查Yellow。策略进程已经拉起但帧率仍为0,通常表示 Client 没有收到对应队伍的数据。核对网络与裁判数据
根据 Network 中的本机 IP 和端口确认配置,再检查 Game Data 中的指令、比分和阶段时间是否持续更新。
观察系统负载
FPS 波动或界面卡顿时查看 CPU 和 Memory。如果系统资源长期处于黄色或红色,应先关闭无关程序并检查残留进程。
测试前开启录制
点击
REC后确认按钮变为STOP,需要复盘的现象结束后再停止录制。
FPS

| 项目 | 数据来源 | 为 0 时优先检查 |
|---|---|---|
| Vision | Client 收到的视觉数据帧率 | Vision 是否连接、网卡、视觉源 IP、相机选择和运行模式 |
| Blue | Client 收到的蓝方 Medusa 数据频率 | 蓝方 Medusa 是否启动、队伍颜色和进程状态 |
| Yellow | Client 收到的黄方 Medusa 数据频率 | 黄方 Medusa 是否启动、队伍颜色和进程状态 |
进度条以 60 FPS 作为满格参考,并按数值使用灰、红、黄、绿提示状态。颜色只适合快速发现明显异常,不应脱离当前视觉源和策略发送频率单独判断;稳定性通常比某一瞬间的具体数值更重要。
用 FPS 缩小排查范围
Vision 为 0 而 Medusa 已启动时,先排查视觉链路;Vision 正常而本方 Medusa 为 0 时,再排查策略进程。这样可以快速区分“没有输入数据”和“策略没有输出数据”。
网络与性能信息

Network 与 Performance
核对通信端口、本机 IP 和系统资源占用
Network
| 字段 | 含义 |
|---|---|
| Vision | 当前运行模式使用的视觉端口;Simulation 和 Real 会读取不同配置 |
| Referee | Client 配置的裁判数据端口 |
| IP | 当前识别到的本机网络地址,可辅助判断 Vision 或 grSim 应选择的地址 |
绿色圆点不是数据连通指示
Network 标题右侧的绿点在当前界面实现中始终显示为绿色,不能证明 Vision 或 Referee 正在收到数据。实际连通性应结合 FPS、场地画面和 Game Data 是否更新判断。
Performance
性能信息每 2 s 刷新一次:
- 标题右侧的
C表示系统识别到的 CPU 逻辑核心数。 - CPU 显示系统总体使用率;不超过
50%为绿色,超过50%变黄,超过80%变红。 - Memory 顶部显示已用内存与缓存之和,以及物理内存总量。
Used是已用内存,Cache是系统缓存;缓存通常可以被系统回收,不等同于 Client 独占内存。- 内存使用率超过
60%时进度提示变黄,超过85%时变红。
短暂的负载上升不一定是故障。如果 FPS 同时下降、画面明显卡顿或系统持续处于红色,再关闭无关程序并检查是否存在重复启动的 Medusa、grSim 等进程。
Game Data 裁判信息

Game Data
比赛比分、允许上场数、当前指令、剩余时间和判罚信息

Game Data 实时示例
蓝黄双方 6:6、Force Start、阶段倒计时及逐张黄牌剩余时间
Game Data 直接读取当前接收的裁判信息,不是 Client 根据画面自行推断。没有有效裁判数据时,界面通常保持默认队名、0:0、Halt 和 00:00。
| 字段 | 含义 |
|---|---|
| Blue / Yellow 与比分 | 蓝黄双方标识和当前比分 |
| 机器人图标旁数字 | 裁判数据允许对应队伍上场的最大机器人数量 |
| 指令色块 | 当前裁判指令;颜色会随 Halt、Stop、开球、点球、任意球等状态变化 |
| Stage Left | 当前比赛阶段剩余时间 |
| Red | 蓝黄双方红牌数量 |
| Yel | 蓝黄双方黄牌数量 |
| Yel Exp | 各张黄牌的剩余处罚时间;没有数据时显示 - |
| Foul | 蓝黄双方犯规计数 |
图中 10 和 7 是蓝黄双方当前允许上场的机器人数量,不是比分;比分显示在顶部中央。Yel Exp 可能在同一队下显示多行,每一行对应一张仍在处罚中的黄牌及其剩余时间。阶段倒计时出现负值,表示该阶段的规定时间已经耗尽但裁判数据尚未切换到下一阶段,排查时应同时确认裁判盒当前阶段和指令。
如果此处显示的指令或比分与现场不一致,应前往 Referee 裁判模拟 检查 source_identifier 和裁判源过滤,避免接收同一网络中的错误裁判源。
LOG 录制状态

StatusPanel 与 Record 页操作的是同一个比赛记录器,两处状态会同步:
- 未录制时按钮为绿色
REC,点击后开始记录。 - 录制时按钮变为红色
STOP,状态点闪烁;再次点击完成写入。 Total Size是当前工作目录中LOG文件夹及其子目录的总大小。Current Size仅在录制期间出现,表示当前正在写入的记录文件大小。
当 LOG 总大小达到 10 GB 时,Client 会弹出存储警告,提示清理文件。关闭警告但未清理时,最短约 3 min 后可能再次提醒;总大小降到 3 GB 以下后,警告状态会重置。
在录制状态下直接关闭 Client,可能会导致 LOG 丢失
需要保留记录时,应先点击 STOP 等待写入结束。详细的格式选择与回放方法参见 Record 录制与回放。
Process Kill

KILL ALL 是主界面 Kill 功能在副面板中的快捷入口。按住按钮约 0.5 s,进度遮罩走完后才会触发,以减少误触。
触发后,Client 会停止 REC 录制和 Game Controller,导出 Client 日志,终止受管的 Monitor、grSim、蓝黄双方 Medusa 与 Aurora 等进程,随后直接退出。系统还会尝试清理残留的 Medusa 和 grSim 进程。
KILL ALL 会直接退出 Client
该操作没有普通的二次确认,长按完成后当前运行环境会被终止。只需停止一支队伍、断开视觉或结束录制时,应使用对应模块自己的 Stop / Disconnect 按钮。
Ball Speed

Ball Speed 曲线
绿色曲线为处理后的球速,红线为速度限制参考
Ball Speed 使用 Client 处理后的视觉数据绘制近期球速历史,单位为 m/s。默认纵轴上限为 8.0 m/s,红色参考线为 6.5 m/s;这些数值可由 BallSpeed/maxSpeed 和 BallSpeed/limitSpeed 配置修改。
- 绿色曲线表示各视觉帧中的球速。
- 红线是配置的限制参考线,不代表 Client 会自动限制球的实际速度。
- 没有有效 Vision 数据时,曲线会保持在
0附近。 - 图表宽度较大时可按住图表左右拖动,查看完整历史。
球速出现孤立尖峰时,先回看场地画面是否发生球识别跳变;持续超过参考线时,再检查射门力度、视觉标定和比赛规则要求。
快捷键提示
继续向下滚动可看到 StatusPanel 内置的快捷键速查:
| 快捷键 | 功能 |
|---|---|
M | 播放 / 暂停 |
Ctrl+C | Stop |
B | 蓝方 Medusa |
Y | 黄方 Medusa |
~、1~9 | 选择蓝方 0~9 号机器人 |
Ctrl+~、Ctrl+1~Ctrl+9 | 选择黄方 0~9 号机器人 |
快捷键是否生效还取决于当前焦点和运行状态。正式比赛前应先在安全环境中确认按键效果,避免与系统或终端快捷键混淆。
常见问题
| 现象 | 优先检查 |
|---|---|
Vision FPS 为 0 | Vision 连接状态、网卡、视觉源 IP、相机和运行模式 |
Vision 正常但 Blue / Yellow 为 0 | 对应颜色 Medusa 是否启动、队伍配置和进程状态 |
| Network 显示绿点但没有数据 | 绿点不表示连通;以 FPS、场地画面和裁判数据为准 |
| 比分或指令不正确 | 裁判源标识、Source Filter 和局域网中的其他裁判盒 |
| LOG 占用持续增长 | 停止不需要的录制,并整理 LOG 目录中的旧文件 |
Current Size 一直为 0 MB | 确认录制刚开始还是没有数据写入,并检查 LOG 目录权限和磁盘空间 |
| CPU / Memory 长期为红色 | 关闭无关程序,检查重复或残留进程,再观察 FPS 是否恢复 |
| 球速曲线异常跳变 | 检查 Vision 识别、相机拼接和球是否发生误识别 |