当前版本。 FFB-Bridge 1.0 已发布。这些文档对应当前应用,包括 1.0 的调校和 Mock Sim 变更。如果某一节看起来已过时,请通过以下方式反馈: 反馈表.

设置

设置是应用全局的首选项页面(侧边栏 → 设置,位于“应用”之下)。它有两个选项卡: 行为 - 常规、会话和本地数据卡,涵盖关闭按钮行为、主题、视觉对比度、启动 UI 重置、自动布防/自动撤防自动化以及应用程序读取和写入的本地配置和诊断文件夹 - 以及 硬件 — 力反馈设备选择器、效果渲染、Windows 设备后端、实验性未列出设备选择加入和实时轴测试。这里的每个首选项都是每次安装时保存到用户配置文件夹下的 JSON 文件中。

设置页面。“行为”选项卡的常规、会话和本地数据卡片涵盖主题、视觉对比度、关闭行为、自动启用/自动解除、本地文件夹、崩溃清理和日志清理。 设置页面。“行为”选项卡的常规、会话和本地数据卡片涵盖主题、视觉对比度、关闭行为、自动启用/自动解除、本地文件夹、崩溃清理和日志清理。
图 1。 设置页面。“行为”选项卡的常规、会话和本地数据卡片涵盖主题、视觉对比度、关闭行为、自动启用/自动解除、本地文件夹、崩溃清理和日志清理。

行为选项卡

“行为”标签页包含三张卡片: 常规, 会议, 和 本地数据。这些是应用程序范围内的旋钮,不与特定的力反馈设备绑定。

常规

关闭按钮

选择当有系统托盘可用时,窗口关闭按钮的行为。三个选项: 每次都询问 (默认 — 提示单行对话框), 最小化到托盘 (隐藏窗口,保持桥运行并且摇杆武装),或者 退出应用 (完全关闭)。

在没有可用系统托盘的桌面上(原生 GNOME Wayland 是常见情况),关闭始终会退出,此设置实际上会被忽略。

主题

选择应用程序选项板,或遵循操作系统。 系统 (默认)遵循您的操作系统明/暗偏好; 浅色深色 覆盖它。桥接器会在更改时立即重新主题 - 无需重新启动。

视觉对比

选择整个应用程序渲染的强度: 标准 (默认)保留正常调色板,并且 高对比度 增强了整个应用程序的可读性——更醒目的文本和柔和的标签、更清晰的卡片和面板边框、更明显的焦点框、更醒目的按钮和状态药丸轮廓、更清晰的空闲/激活状态,以及对比度更高的仪表盘效果组色块。它会立即生效,并适用于任何主题选择(系统、浅色或深色)。

这是有意这样命名的 视觉对比,不是“色盲模式”。它确实有助于改善色觉差异,但它的目标更广泛——针对老化的眼睛、白内障、眩光、昏暗的房间以及陈旧或质量较低的显示器。这纯粹是一种视觉偏好:确实如此 更改力输出、配置文件值、调校或设备行为。

启动界面

两个用于重置首次启动界面状态的按钮:

  • 重置窗口 — 清除保存的窗口位置和大小,以便下次启动时使用默认窗口位置打开。
  • 显示欢迎 — 使首次启动的欢迎对话框在下次启动时再次出现。如果您想引导测试人员完成上手流程而无需重新安装应用,这会很有用。

两个按钮都不会立即更改任何内容;它们都会在下次启动 FFB-Bridge 时生效。

会议

实时模拟器会话的免操作启动和关机行为。这两个复选框只在输入源为 Live(FFB-Bridge 正在与真实模拟器通信)时生效;在 Mock 或 Idle 模式下不起作用。

就绪时自动接通

勾选后,只要所有前提条件就绪,FFB-Bridge 就会自动启用力输出:已打开受支持的设备、模拟器可达、没有启动弹窗阻挡,并且您在本次模拟器会话中没有刚刚手动解除启用。

最后一点值得注意——如果你在飞行中手动解除启用(也就是“落地前我想保持免操作”的场景),FFB-Bridge 会尊重这个选择,在下次模拟器断开并重新连接之前不会自动重新启用。退出并重新启动模拟器,或关闭并重新打开 FFB-Bridge,自动启用才会再次生效。

默认关闭——FFB-Bridge 默认只允许手动启用,确保首次启动时电机不会突然动作。

模拟器退出时解除启用

