测试版文档。 随着应用程序进入 1.0 版本,一些文本和图像将被重新设计。如果某个部分显示为过时,请通过 反馈表.

微软模拟飞行 2024

FFB-Bridge 通过 SimConnect 的 TCP 传输与 MSFS 2024 进行通信。在全新安装 MSFS 2024 时,它可以在 Windows 上开箱即用,并且需要在 Linux / Proton 下进行一次配置调整。这座桥的 医生 页面可以为您进行调整 - 本指南涵盖一键路径和手动路径。

您安装了什么 MSFS?

默认 SimConnect 位置取决于 MSFS 的安装方式。 FFB-Bridge 会自动检测所有三种情况,但如果出现问题,它有助于了解您所处的情况。

安装SimConnect.xml 地点
蒸汽/独立 %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Microsoft 商店/Xbox 游戏通行证 %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
Linux 蒸汽+质子 ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

窗户 — 开箱即用

每个库存 MSFS 2024 安装都附带在端口上启用的 SimConnect TCP 500,绑定到所有 IPv4 接口。桥接器默认为 127.0.0.1:500 在 Windows 上。启动 MSFS,然后启动 FFB-Bridge — 西姆 仪表板上的芯片应在 SIM 卡到达主菜单后一两秒内变为绿色。

如果没有,请打开 医生. The SimConnect 配置 row 告诉您它在 XML 中找到了什么以及它正在使用的端口是否与桥接器正在通信的端口匹配。

500 以外的端口

一些工具 - FSUIPC、SPAD.neXt - 在同一文件中添加自己的 TCP 条目 SimConnect.xml。如果 MSFS 侦听的端口与网桥期望的端口不同,则 SimConnect 配置 医生行提供内联 使用端口:X 按钮。单击它,网桥的首选项将更新为该端口;无需重新启动 MSFS。

Linux — 通过 Doctor 一键修复

Proton 旗下的 MSFS 也运送相同的库存 SimConnect.xml 与 Windows 版本一样,使用 TCP 侦听端口 500。但 Linux 将 1024 以下的端口视为特权端口,并且 Proton 用户命名空间进程无法绑定它们。监听静静地失败,并且没有套接字打开。

解决办法是添加一个并行 <SimConnect.Comm> 非特权端口上的条目(网桥默认使用 5111)。打开 医生;的 SimConnect 配置 行将显示特权端口并提供 修复... 按钮。

Linux 上的 FFB-Bridge Doctor 修复对话框显示检测到的 Proton 前缀及其将安装的 SimConnect TCP 端口
Figure 1. Linux 上的 Doctor's Fix 对话框。显示它找到的 Proton 前缀路径以及它要添加的端口。单击“安装”会合并一个新条目 - 现有条目将保持不变。

修复... 将新条目合并到现有 XML 中(从不重写它)。如果现有文件不可解析,安装程序首先将其备份为 SimConnect.xml.bak-YYYY-MM-DD-HHMMSS 并写入新生成的配置。无论哪种方式,安装后重新启动 MSFS,以便它重新读取 SimConnect.xml。

哪个质子前缀?

FFB-Bridge 探测 Steam、Steam-Flatpak、Heroic 和 Lutris 的众所周知的前缀。如果从非标准位置运行 MSFS,请设置 FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix 在启动网桥之前在您的环境中。对于仅 XML 文件的裸机覆盖, FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml takes precedence.

手动配置

如果您愿意手动编辑,XML 如下所示:

<?xml version="1.0" encoding="Windows-1252"?>
<SimBase.Document Type="SimConnect" version="1,0">
  <Descr>SimConnect Client Configurations</Descr>
  <Filename>SimConnect.xml</Filename>

  <!-- FFB-Bridge: unprivileged TCP for Proton-on-Linux -->
  <SimConnect.Comm>
    <Descr>FFB-Bridge TCP</Descr>
    <Protocol>IPv4</Protocol>
    <Scope>local</Scope>
    <Port>5111</Port>
    <MaxClients>64</MaxClients>
    <MaxRecvSize>41088</MaxRecvSize>
    <DisableNagle>False</DisableNagle>
  </SimConnect.Comm>

  <!-- Keep any existing entries below this line. -->

</SimBase.Document>

保存后,打开FFB-Bridge的 模拟 SimConnect 页面,将输入源切换回 直播,桥接器将采用新的配置。在 Linux 上,您还可以访问 诊断 并观察日志 SimConnect 已连接 重新启动 MSFS 后。

SimVars 桥读取

作为参考 — 您无需配置任何内容 — 以下是网桥订阅的 MSFS SimVar 集:

  • 空速(指示、真实)、高度、垂直速度、俯仰、坡度、航向
  • 重力、迎角、失速警告、超速警告
  • 升降舵、副翼和方向舵偏转(调整后和原始)
  • 配平位置(升降舵、副翼、方向舵)
  • 档位手柄状态、襟翼手柄索引、扰流板手柄位置
  • 每个发动机的 RPM 百分比和燃烧状态,反向推力已启用
  • 表面类型枚举(跑道、草地、冰)、制动踏板偏转
  • 自动驾驶仪主状态,自动驾驶仪命令俯仰/倾斜

如果 MSFS 无法识别变量名称,网桥会将其记录为警告 诊断 页但继续 — 缺失的变量默认为合理的零。这就是桥接器容忍未实现每个 SimVar 的第三方飞机的方式。

故障排除

参见 故障排除 对于:

  • MSFS 连接但没有力量 — 最常见的是顶部条中的 ARM 仪表仍然处于 DISARMED 状态;覆盖在那里。
  • MSFS 暂停/主动暂停应该在 beta.11 中立即消除动态效果,并在暂停时保持中性弹簧。
  • 如果长时间的卡顿或暂停会在恢复后降低滚动力,请从同一会话中导出支持包和文件反馈。