NextATC Unicom

NextATC 指南NextATC 帮助与 FAQ

故障排查

按用户实际遇到的先后顺序排列的常见问题。

按用户实际遇到的先后顺序排列的常见问题。

如果您的问题与语音相关,请同时参阅 语音与一键通话(Push-to-Talk)。

NextATC 菜单未出现#

插件未加载。请检查:

  • 文件夹位于 X-Plane/Resources/plugins/NextATC/(必须完全是此路径)。
  • 文件夹名称未被改动。
  • 在 macOS 上,Gatekeeper 可能已阻止该二进制文件。重新运行随附的 installers/Install - macOS.sh(它会去除 com.apple.quarantine 属性),或打开 System Settings -> Privacy & Security,允许被阻止的 X-Plane 插件。

然后打开 X-Plane/Log.txt 并搜索 NextATC。日志通常会明确说明插件未加载的原因。

Radio Log 中没有 ATC 动作出现#

逐条检查:

  • 插件已启动(Plugins -> NextATC -> Start plugin)。
  • 飞机已通电。COM 电台已开启。
  • 您调谐到了适合当前阶段的频率。IFR 放行用 Delivery;开车/推出/滑行用 Ground;起飞与着陆用 Tower;空中用 Approach/Center。
  • Frequency Box 已关闭,或 Radio Log 处于焦点。如果 Handoff 一直在调谐频率,请点击 Radio Log。
  • Options 中 Radio Log -> Enabled 已开启。Max visible lines 至少为 2。

Handoff 调谐了频率,而不是确认复诵#

打开的 Frequency Box 具有优先级。关闭它,或点击 Radio Log 将焦点转移,然后再按 Handoff。

如果您想恢复频率优先级,使用 NextATC/frequency_selector_toggle 重新打开 Frequency Box。

起飞跑道或 SID 与我预期的不同#

NextATC 会依据机场数据、当前风向、机场流向、您的飞机位置以及插件逻辑挑选跑道。它不一定与某个在线网络的 ATIS 或第三方工具匹配。

在提交计划前，在飞行计划对话框中选择 Override departure runway；随后的起飞对话框将为该固定跑道选择 SID。到达跑道和 STAR 的选择仍留在 Arrival Runway 对话框中。参阅 离场 和 进场。

找不到 SID 或 STAR#

可能的原因:

  • 所选跑道在您的航路端点上没有已发布的 SID/STAR。
  • 您的巡航高度超出了程序的限制范围。
  • 导航数据已过期或不完整。

变通办法:

  • 使用 Don't use SID / Don't use STAR。
  • 选择一个不同的首个/最后一个航路定位点,使其与已发布的程序相连。
  • 更新插件的 navdata 文件夹。参阅 导航数据。

滑行引导线未出现#

在 Options 中启用 Draw taxi guide on ground。引导线只在插件为当前阶段获得了有效的地面路径时才显示。某些机场的滑行路网不完整;插件会在可能时回退至中线数据,但并非每个场景包都暴露可用的路径数据。

ATC 一直纠正我的高度#

两个常见原因:

  • 高度表设置:在过渡高度(transition altitude)以上,应使用标准气压(1013/29.92);在过渡高度层(transition level)以下,应使用当地 QNH/高度表设置。
  • SID/STAR 限制:如果您启用了 Respect SIDs and STARs restrictions,管制员会期望您遵守程序的高度区间。

TTS 没有声音#

逐条检查:

  • Options 中 Read ATC messages (TTS) 已开启。
  • 您的操作系统至少安装了一种语音。
  • 如果您设置了自定义语音,Voice Roles 必须有效(语音名称无拼写错误)。
  • 如果 Speech engine 为 Microsoft Azure，Azure 密钥和区域必须有效。参阅 Azure 设置。
  • 您的声音输出设备未静音。

语音识别什么都识别不到#

请参阅 语音与一键通话(Push-to-Talk)。简短版:

  • 麦克风在另一个应用中可正常使用。
  • 所选识别模型已在 Options 中下载。
  • PTT 命令已绑定到一个按键。
  • 您在讲话时按住了该按键。