勾选后,模拟器停止报告遥测的瞬间,FFB-Bridge 就会停止力输出——退出 MSFS 或 X-Plane 后,即使 FFB-Bridge 仍然打开,摇杆也会停止动作。

默认关闭。关闭后,FFB-Bridge 会保持上次接收到的节拍时的弹簧状态( 陈旧遥测看门狗 仍会淡出动态力,但弹簧保持不变)。开启后,摇杆会完全处于惰性状态,直到模拟器恢复并由自动布防重新启用(前提是自动布防也已开启)。

在平台对应的位置查找 MSFS 的配置,对其进行解析,并将任何已启用的 IPv4 条目与桥正在使用的端口进行比较。有三种可能的结果:

本地数据

用于偏好设置、诊断和支持包的本地文件。两个部分并排显示。

文件夹

两个路径和两个“在文件管理器中打开”按钮:

  • 配置文件夹 — 保存您的首选项 JSON 文件(此页面的设置、会话自动化、硬件兼容性、SimConnect 主机/端口、保存的飞机配置文件绑定)。 打开配置 在文件管理器中跳转到那里。
  • 诊断文件夹 — 保存滚动会话日志和任何挂起的崩溃日志。 打开诊断 跳转到那里。如果您导出一个,这就是捆绑的内容 支持包.

两个文件夹都留在这台电脑上;除非你选择把支持包附到反馈中,否则不会上传任何内容。

本地诊断数据

两个用于清理本地诊断状态的按钮:

  • 清除崩溃报告 — 删除磁盘上任何挂起的崩溃报告。在您发送崩溃包并想要开始清理后,或者如果过时的崩溃标记使桥在启动时不断显示崩溃恢复对话框时,这很有用。
  • 清除日志 — 删除诊断文件夹中的会话日志文件。 “诊断”选项卡上显示的内存日志不受影响,并继续捕获新行。

崩溃日志和会话日志会留在这台电脑上,除非你通过支持包把它们附给支持。

硬件选项卡

硬件选项卡拥有每次安装的设备和驱动程序旋钮。其中大多数在桥启动强制运行时时会被读取一次,因此更改它们会提示一个小的 重新启动 对话框(立即重新启动/稍后重新启动/取消);取消会恢复更改。

力反馈装置

当连接了多个受支持的摇杆时,此行可让您选择由 FFB-Bridge 驱动哪一个。 更改设备... 打开一个选择器,其中每个附加的受支持实例一行,以及一个 自动 行,以及表示当前未插入的受支持摇杆的灰显行。当存在两个或更多受支持的摇杆且您尚未选择时,选择器也会在首次启动时自动打开。固定项在重启后仍然保留;如果您将摇杆移到其他 USB 端口,该会话会回退为自动,移回后会恢复固定项。

效果渲染

一个单选项,用于设置周期性和单次提示(隆隆声、抖振、颤振)如何传递到摇杆。 硬件效果 ——默认值——通过设备的原生力反馈路径驱动它们。 软件兼容模式 仅保留连续力/回中的硬件路径,并在软件中合成周期性与一次性线索,将它们折叠进恒力输出。软件模式是在硬件模式下崩溃的驱动栈的后备方案;两种模式使用相同的效果和相同的调校滑块。有一个 测试硬件效果 此选项卡上的按钮会运行一个进程外探测——如果驱动栈崩溃,只有探测进程结束,而网桥保持打开状态。

Windows 设备后端

在 Windows 上,网桥默认通过原始 HID/PID 路径与经过验证的 SideWinder FFB2 通信,并保留 DirectInput 作为自动后备。如果某次安装确实需要,这一行可让您直接从 DirectInput 启动。

允许未列出的设备(实验性)

默认情况下,桥接器仅驱动已验证的摇杆。开启此项以实验性地驱动一个力反馈 摇杆 不在受支持列表中。方向盘、游戏手柄和单轴设备不符合条件,将改为路由到独立的 FFB 探针。启用后,使用下面的轴测试凭手感纠正方向。

轴测试(反转+俯仰/滚动交换)

用于校正摇杆方向的实时测试。在小型 X-Y 触控板上拖动圆点,摇杆会实时跟随(在此期间桥接器会在模拟模式下自动布防)。如果摇杆移动方向相反,请翻转 反转轴极性;如果俯仰和滚转互换了,则翻转 交换俯仰/滚转轴。两者都实时生效(无需重启),并且都在设备输出端将两个轴作为一对一同应用。对于尚不清楚其接线约定的未列出摇杆,它们尤其有用。