TrackAudio

音軌

適用於 macOS、Linux 和 Windows 的新一代 Audio-For-VATSIM ATC 用戶端。

發布

請參閱最新版本的發行版，請記住 Beta 版本可能不穩定。請在 GitHub 上回報任何問題。

常問問題

VectorAudio 和 TrackAudio 有什麼不同？

TrackAudio 只是 VectorAudio 的下一代版本，使用了一組不同的技術。 VectorAudio 不再維護和支持，因此您應該盡快切換到 TrackAudio。

我的 PTT 在 macOS 上無法使用

macOS 對後台鍵盤輸入有嚴格的權限。 TrackAudio 應在首次啟動時提示您要求輸入監控權限。有時，更新應用程式後，此設定會自行撤銷。在這種情況下，請前往“設定”->“隱私權和安全性”->“輸入監控”，然後在清單中新增 TrackAudio（如果已存在，請將其刪除）。這是必需的，因為否則，當視窗未對焦時，您的一鍵通將無法工作（如果您使用鍵盤一鍵通，則操縱桿一鍵通不需要此權限）

我嘗試設定 PTT，但顯示名稱“未知 (XXX)”

出現此問題的原因是 PTT 系統無法確定您嘗試綁定的金鑰的名稱。此按鍵仍可用作正常的一鍵通功能。但是，為了使我們能夠支援您選擇的金鑰，請開啟 GitHub 問題。包括您正在使用的作業系統、 trackaudio.log檔案的副本（有關檔案位置，請參閱下面的常見問題解答）以及您要綁定的金鑰的實際名稱。

我無法設定 PTT，因為它會自動分配給我的操縱桿

出現此問題的原因是某些操縱桿發送持續的按鍵命令。為了解決這個問題，我們實作了一種方法，可以在您選擇鍵盤上的 PTT 鍵時暫時停用操縱桿按鍵。若要使用此功能，請以滑鼠右鍵按一下設定對話方塊中的「設定新 PTT」按鈕，而不是左鍵。這將防止在您設定 PTT 鍵時按鍵偵聽器註冊操縱桿輸入。

日誌和設定檔儲存在哪裡？

在 macOS 上： ~/Library/Application Support/trackaudio在 Linux 上： ~/.local/state/trackaudio在 Windows 上： %LocalAppData%trackaudio

找不到我嘗試新增的電台

請您的 FE 在 AFV 資料庫中定義網站。根據 AFV FE 手冊，所有站點都應在資料庫中定義。如果您以沒有電台定義的 DEL、GND 或 TWR 身份登錄，TrackAudio 確實支援臨時電台創建。然後，它會將收發器放置在控制器用戶端中設定的可見性中心。

EuroScope 是否支援 RDF？

是的！ @KingfuChan 更新了 EuroScope 的 RDF 插件，以包含對 TrackAudio 的支援。在此存儲庫中找到該插件。

TrackAudio 支援高頻模擬嗎？

是的，但前提是您透過呼號添加頻率（必須在資料庫中定義）。高頻靜噪預設啟用

如果資料庫中不存在頻率，我可以手動新增頻率嗎？

是的，使用右側的選單，但是，這只會在您的 atc 用戶端中設定的可見性中心創建一個收發器（天線）。這意味著您將無法獲得與資料庫中定義的電台相同的無線電覆蓋範圍。

什麼是XC和XCA？

當您右鍵單擊正在聆聽的頻率上的 XCA 時，如果您以 ATC 身分登錄，則該頻率的所有收發器都會交叉耦合。這意味著該清單中的收發器接收的所有傳輸也將由所有其他收發器重新發射。這使得空域不同部分的飛行員能夠聽到彼此的聲音，因為他們可能會使用不同的收發器。一般來說，每次控制時都應該使用 XC。

當您左鍵單擊 XCA 時，您將啟動“交叉耦合”。這與在 Windows 版 AFV 中按一下「XC」相同，可讓您跨頻率交叉耦合，這表示您可以加入多組收發器，而不管頻率如何。但請注意，啟用此功能可能會導致無線電重疊。例如，如果您對一個頻率進行XCA，該頻率在鄰近vAcc 的邊界附近有一個收發器，而另一個頻率則位於扇區的另一端，遠離鄰近vAcc 的邊界，那麼您將突然擴展該第二個頻率的覆蓋範圍到與鄰居的邊境。當大扇區重新組合在一起時，此功能對於 CTR 位置最有用。

我可以使用插件擴展 TrackAudio/是否有 SDK？

