Referee 裁判模拟
约 2173 字
本教程对应老版本 Client
本教程对应裁判组件与 GC 组件重构前的界面,部分入口、控件和数据链路已发生变化。新版请阅读 裁判系统总览,按内部裁判盒、裁判源过滤、GC 控制与 AutoRef 教程操作。
Referee 裁判模拟
裁判模拟页包含一个简易裁判盒和裁判信息面板,可用于本地联调、复现比赛阶段,以及确认当前收到的裁判源。

裁判模拟界面
发送裁判指令并观察实时裁判数据

内置裁判盒控件
通用、黄方、蓝方与下一指令分区
Broadcast 模式不要在公共网络随意开启
当前内置裁判盒可以在 Local 与 Broadcast 之间切换。Local 只发送到本机,适合日常调试;Broadcast 会向裁判组播地址发送,可能同时控制网络中的其他电脑。切到 Broadcast 前必须确认网络范围并与同网段人员协调,同一网络不要同时运行多个裁判盒。
快速使用
确认网络环境
只在隔离的测试网络或经现场人员确认的网络中操作。
选择发送范围
单机调试保持 Local;只有明确需要让局域网内其他电脑接收时,才切换到 Broadcast。
开启裁判源
点击 Send 后按钮变为 Stop,表示内置裁判盒正在发送数据。Client 启动后默认不发送。
发送比赛阶段指令
先选队伍相关指令,需要时设置 Next Command,再使用 Normal Start、Force Start 等指令推进流程。
核对裁判信息
在信息面板中检查当前指令、下一指令和源标识,确保收到的是预期裁判源。
内置裁判盒

内置裁判盒控件标注
发送开关、发送范围、裁判源标识与各类指令区域
| 编号 | 区域 | 作用 |
|---|---|---|
| 1 | 折叠按钮 | 展开或收起内置裁判盒区域 |
| 2 | Send / Stop | 开启或停止裁判数据发送 |
| 3 | Local / Broadcast | 选择仅向本机发送,或向局域网裁判组播地址发送 |
| 4 | source_identifier | 显示当前内置裁判源的唯一标识 |
| 5 | 通用指令 | 发送 Halt、Stop Game、Force Start、Normal Start |
| 6 | 黄方指令 | 发送黄方开球、点球、任意球、Timeout、放球等指令 |
| 7 | 蓝方指令 | 发送蓝方对应指令 |
| 8 | Next Command | 设置裁判数据中的下一指令字段 |
新版界面在发送开关旁增加了 Local / Broadcast,它决定数据只发往 localhost,还是发送到局域网裁判组播地址。两种模式都会同时发送到裁判端口及相邻端口,供本机组件接收。
通用指令
| 指令 | 含义 | 机器人行为摘要 |
|---|---|---|
HALT | 强制终止 | 所有机器人必须立即刹停 |
STOP | 暂停比赛 | 所有机器人不得触球,与球保持 0.5 m 距离,速度限制在 1.5 m/s 以下 |
FORCE_START | 强制恢复 | 暂停原因不归属于某方且规则未指定其他恢复方式时使用;双方恢复自由触球 |
NORMAL_START | 标准开始 | 开球或点球准备完成后使用,获得执行权的一方开始被允许触球 |
队伍相关指令
黄方与蓝方拥有相同的一组指令,区别仅在于获得执行权的队伍:
指定队伍的一辆机器人可以接近放在场地原点的球,但在 NORMAL_START 前不能触球。随后可用 NORMAL_START 开始,也可用 STOP 或 HALT 终止流程。
指定队伍的一辆机器人在点球点前就位,其余机器人退至点球点后,等待 NORMAL_START 进入执行阶段;也可用 STOP 或 HALT 终止流程。
用于恢复比赛。指定队伍获得优先触球权,对方不得抢球。省赛与国际赛通常称为 Free Kick。
旧规则指令,省赛和国际赛中已不再常用。指定队伍获得优先触球权,但不能直接射门;球需再被其他球员触碰,进球才有效。
由对应队伍负责人发起,类似中场休息,可用于调整软硬件。原有说明为每方每场最多 4 次、总计 300 秒;具体次数和总时长以当届规则为准。
指定队伍负责把球移动到裁判给出的目标点。对方所有车辆不得进入球与目标点连线形成的放球通道矩形区域。
Next Command
Next Command 表示当前阶段结束后预计切换到的指令。在 Ball Placement 等阶段设置它,可以让策略提前按下一阶段规划站位。
当前界面可设置 Stop Game、Force Start、蓝/黄方 Direct Kick 和蓝/黄方 Indirect Kick。点击后只是更新裁判数据中的 next_command,不会立即执行该指令。
裁判源标识与信息过滤

