GC Remote Control 远程控制协议工具
约 1827 字
GC Remote Control 是 Client 内置的 SSL Game Controller Remote Control Protocol 客户端。它代表某一颜色的队伍连接 GC,既能提交暂停、紧急停止、挑战旗、换人等请求,也能持续读取 GC 返回的队伍状态。它适合验证 Remote Control 接口和制作比赛场边控制终端。

GC Remote Control
连接、注册、远程请求、队伍状态与控制器回复

GC Remote Control 控件标注
注册黄队后查看状态并发送当前允许的请求
与 Team Control 的区别
| 对比 | GC Team Control | GC Remote Control |
|---|---|---|
| 角色 | 队伍程序与 GC 的基础队伍协议 | 场边远程控制客户端 |
| 默认端口 | TCP/TLS 10008 | TCP/TLS 10011 |
| 注册依据 | 精确 team_name,可附颜色 | 必须指定 Yellow 或 Blue |
| 可发送内容 | 门将、优势选择、换人、Ping | 门将、换人、Timeout、Emergency Stop、Challenge Flag、Fail Ball Placement 等 |
| GC 下行数据 | 每次请求的 ControllerReply | ControllerReply + 持续的 RemoteControlTeamState |
| 典型用途 | 策略侧协议联调、队伍意图上报 | 场边人工请求、状态监控、Remote API 联调 |
Remote Control 不是“远程操作裁判指令”的后门。它只能提交协议允许的队伍请求,GC 会根据比赛阶段、配额和裁判流程决定是否接受。
通信链路
GC Remote Control
│ TCP 或 TLS,默认 127.0.0.1:10011
│ 长度头 + Protobuf
▼
SSL Game Controller Remote-Control Server
│
├─ RemoteControlRegistration:第一条客户端消息
├─ RemoteControlToController:各种队伍请求
└─ ControllerToRemoteControl
├─ ControllerReply:请求结果
└─ RemoteControlTeamState:队伍实时状态本项目配置项为 server.remote-control.address: :10011,可信公钥目录为 config/trusted_keys/remote-control。TCP/TLS、4 字节大端长度头与 Varint 分帧的规则和 GC Team Control 相同。
协议消息
1. RemoteControlRegistration
注册必须是 Remote Control 发给 GC 的第一条消息。它包含必需的 team(Yellow/Blue)和可选 signature,不使用队名作为注册键。注册后,本工具每秒自动发送一次 Ping,用于保持通信并刷新 Team State;断开连接后自动停止。
不要以 Unknown 注册
本地实现允许界面保持 Unknown 并序列化注册,但协议字段要求明确 Team。连接前必须选择 Yellow 或 Blue,并以 GC 返回状态中的 Team 和队名再次核对。
2. RemoteControlToController
每个 Protobuf oneof msg 一次只提交一种请求:
| 页面操作 | 字段 / 枚举 | 协议含义 |
|---|---|---|
| Ping | request = PING | 测试连接;GC 回复 OK 和当前 Team State |
| Challenge flag | CHALLENGE_FLAG | 举起挑战旗;协议明确规定不可撤销 |
| Stop timeout | STOP_TIMEOUT | 结束正在进行的 Timeout |
| Fail ball placement | FAIL_BALLPLACEMENT | 主动声明本方放球失败 |
| Desired keeper id | desired_keeper | 请求设置门将编号 |
| Robot substitution | request_robot_substitution = true/false | 请求在下一机会换人,或撤销请求 |
| Timeout | request_timeout = true/false | 请求在下一次比赛停止时进入 Timeout,或撤销等待中的请求 |
| Emergency stop | request_emergency_stop = true/false | 发起或撤销紧急停止请求 |
页面的 Timeout 按钮会结合 Active/Available requests 自动显示 Request timeout、Cancel timeout 或 Stop timeout。Emergency Stop 是否立即执行由 GC 规则决定;当前本地 YAML 的 emergency-stop-grace-period 为 10s,应以实际赛事配置为准。
3. ControllerToRemoteControl
一条 GC 下行消息可以同时包含:
ControllerReply:OK/REJECTED、Reason、Verification、Next token。RemoteControlTeamState:当前允许请求、活动请求、门将、紧停倒计时、Timeout/挑战旗配额、机器人数量、黄牌计时与换人状态。
这意味着“控制器接受了请求”和“请求已经进入活动状态”是两个判断:先看 Reply 是否 OK,再看 Active requests 或对应状态字段是否更新。
控件说明
| 编号 | 控件 | 作用 |
|---|---|---|
| 1–2 | Status / Enable Remote Control | 建立或关闭 Remote Control 通道 |
| 3–4 | Host / Port | GC 地址与端口,默认 127.0.0.1:10011 |
| 5–7 | SSL / Framing | TLS 设置和 TCP 消息长度格式 |
| 8–10 | Auto register / Reconnect / Disconnect | 自动注册、重连和断开 |
| 11–12 | Team | 注册颜色与 GC 返回的队名 |
| 13–17 | Signature / Token | 可选安全认证、令牌轮换和手动注册 |
| 18–24 | Requests | 通用请求、门将、换人、Timeout、Emergency Stop |
| 25 | Team State | GC 下发的队伍实时状态 |
| 26–29 | Controller Reply | 状态、原因、验证结果与下一 Token |
| 30 | Traffic Log | 最近 200 条连接、请求和回复记录 |
Team State 字段
| 字段 | 含义 | 使用方法 |
|---|---|---|
| Available requests | 当前规则允许发起的请求 | 发送前先确认目标请求存在 |
| Active requests | 已提交且仍处于活动/等待状态的请求 | 判断请求是否真正进入 GC 状态机 |
| Keeper id | 当前门将编号 | 与策略和裁判信息交叉核对 |
| Emergency stop in | 紧急停止执行倒计时;0 表示未请求 | 请求后观察是否开始倒计时 |
| Timeouts left / time left | 剩余 Timeout 次数和时长 | 避免无配额请求 |
| Challenge flags left | 剩余挑战旗 | Challenge 不可撤销,操作前必须确认 |
| Max robots / Robots on field | 允许上场数和视觉可见数 | 发现超员或漏检 |
| Yellow cards due | 各张有效黄牌的到期时间 | 判断处罚进度 |
| Can substitute | 当前是否允许换人 | 与换人请求和比赛停止状态联动 |
| Substitutions left / time left | 半场剩余换人次数及当前时限 | 判断换人窗口是否可用 |
本机联调流程
- 启动本机 GC,确认
server.remote-control.address为:10011。 - 设置 Host、Port、TLS 和 Framing,并选择正确的 Yellow/Blue。
- 无签名本机测试时保持 Use Signature 关闭,打开 Enable Remote Control。
- 确认日志先出现 Registration sent,再持续出现 Ping 对应的回复和 Team State。
- 先检查 Available requests,再发送目标请求。
- 依次核对 Controller Reply、Reason、Active requests 和相关状态字段。
安全认证
Remote Control 与 Team Protocol 共用 ControllerReply 和 Signature 结构:GC 通过滚动 next_token 防止重放,客户端用 PKCS#1 v1.5 签名字节证明身份。密钥信任目录与 Team Server 分开,Remote Control 的公钥必须部署到 config/trusted_keys/remote-control。
本页面同样不会生成签名,只把手工输入的 Token 和十六进制签名字节附加到当前消息。点击 Use Next Token 只复制新令牌。安全模式下每一种请求、每一次发送都要针对当前消息和最新 Token 重新生成签名;不要复用上一条请求的 Signature。
常见问题
| 现象 | 优先检查 |
|---|---|
| Connected 但 Team State 全是初始值 | 是否明确选择颜色并成功注册、Framing、Ping 回复 |
| 请求按钮可点但被拒绝 | Available requests、Reply Reason、配额和比赛阶段 |
| Timeout 无法撤销 | 查看 Active requests;进行中的 Timeout 可能需要 STOP_TIMEOUT |
| Challenge 无法取消 | 协议规定 Challenge Flag 不可撤销 |
| 状态更新一秒一次 | 工具注册后每秒发送 Ping,这是预期行为 |
| Verification 为 UNVERIFIED | 最新 Token、当前消息签名、Remote Control 可信公钥目录 |
高风险请求
Emergency Stop、Challenge Flag、Fail Ball Placement 和 Timeout 会影响真实比赛流程。只在获授权且已核对 Team、GC 地址和 Available requests 后操作。不要在正式 GC 上用这些按钮做连通性测试;连通测试只使用 Ping。
贡献者
更新日志
4424a-settingpanel 教程于