是的！看看維基百科吧。 TrackAudio 提供 WebSocket 和 HTTP SDK。如果您需要其他功能，請打開一個包含詳細請求的問題，我很樂意查看它，但不提供任何保證。

TrackAudio 所需的連接埠和端點存取

為了發揮作用，TrackAudio 需要：

• 可與端點 raw.githubusercontent.com 建立 HTTPS（連接埠 443）連接

• 可與端點 voice1.vatsim.net 建立 HTTPS（連接埠 443）連接

• 可以透過 HTTPS（連接埠 443）連接到端點 slurper.vatsim.net

• 可以與 vatsim 伺服器建立 UDP 雙向連接

驗證您的防毒軟體、防火牆或其他網路控制器是否允許存取這些端點。

為了讓 SDK 發揮作用

• 本機 TCP 連接埠 49080 對 HTTP 和 WebSocket 開放

您的系統日期和時間也必須正確同步，以反映實際的當前時間（無論時區如何）。

如何啟用詳細日誌記錄（進階）

根據要求，您可以啟用後端的詳細日誌記錄，這可能會提供一些有用的偵錯資訊。為此，請在儲存配置和日誌檔案的資料夾中建立一個名為 verbose.enable 的空檔案。

我對 TrackAudio 有疑問

首先完整閱讀本文檔。如果您找不到問題的答案，請在 GitHub 上開啟問題，並附加 afv.log 檔案中的相關行，該檔案應與執行檔位於同一資料夾中。

安裝

Linux

ArchLinux

TrackAudio 在 AUR 中可用，並且可以使用您最喜歡的 AUR 幫助程式進行安裝，例如：

• yay -S trackaudio-bin

• paru -S trackaudio-bin

德班

TrackAudio 打包為.deb ，無需任何特定操作即可運行。

在發行版頁面上下載最新版本並運行 .deb 如果它沒有打開，您可能需要透過在 .deb 檔案上運行chmod +x來確保它具有作為可執行檔運行的權限。

注意：這將在 /usr/lib 中安裝 libafv_native.so，這是 TrackAudio 運行所需的函式庫。

macOS

在發布頁面下載最新版本並將 .app 安裝到您的應用程式資料夾中。

TrackAudio 有兩種版本，一個適用於 Apple Silicon (arm64)，另一個適用於 Intel Mac (x64)。

或者，可以使用 Homebrew 安裝 TrackAudio。執行以下指令首先安裝 Homebrew Tap，然後安裝 Homebrew Cask。這樣，當您運行brew upgrade時，應用程式就會升級。

 # 新增 Tapbrew Tap Flymia/homebrew-trackaudio# 安裝 caskbrew install --cask trackaudio

根據您的系統，cask 將安裝 ARM 版本或 x86_64 版本。

視窗

下載並安裝 Visual Studio c++ Redistributable，這是 TrackAudio 運行的要求

在發布頁面下載最新版本並執行可執行檔。這應該安裝 TrackAudio。

建造

依賴關係

TrackAudio 依賴 afv-native 和 SFML（用於輸入處理）。

建置專案需要cmake 。依賴項將在建置時透過 vcpkg 下載。有關更多詳細信息，請參閱 vcpkg.json。

在 Linux 上，需要以下軟體包： build-essentials libx11-dev libxrandr-dev libxcursor-dev libxi-dev libudev-dev libgl1-mesa-dev pkg-config ，您可能還需要更多軟體包來啟用不同的音訊後端，例如如 Alsa、JACK 或 PulseAudio。

在 macOS 上，需要 XCode 命令列工具、CMake 和 Homebrew，並且需要以下自製程式包： pkg-config

在 Windows 上，需要使用 Visual Studio（社群版即可）並安裝Desktop development with C++ 。

建構過程

如果尚未安裝cmake-js ，請執行npm install -g cmake-js 。對於第一次構建，運行以下命令：

 git 子模組更新 --init --remote backend/vcpkg
git 子模組更新 --init --remote backend/extern/afv-native
npm 運行建置：後端
npm 安裝
npm 運行開發

如果您只想修改前端，則後續建置僅需要npm run dev指令。建置 C++ 後端需要執行npm run build:backend 。

包裝

TrackAudio 將在 macOS 上自動打包為 .dmg、在 Linux 上打包為 .deb、在 Windows 上打包為 .exe 安裝程式。要打包，請為所需平台運行適當的命令。

平台	命令
Linux	npm run build:linux
蘋果	npm run build:mac
視窗	npm run build:win

貢獻

如果您想為該專案提供協助，我們隨時歡迎您提交 PR。 ？