裁判接收设置与信息面板标注
筛选裁判源并查看比赛及双方队伍信息

裁判信息详情
过滤关闭时接收全部消息,并显示当前比赛与双方队伍数据

| 编号 | 区域 | 作用 |
|---|---|---|
| 1 | Enable Referee Message Filter | 开启或关闭裁判源过滤;关闭时接受全部来源 |
| 2 | Select Referee Box Source | 选择已发现的裁判源,并显示当前过滤状态 |
| 3 | Referee Information | 显示源标识、比赛类型、时间戳、阶段、当前/下一指令等信息 |
| 4 | Team Information | 分别显示黄蓝双方名称、比分、红黄牌、犯规、门将号与放球权限 |
每个裁判源理论上都应提供唯一的 source_identifier。内置裁判盒会动态使用 NingboTech_ 加当前非回环 IPv4 地址组成标识;没有可用地址时回退到 NingboTech_127.0.0.1。这样当电脑受到其他裁判盒控制时,可以快速判断数据来自哪台主机。旧版 Rocos Client 发送裁判数据时没有填写该字段;官方 ssl-game-controller 通常使用 UUID,例如 31023a63-0bcd-410d-bbd5-938e3731ce14。
选择接收来源
开启 Enable Referee Message Filter 后,展开下拉框即可选择接收来源。列表会随着 Client 发现新的 source_identifier 自动补充:
| 选项 | 行为 | 适用场景 |
|---|---|---|
| All Sources | 关闭来源过滤,接受所有裁判消息 | 网络中只有一个可信裁判源时 |
NingboTech_<本机 IP> | 只接收当前 Client 内置裁判盒发送的数据 | 使用本机裁判模拟联调时 |
| 已发现的 UUID 或其他标识 | 只接收该标识完全匹配的裁判数据 | 对接官方 ssl-game-controller 或其他电脑的裁判盒时 |
| Custom SSL-Game-Controller Source | 显示输入框,手动填写完整 source_identifier | 目标来源尚未出现在列表中时 |
选择具体来源或填写自定义标识后,只有 source_identifier 完全匹配的数据会被接受,没有该字段的数据也会被丢弃。选择 All Sources 的实际效果与关闭过滤相同;状态提示应显示接受全部消息。
先观察当前来源
在 Referee Information 中记下正在接收的裁判源标识,确认它来自内置裁判盒还是外部 ssl-game-controller。
开启过滤并选择目标
优先直接选择列表中已发现的来源;只有列表中没有目标时才使用自定义输入。
发送一条安全指令验证
在测试环境发送
STOP或HALT,确认 当前指令、时间戳和来源标识同步更新。排除其他来源干扰
若信息不再更新,检查填写的标识是否完整;若机器人执行了意外状态,检查是否误选了 All Sources,以及同网段是否还有其他裁判盒在发送。
裁判信息面板还会显示当前 command、next_command、比赛阶段、剩余时间、比分、门将号、犯规与球队信息,不只是用于过滤来源。
指令规则说明
本页用于介绍 Client 控件和常见指令语义。速度、距离、暂停次数等精确限制应以当前比赛官方规则为准。