如有疑问,用鼠标点击 Readback。语音是可选的。

我在 Nav Display 上看不到任何交通#

NextATC 会显示通过 X-Plane TCAS datarefs 发布的交通;当 Traffic engine 开启时,也会显示自身的合成交通。如果没有发布器(X-Plane AI、LiveTraffic、XSquawkBox 或 NextATC 自身的合成交通),地图标记和 Airport 航班板按设计就是空的。参阅 交通(Traffic)。

随机飞行没有开始#

请检查 Options 中的地区筛选。至少要启用一个地区,并且所选地区中要有合适机场。如果你想自己选择航路,也可以在飞行计划对话框中手动提交计划。

插件窗口出现在错误的显示器上#

打开 Options -> NextATC Windows Monitor 并选择目标显示器。如果只有一块屏幕,请使用 Auto / Primary。

设置存储在哪里?#

X-Plane/Resources/plugins/NextATC/settings.ini
X-Plane/Resources/plugins/NextATC/traffic_settings.ini

X-Plane 关闭时,您可以使用任意文本编辑器编辑这些文件。使用 Options -> Voice 中的语音角色控件来配置语音。

日志在哪里?#

X-Plane/Log.txt

报告 bug 时,请附上机场、跑道和飞行阶段,并在有用时提供截图。内置的报告程序会准备当前飞行的诊断信息。通过网页提交 bug 报告需要受影响且可读的 Log.txt；上传前请检查其中是否包含隐私信息。参阅 错误报告与功能请求。

显示了 ATC 文本但没有语音#

请检查以下各项，并记下结果以便报告：

  • Read ATC messages (TTS) 已开启，以及所选的 Speech engine。
  • 在该引擎的语音角色窗口中按下 ATC 语音测试：Kokoro 和 Piper 为 Test current ATC，Azure 和 Windows 语音为 Test current ATC voice。记下是否有声音。
  • settings.ini 的 [Radio] 部分包含相关的非机密值：isSpeechActivated, ttsEngine, azureTtsOn, disableVoiceOnReadBack, xAtcChatterCompatibility。

X-Plane 变慢、卡顿或掉帧（FPS 下降）#

性能问题、lag（延迟）、卡顿、变慢以及帧率（FPS）下降可能来自 NextATC 的多项功能。这些影响会叠加，因此请逐一检查；最简单的测试是一次关闭一项并观察帧率。

  • 内置交通。 合成交通引擎可能带来显著负载，并随飞机数量增加。在 Traffic Options... 中降低 Traffic amount，关闭 Draw 3D aircraft 使飞机仅显示在 TCAS 和 Nav Display 上，或关闭 Traffic engine。
  • 本地语音（Kokoro 和 Piper）。 每次语音通话（包括交通的无线电通话）都在您的 CPU 上生成。这会在每次 ATC 或交通说话时造成短暂掉帧，在繁忙机场更明显。启用 Light models（默认设置）的 Piper 是最轻量的本地选项，所需 CPU 约为高质量 Piper 模型的八分之一；Kokoro 的 Compact model (114 MB instead of 325 MB) 对其负载的降低较少。请确保已下载所选模型，在 Speech engine 中选择 Microsoft Azure（在云端生成），或关闭 Read ATC messages (TTS) 只保留文本。在 macOS 和 Windows 上，本地语音已经以低于 X-Plane 的优先级运行。
  • 语音识别（Whisper）。 转录麦克风音频会使用 CPU，或在启用 Use GPU acceleration 时使用 GPU（受支持的 Apple silicon Mac 上为 Metal，Windows 上为 NVIDIA CUDA）。模型越大越慢：使用 Whisper Base English，在可用时启用 Use GPU acceleration，或关闭 AI Voice Recognition (Experimental)。
  • AI 措辞生成（Gemini）。 措辞在云端生成，因此不会在您的计算机上运行语言模型。

如果掉帧恰好发生在 ATC 说话时，请先检查本地语音设置；如果持续存在，请先检查交通。

另见#