YourControls FS2024 适配之路从 Gauge 到 JS Communicator 的完整演进【免费下载链接】yourcontrolsShared cockpit for Microsoft Flight Simulator.项目地址: https://gitcode.com/gh_mirrors/yo/yourcontrolsYourControls 是一款专为 Microsoft Flight SimulatorMSFS打造的开源共享驾驶舱工具让联机飞行的多位玩家共享同一架飞机的操纵与状态。它的 FS2024 适配之路正是本文主角从传统 C Gauge 通信桥全面演进到基于 WebSocket 的 JS Communicator并实现了 FS2020 / FS2024 双版本档案分离。本文用通俗的语言带你走完这段技术演进。什么是共享驾驶舱为什么需要通信桥想象你和朋友联机飞同一架飞机一人开飞机一人管无线电和检查单。为了让每个人的界面都保持同步YourControls 需要在模拟器内部偷看并写入驾驶舱变量油门、航向、无线电频率等。在 FS2020 时代它采用的经典方案是Gauge 通信机制通过 SimConnect 的客户端数据区Client Data Area与一个驻留在模拟器内的仪表gauge交换数据程序把变量定义打包成批量消息发送再周期性读回数值这套机制由 gaugecommunicator.rs 实现配合 transfer.rs 完成发送定义 → 接收数值的完整往返。这套方案在 FS2020 上运行多年稳定可靠但它绑定了一个前提——模拟器支持传统的 C 仪表环境。FS2024 为什么逼出了 JS Communicator微软在 FS2024 中大幅转向 JavaScript 仪表生态传统 Gauge 的通信通道随之失效。早期的直接移植导致大量元素损坏官方更新日志中也能看到反复修复的痕迹如Fixed position freeze on FS2024、Most elements broken on FS2024 should now work详见 Changelog.md。于是项目团队做了一个关键决策放弃 Gauge改走 WebSocket。新的通信器由 jscommunicator.rs 实现思路非常简洁在本地0.0.0.0:7780端口启动一个 WebSocket 监听器FS2024 面板中的 JS 仪表主动连入并通过Handshake消息自报仪表名称之后所有同步按键输入、屏幕交互、时钟时间都通过 JSON 消息在这条双向通道里流动。JS Communicator 的四种消息类型从源码可以看到通信载荷被设计成四种清晰的消息类型定义在JSPayloads枚举中消息方向作用Handshake面板 → 程序连接握手声明仪表名称Interaction面板 → 程序报告触摸屏上的点击交互Input双向传递具体控件的键入值如 MCDU 输入Time/RequestTime双向同步模拟时间这些消息的收发逻辑集中在 definitions.rs 中统一调度程序轮询jstransfer.poll()取出消息再根据类型分发处理需要下发时调用write_payload()定向发送给指定仪表或广播给全部仪表。对普通用户而言这意味着 G3000、GTN 等大屏的触屏操作也能跨玩家同步——这正是 2.8.9 版本Touchscreen interaction fixed (G3000/GTN)背后的能力来源。档案结构升级FS2020 与 FS2024 分而治之FS2024 适配的另一大功臣是档案目录的重构。项目把所有飞机与模块的 YAML 定义拆分到了两个平行目录FS2020 档案definitions/FS2020/FS2024 档案definitions/FS2024/每个版本下都包含aircraft/机型档案与modules/自动驾驶、燃油、灯光等通用模块例如 definitions/FS2024/ 下已收录 FlyByWire A380、PMDG 之外的 Fenix A320ceo、COWS DA42 等 2024 专用机型而仪表档案如 AS_G3000.yaml 也按版本各有一份。路径解析由 paths.rs 负责——它根据当前模拟器版本决定加载哪一套目录用户界面上则对应一个独立的 FS2024 机型下拉框见 web/main.js 中对fs2024-list的处理这一改动就出现在 2.8.12 版本更新中。从更新日志看适配时间线 把 Changelog.md 中涉及 FS2024 的版本串起来就是一条清晰的适配路线2.8.9主体适配完成——Most elements broken on FS2024 should now work触屏交互修复时间同步抖动解决2.8.10继续补漏——2020 机型在 2024 下的电路/灯光/配平修复触控屏按键输入、ID 哈希优化2.8.11稳定性收尾——修复 FS2024 位置冻结、移除残留的失效物理修正器、设置即时生效2.8.12体验优化——FS2024 机型独立下拉列表档案目录完成 FS2020/FS2024 拆分外部档案需同步更新。可以看到这条路线的本质是先用 JS Communicator 打通通信大动脉再用双版本档案体系消化机型差异最后以稳定性和易用性收尾。写在最后YourControls 的 FS2024 适配是跟随平台演进的典型案例当微软把驾驶舱的未来交给 JavaScript共享驾驶舱工具也随之从 C Gauge 的内存交换走向 WebSocket JSON 的现代架构。对普通用户来说这一切是透明的——你只需安装最新版在界面中选择 2020 或 2024 机型档案即可和搭档共享同一座驾驶舱而对想深入源码的开发者src/yourcontrols/src/sync/ 目录下的五个通信模块Gauge、JS、内存写入、冻结检测、传输调度正是理解整个架构的最佳入口。【免费下载链接】yourcontrolsShared cockpit for Microsoft Flight Simulator.项目地址: https://gitcode.com/gh_mirrors/yo/yourcontrols创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 YourControls FS2024 适配之路：从 Gauge 到 JS Communicator 的完整演进
YourControls FS2024 适配之路从 Gauge 到 JS Communicator 的完整演进【免费下载链接】yourcontrolsShared cockpit for Microsoft Flight Simulator.项目地址: https://gitcode.com/gh_mirrors/yo/yourcontrolsYourControls 是一款专为 Microsoft Flight SimulatorMSFS打造的开源共享驾驶舱工具让联机飞行的多位玩家共享同一架飞机的操纵与状态。它的 FS2024 适配之路正是本文主角从传统 C Gauge 通信桥全面演进到基于 WebSocket 的 JS Communicator并实现了 FS2020 / FS2024 双版本档案分离。本文用通俗的语言带你走完这段技术演进。什么是共享驾驶舱为什么需要通信桥想象你和朋友联机飞同一架飞机一人开飞机一人管无线电和检查单。为了让每个人的界面都保持同步YourControls 需要在模拟器内部偷看并写入驾驶舱变量油门、航向、无线电频率等。在 FS2020 时代它采用的经典方案是Gauge 通信机制通过 SimConnect 的客户端数据区Client Data Area与一个驻留在模拟器内的仪表gauge交换数据程序把变量定义打包成批量消息发送再周期性读回数值这套机制由 gaugecommunicator.rs 实现配合 transfer.rs 完成发送定义 → 接收数值的完整往返。这套方案在 FS2020 上运行多年稳定可靠但它绑定了一个前提——模拟器支持传统的 C 仪表环境。FS2024 为什么逼出了 JS Communicator微软在 FS2024 中大幅转向 JavaScript 仪表生态传统 Gauge 的通信通道随之失效。早期的直接移植导致大量元素损坏官方更新日志中也能看到反复修复的痕迹如Fixed position freeze on FS2024、Most elements broken on FS2024 should now work详见 Changelog.md。于是项目团队做了一个关键决策放弃 Gauge改走 WebSocket。新的通信器由 jscommunicator.rs 实现思路非常简洁在本地0.0.0.0:7780端口启动一个 WebSocket 监听器FS2024 面板中的 JS 仪表主动连入并通过Handshake消息自报仪表名称之后所有同步按键输入、屏幕交互、时钟时间都通过 JSON 消息在这条双向通道里流动。JS Communicator 的四种消息类型从源码可以看到通信载荷被设计成四种清晰的消息类型定义在JSPayloads枚举中消息方向作用Handshake面板 → 程序连接握手声明仪表名称Interaction面板 → 程序报告触摸屏上的点击交互Input双向传递具体控件的键入值如 MCDU 输入Time/RequestTime双向同步模拟时间这些消息的收发逻辑集中在 definitions.rs 中统一调度程序轮询jstransfer.poll()取出消息再根据类型分发处理需要下发时调用write_payload()定向发送给指定仪表或广播给全部仪表。对普通用户而言这意味着 G3000、GTN 等大屏的触屏操作也能跨玩家同步——这正是 2.8.9 版本Touchscreen interaction fixed (G3000/GTN)背后的能力来源。档案结构升级FS2020 与 FS2024 分而治之FS2024 适配的另一大功臣是档案目录的重构。项目把所有飞机与模块的 YAML 定义拆分到了两个平行目录FS2020 档案definitions/FS2020/FS2024 档案definitions/FS2024/每个版本下都包含aircraft/机型档案与modules/自动驾驶、燃油、灯光等通用模块例如 definitions/FS2024/ 下已收录 FlyByWire A380、PMDG 之外的 Fenix A320ceo、COWS DA42 等 2024 专用机型而仪表档案如 AS_G3000.yaml 也按版本各有一份。路径解析由 paths.rs 负责——它根据当前模拟器版本决定加载哪一套目录用户界面上则对应一个独立的 FS2024 机型下拉框见 web/main.js 中对fs2024-list的处理这一改动就出现在 2.8.12 版本更新中。从更新日志看适配时间线 把 Changelog.md 中涉及 FS2024 的版本串起来就是一条清晰的适配路线2.8.9主体适配完成——Most elements broken on FS2024 should now work触屏交互修复时间同步抖动解决2.8.10继续补漏——2020 机型在 2024 下的电路/灯光/配平修复触控屏按键输入、ID 哈希优化2.8.11稳定性收尾——修复 FS2024 位置冻结、移除残留的失效物理修正器、设置即时生效2.8.12体验优化——FS2024 机型独立下拉列表档案目录完成 FS2020/FS2024 拆分外部档案需同步更新。可以看到这条路线的本质是先用 JS Communicator 打通通信大动脉再用双版本档案体系消化机型差异最后以稳定性和易用性收尾。写在最后YourControls 的 FS2024 适配是跟随平台演进的典型案例当微软把驾驶舱的未来交给 JavaScript共享驾驶舱工具也随之从 C Gauge 的内存交换走向 WebSocket JSON 的现代架构。对普通用户来说这一切是透明的——你只需安装最新版在界面中选择 2020 或 2024 机型档案即可和搭档共享同一座驾驶舱而对想深入源码的开发者src/yourcontrols/src/sync/ 目录下的五个通信模块Gauge、JS、内存写入、冻结检测、传输调度正是理解整个架构的最佳入口。【免费下载链接】yourcontrolsShared cockpit for Microsoft Flight Simulator.项目地址: https://gitcode.com/gh_mirrors/yo/yourcontrols创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考