JoyPro 1(2021 到 2023 年)是一個 DCS 工具:它在不同飛機的輸入之間建立關聯,並把它們綁定到搖桿上的同一個位置。JoyPro 2 完全保留了這個理念,以及相同的關聯/綁定/修飾鍵模型(JoyPro 1 的設定檔可以在 JoyPro 2 中開啟),並重建了圍繞它的一切:全新的介面、也能獨立執行的引擎、數十款遊戲、每項功能都有測試,以及大量的安全措施。
#數字
所有數字都是在兩個專案的原始碼上量測的(git 追蹤的檔案;程式碼行數 = 非空白且非註解的 C# 行)。JoyPro 2 的數字來自本網站的建置。
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| 開發期間 | 2021-02-11 到 2023-11-15 | 自 2026-09-30 起 |
| 提交次數 | 336 | 1,406 |
| C# 程式碼行數 | 25,502 | 354,663(13.9 倍) |
| C# 檔案 | 77 | 954 |
| 型別(類別、記錄、列舉……) | 106 | 3,059(29 倍) |
| 方法 | 450 | 16,702(37 倍) |
| 自動化測試(單元、檢視模型、算繪) | 0 | 1,537 項,分布在 198 個測試檔案中 |
| 引擎冒煙測試部分(真實引擎搭配測試資料夾) | 0 | 87 |
| 方案中的專案 | 2 | 12 |
| 介面標記行數 | 973(WPF XAML) | 17,250(Avalonia AXAML) |
| 文件行數(Markdown) | 109 | 25,636 |
| 遊戲 | 1 款(DCS),後來加上 IL-2 | JoyPro 支援 36 款,研究過 57 款 |
| 介面語言 | 1 | 39 |
| 引擎指令(命令列) | 無(僅 GUI) | 451 個,分為 60 個領域,19 個全域選項 |
| 本網站記載的 GUI 控制項 | 1097 |
JoyPro 2 的程式碼分布(C# 程式碼行數):引擎 187,202、GUI 80,286、GUI 測試 56,600、力回饋 14,394。
flowchart LR W["一個視窗<br/>(畫面和邏輯<br/>合而為一)"] --> D1["DCS 檔案"]
flowchart TB G["視窗"] --> E["引擎<br/>(執行每個動作)"] G --> F["力回饋<br/>輔助程式"] G --> V["虛擬 joystick<br/>輔助程式"] T["系統匣中的<br/>監看程式"] --> E E --> D2["36 款遊戲"] F ~~~ V
給新手
#對您更好的地方
- 多款遊戲,一個設定檔。 JoyPro 1 是為 DCS 打造的。JoyPro 2 可以匯入和匯出 36 款遊戲:DCS、IL-2(Great Battles、Korea、1946、Cliffs of Dover)、Star Citizen、MSFS 2020 和 2024、X-Plane 11 和 12、Falcon BMS、War Thunder、Elite Dangerous、X4、Arma 等等。一個關聯就能在所有遊戲中保有相同的功能。
- 從您現有的開始。 匯入會從每款遊戲讀取您現有的綁定;首次啟動的設定會自動找到您的遊戲。
- 沒有東西會永久損壞。 每次匯出都會先備份遊戲檔案,復原上次匯出 會把它們一個位元組不差地還原。JoyPro 中的每項變更都會自動儲存,而且可以復原,即使重新啟動後也可以(設定檔歷程記錄)。
- 它會告訴您哪裡會出問題。 「檢查」會用遊戲的用語說明問題,並一鍵修正。
- 它會自己設定好。 全部幫我設定好 會把重要的功能放到您的搖桿、油門和腳舵上。您只要看一下清單,然後按 使用這些按鈕 和 寫入我的遊戲。
- 少點幾下。 建議、自動群組、自動指派、設定精靈和 JoyPro 助理會幫您建立關聯和綁定;學習而來的「您的風格」會依照您以前的做法。
- 它會注意到變更。 當您在遊戲中重新綁定某個東西時,JoyPro 會在遊戲關閉後詢問您是否要把它納入設定檔。
- 您的語言。 介面支援 39 種語言。
- 不只是綁定。 裝置圖片和速查表、HUD 和直播覆蓋層、來自遙測資料的力回饋、給只讀取一個裝置的遊戲用的虛擬 joystick、給只認得 Xbox 手把的遊戲用的模擬手把(虛擬 Xbox 手把)、座艙資料庫,以及您飛行內容的統計。
- 每個按鈕都有說明。 F1 會說明任何按鈕,導覽會指向真正的按鈕,簡單用語則讓內容保持簡短。
- 不用到處找額外的執行階段。 發行版是一個 zip,所有東西都在裡面;不需要 SlimDX,也不需要 C++ 執行階段。
進階
#逐項功能比較
| 領域 | JoyPro 1 | JoyPro 2 |
|---|---|---|
| 關聯 | 手動,DCS ID | 手動搜尋所有遊戲、同義詞、功能目錄、附理由的建議、自動群組、依說明分組、助理;每架 DCS 飛機的「相同 ID,不同意義」 |
| 綁定 | 錄製按鈕或軸 | 錄製、跟隨輸入、在裝置圖片上綁定、任何裝置組合的自動指派、設定精靈、用 AI 配置 |
| 軸調校 | DCS 曲率、死區、飽和度 | 每個遊戲用自己的回應模型,依飛機設定範圍、校準、段位模式 |
| 修飾鍵 | 是 | 有,附修飾鍵頁面、組合、依遊戲轉換(BMS shift 等) |
| 匯出 | DCS(清理、全部清除) | 所有遊戲;四種模式加上「同時清除」、依飛機、與 DCS 預設值的最小差異、標示未寫入的綁定、備份與復原 |
| 匯入 | DCS | 所有遊戲,含預設值、鍵盤、裝置合併、重新匯入名稱/群組/修飾鍵 |
| 安全 | 「請自己備份」 | 自動版本化備份、遊戲執行中時拒絕寫入、可跨工作階段復原的設定檔歷程記錄、測試中的寫入沙箱 |
| 檢查 | 驗證 | 檢查:以遊戲用語呈現的卡片、一鍵修正、從歷程記錄找出原因 |
| 配置圖 | 匯出配置圖圖片 | 裝置參考圖片(依 VID:PID 和 HID 名稱辨識確切型號)、速查表、3D 裝置檢視 |
| 覆蓋層 | 遊戲內覆蓋層 | HUD 設計工具、覆蓋層、OBS 用的直播頁面、即時輸入 |
| 遊戲清單 | 隨附資料庫(html) | 在您的電腦上從您自己的安裝建置,遊戲更新後重新整理 |
| 監看 | 無 | 遊戲設定檔監看器,附系統匣主程式,在遊戲結束後詢問 |
| 力回饋 | 無 | DCS、IL-2、War Thunder 等遊戲的遙測力回饋(JoyPro.Ffb) |
| 虛擬裝置 | 無 | vJoy / Xbox 手把模式搭配 HidHide、虛擬功能、Joystick Gremlin 匯入 |
| 語言 | 英文 | 39 |
| 更新 | 手動下載 | 附版本資訊的更新檢查、經總和檢查碼驗證的安裝 |
| 問題報告 | 到 Discord 詢問 | 一個支援檔案,含記錄、設定和(應要求)設定檔;使用者資料夾已替換;不會上傳任何東西 |
技術細節
#架構與品質
- 分成引擎與 GUI。 JoyPro 1 是單一的 WPF 應用程式,邏輯寫在視窗程式碼中。JoyPro 2 有一個引擎(
engine.exe,.NET Framework 4.8,純 C#),以 451 個指令承載所有設定檔、匯入/匯出和資料庫邏輯,還有一個 Avalonia GUI(.NET 9),每個動作都會執行引擎。快速的互動指令會交給一個長時間執行的engine serve,因此 GUI 能保持快速,又不必放棄這種分離。GUI 能做的所有事情都可以用指令碼完成(請參閱 引擎命令列)。 - 常駐工作使用獨立的處理程序:
JoyPro.Ffb.exe(遙測力回饋)、JoyPro.VJoy.exe(虛擬 joystick 轉送程式)、JoyPro.Tray.exe(GUI 關閉時的監看程式),每個都有資源預算和長時間穩定性測試,讓它們在背景中不被察覺。 - 測試:1,537 個自動化測試(xUnit:引擎邏輯、檢視模型、各頁面在淺色和深色主題下的離屏繪製),87 個引擎冒煙測試項目,以真正的引擎對測試用資料夾執行,一個可選用的品質關卡,對真實資料做不變條件檢查,以及支援的遊戲中的遊戲內端對端測試。測試在寫入沙箱中執行,並對真實資料夾做指紋檢查,因此沒有任何測試能碰到真正的遊戲資料夾。
- 資料:遊戲指令清單是在使用者的電腦上,從已安裝的遊戲建置到
%LOCALAPPDATA%\JoyPro2\GameData;JoyPro 只隨附自己的資料(功能目錄、裝置目錄、轉換表、座艙資料庫)。 - 文件從原始碼產生:遊戲支援矩陣來自程式碼(
engine games support),CLI 參考來自engine --help,而本網站則來自 AXAML、檢視模型和文件。