SSL Game Controller Launcher
约 987 字
本教程对应老版本 Client
本教程对应裁判组件与 GC 组件重构前的界面,部分入口、控件和数据链路已发生变化。新版请阅读 裁判系统总览,按内部裁判盒、裁判源过滤、GC 控制与 AutoRef 教程操作。
SSL Game Controller Launcher
该页用于从 Client 内启动、停止和重启官方 ssl-game-controller,打开其 Web UI,并直接查看或编辑 YAML 配置。它与 ControlBoard 中的简易 Referee 裁判模拟 不同:前者是完整比赛控制器,后者适合快速发送裁判指令。

SSL Game Controller 页面
左侧控制进程与启动参数,右侧编辑 YAML 配置

Game Controller 控件标注
进程控制、地址配置、Web UI 与 YAML 编辑器
控件说明
| 编号 | 控件 | 作用 |
|---|---|---|
| 1 | Status | 显示 Stopped、运行中或错误状态 |
| 2–4 | Start / Stop / Restart | 启动、停止或重启控制器进程 |
| 5 | Web UI Port | Web 管理界面的本机端口,默认 8081 |
| 6 | Vision Address | 控制器接收 Vision 的 地址:端口,默认 224.5.23.2:10006 |
| 7 | Publish Address | 控制器发布裁判数据的 地址:端口,默认 224.5.23.1:10003 |
| 8 | Config File | YAML 配置路径,默认 config/ssl-game-controller.yaml |
| 9 | Auto-start | 自动启动选项的界面占位;当前未连接到管理器 |
| 10 | Open Web UI | 控制器运行后打开 http://localhost:<端口> |
| 11 | Apply Settings | 保存左侧设置;若控制器正在运行会自动重启 |
| 12 | Reset to Default | 将端口和地址恢复为内置默认值 |
| 13 | Reload Config | 从当前 Config File 重新读取配置 |
| 14–16 | Save / Discard / Reload | 保存表格改动、放弃未保存改动、重新载入 YAML |
| 17 | Section Filter | 按 All、Network、Game、Server、Engine 筛选配置项 |
| 18 | YAML 表格 | 查看 Key、Value、Description;在 Value 列修改值 |
当前未实现文件选择和自动启动
Config File 右侧的 ... 按钮目前没有行为,需直接输入路径;Auto-start with application 复选框也不会持久化或自动启动控制器。
启动本机控制器
- 确认可执行文件和 YAML 配置已经随 Client 正确部署。
- 核对 Vision Address 与当前视觉源一致;Publish Address 应与 Client 的裁判接收配置匹配。
- 点击 Reload Config,确认 YAML 能被读取。
- 修改左侧参数后点击 Apply Settings。
- 点击 Start Controller。状态变为运行后,再点击 Open Web UI 设置队伍、比赛阶段和比赛状态。
- 回到 Referee Information 核对收到的来源、指令和比分。
YAML 编辑器
右侧表格用于精细调整官方控制器的完整 YAML。编辑 Value 后,页面会提示存在未保存修改:
- Save Config 将表格内容写回文件。
- Discard Changes 恢复到最近一次载入的内容。
- Reload 从磁盘重新读取,会覆盖尚未保存的表格修改。
- 顶部 Section Filter 只改变显示范围,不会删除其他配置。
修改比赛规则参数前先备份配置
YAML 中包含进球审批、放球距离与时限、换人预算、默认 Division 等比赛规则参数。错误值可能让控制器行为偏离当届规则。正式比赛应使用经验证的配置,并在修改后重启控制器重新检查。
常见问题
| 现象 | 优先检查 |
|---|---|
| Start 后立即停止 | 控制器可执行文件是否存在、配置文件路径和 YAML 语法 |
| Web UI 打不开 | Status 是否运行、端口是否占用、防火墙与 localhost:<port> |
| 有 Vision 但控制器没收到 | Vision Address、网卡组播和 Simulation/Real 端口 |
| Client 没有裁判数据 | Publish Address 与 Client Referee 端口是否一致 |
| 改了 YAML 但行为没变化 | 是否 Save Config,并重启正在运行的控制器 |