FSX、FSX: Steam Edition 以及 Prepar3D v4、v5 和 v6 會把您的操控設定保存在 %APPDATA% 中的一個 XML 檔案裡:每個裝置一個對應表,包含它的軸、按鈕和帽子開關,另外還有鍵盤。JoyPro 會把這個檔案讀入您的設定檔,在關聯中與您的其他遊戲結合,然後逐區塊寫回,並保留格式、註解和其他對應表。每個模擬器在 JoyPro 中都是獨立的遊戲,因為各自有自己的檔案。
這項整合是依據公開資料撰寫的,只有一個合成的測試檔案驗證:這些模擬器都還沒有在實際安裝上用 JoyPro 測試過。第一次匯出後,請開啟模擬器的操控設定並檢查指派結果,如有不同之處,請回報給我們。
Microsoft Flight Simulator X 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine fsx- 綁定檔案
%APPDATA%\Microsoft\FSX\Controls\Standard.XML(XML)- 遊戲讀取的輸入
- 每支 joystick 讀取 32 個按鈕、8 個軸(使用者回報)
- 指令清單來源
- JoyPro 自己的事件清單(公開的 SDK ID)+ 您的控制檔與安裝目錄範本中的事件
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵FSX 與 Prepar3D:按鍵可用 Ctrl/Shift/Alt;joystick 綁定不能使用修飾鍵。
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✓ 軸曲線與死區
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✓ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
Microsoft Flight Simulator X: Steam Edition 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine fsxse- 綁定檔案
%APPDATA%\Microsoft\FSX-SE\Controls\(或 FSX 資料夾),XML- 遊戲讀取的輸入
- 每支 joystick 讀取 32 個按鈕、8 個軸(使用者回報)
- 指令清單來源
- 同 FSX
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵FSX 與 Prepar3D:按鍵可用 Ctrl/Shift/Alt;joystick 綁定不能使用修飾鍵。
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✓ 軸曲線與死區
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✗ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
Prepar3D v4 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine p3d4- 綁定檔案
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml(XML)- 遊戲讀取的輸入
- 每支 joystick 讀取 32 個按鈕、8 個軸(使用者回報)
- 指令清單來源
- JoyPro 自己的事件清單 + 您的控制檔 + 安裝目錄中的
Standard.xmlx
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵FSX 與 Prepar3D:按鍵可用 Ctrl/Shift/Alt;joystick 綁定不能使用修飾鍵。
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✓ 軸曲線與死區
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✗ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
Prepar3D v5 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine p3d5- 綁定檔案
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml(XML)- 遊戲讀取的輸入
- 每支 joystick 讀取 32 個按鈕、8 個軸(使用者回報)
- 指令清單來源
- 同 Prepar3D v4
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵FSX 與 Prepar3D:按鍵可用 Ctrl/Shift/Alt;joystick 綁定不能使用修飾鍵。
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✓ 軸曲線與死區
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✓ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
Prepar3D v6 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine p3d6- 綁定檔案
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml(XML)- 遊戲讀取的輸入
- 每支 joystick 讀取 32 個按鈕、8 個軸(使用者回報)
- 指令清單來源
- 同 Prepar3D v4
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵FSX 與 Prepar3D:按鍵可用 Ctrl/Shift/Alt;joystick 綁定不能使用修飾鍵。
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✓ 軸曲線與死區
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✗ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
摘自支援矩陣(由引擎程式碼產生): 所有遊戲.
#3 個步驟就能用
- 全部幫我設定好
在「開始」頁面 - 使用這些按鈕
先查看清單 - 寫入我的遊戲
保持模擬器關閉
事前準備:連接裝置後啟動模擬器一次,然後關閉它。
接著:開啟模擬器的操控設定並檢查指派結果。這項整合尚未在實際安裝上測試:如有不同之處,請回報給我們。
您之前在模擬器中綁定過按鈕嗎?那麼「開始」頁面會提供 匯入,然後填補空缺。您的綁定會保留,只有空閒的按鈕會被指派新功能。請參閱 快速入門:讓我的搖桿能用。
#JoyPro 為 FSX 和 Prepar3D 做了什麼
- 匯入:您裝置的軸、按鈕和帽子開關會連同每個軸的靈敏度和零區一起進入您的設定檔。如果您要求,鍵盤按鍵也會一併匯入。
- 關聯:一個關聯就是您所有遊戲中的同一個功能(FSX、MSFS 和 X-Plane 中的「Gear」都在同一個按鈕上)。指令是模擬器公開的事件名稱(
GEAR_TOGGLE、AXIS_AILERONS_SET...)。 - 匯出:JoyPro 會寫入您所匯出模擬器的作用中操控檔案。
#匯入您的綁定
- 開啟 開始 頁面。您模擬器的卡片會顯示它的圖片。如果卡片要求指令清單,請按 建立清單:JoyPro 會把自己的事件清單,與您的操控檔案(以及模擬器自己的範本檔案)中提到的事件結合起來。
- 在卡片上按 匯入。選擇 加入我的設定檔,如果也要匯入按鍵,請勾選 同時取得鍵盤按鍵。
- 按 立即匯入。查看我的關聯 會開啟匯入的內容。
#建立並檢查關聯
在 關聯 頁面上,關聯的模擬器事件會和您其他遊戲中的同一功能並列。使用 關聯流程 將它們連結起來,然後在「匯出」頁面按 立即檢查(檢查功能)。
#匯出
- 關閉模擬器。 模擬器結束時會重寫檔案;當
fsx.exe或Prepar3D.exe正在執行時,JoyPro 會拒絕寫入。 - 開啟 匯出,並使用您模擬器的卡片。
- 如果您是用 JoyPro 設定裝置,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置。然後在卡片上按 立即匯出。
啟動模擬器並開啟它的操控設定:您裝置的指派會顯示在那裡,每個軸的靈敏度和零區則在其校準頁面上。確切的選單路徑以及模擬器如何顯示 JoyPro 的檔案,目前尚未確認。
#您在 FSX 和 Prepar3D 中需要自己做的事
- 連接裝置後 啟動模擬器一次,讓它寫入操控檔案。
- 第一次匯出後 檢查結果(見上文)。這是這項整合在您電腦上的第一次實際測試。
- 帽子開關會整個一起指派,通常用於視角平移(
PAN_VIEW)。單一帽子開關方向上的其他事件不會被寫入;請在模擬器中綁定它們。
#常見問題
- 「模擬器正在執行」:關閉它,然後重新匯出。
- 重新插拔後裝置失去了綁定:Windows 可能會給裝置一個新的 GUID。此時如果剛好只有一個已連接的裝置使用該名稱,JoyPro 就會依名稱找到它的對應表(並顯示警告)。
- 缺少一個搭配修飾鍵的搖桿綁定:這個格式不支援搖桿按鈕的修飾鍵。按鍵可以搭配 Ctrl、Shift 和 Alt。
#JoyPro 讀取和寫入的檔案
| 模擬器 | 控制設定檔 |
|---|---|
| FSX(盒裝版) | %APPDATA%\Microsoft\FSX\Controls\Standard.XML(使用中的檔案取自 fsx.cfg [CONTROLS] Controls_Current) |
| FSX: Steam Edition | 與盒裝 FSX 並存時為 %APPDATA%\Microsoft\FSX-SE\Controls\,單獨安裝時為 %APPDATA%\Microsoft\FSX\Controls\ |
| Prepar3D v4 / v5 / v6 | %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml(使用中的檔案取自 Prepar3D.cfg [CONTROLS]) |
| 全部 | <file>.joypro.json(JoyPro 寫入的輸入)、<file>.joypro-meta.json(供下次匯入使用的名稱、群組和調校) |
Prepar3D 的 Standard.xmlx(裝置預設集)和安裝資料夾中 FSX 的範本會為了建立指令清單而讀取,永遠不會被寫入。
#FSX 和 Prepar3D 的匯出模式
| 模式 | 模擬器中會發生什麼 |
|---|---|
| 僅新增 | 永遠不會移除或取代區塊。放在已有其他事件的輸入上的綁定不會寫入,並會列出。 |
| 更新,保留遊戲的綁定 | 取代您輸入上的事件(衝突的那個),其他一切保留。 |
| 更新,以我的設定檔為準 | 還會移除您所綁定事件的其他輸入(已連接裝置;鍵盤只在開啟鍵盤選項時)。 |
| 取代我的裝置上的綁定 | 您寫入的裝置的主要對應只保留您的綁定。 |
| + 同時清除我的其他裝置 | 其他已連接裝置的主要對應會被清空(對應本身保留)。 |
#永遠不會變更的內容
- 未連接裝置的對應、匯入時忽略的裝置,以及 JoyPro 轉送輸入的 vJoy 裝置。
- Slew 對應(
... SLEW {GUID})、Mouse Yoke、Mouse Look、Prepar3D 的個別 SimObject 對應,以及鍵盤對應(除非您匯出鍵盤綁定)。 - 由兩個一般按鍵組成的組合鍵、註解、格式和未知的元素。
#曲線與設定
- 細緻度:全域,所有飛機共用一個檔案。
- 軸設定(軸模型
fsx):每個裝置軸的靈敏度(0 到 127)和零區(0 到 127),與校準頁面上相同。預設曲線 會被換算過去(死區對應零區,飽和度對應靈敏度);曲線形狀沒有對應的設定。在「更新」模式下,當 JoyPro 的值只是單純的預設值時,模擬器中設定的值會保留。 - 反向:負的靈敏度。
- 沒有力回饋、遊戲設定或遙測。監看程式會在模擬器關閉後偵測變更。
#FSX 和 Prepar3D 整合的內部運作
flowchart LR
P["您的設定檔<br/>(關聯 + 綁定)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
E --> X["Controls / Standard.XML:<br/>每個裝置一個對應表<br/>(裝置名稱 {GUID}),<br/>KEYBOARD_MAIN(僅限<br/>鍵盤選項)"]
X --> G["模擬器的控制設定"]
程式碼:engine\Games\FsxIntegration.cs(一個類別,每個模擬器一個遊戲)、engine\Games\FsxControlsFile.cs(以文字方式編輯整個區塊)、engine\Games\FsxEvents.cs(JoyPro 的事件清單)。
- 格式:
<SimControls.Map>,含<Name>、<Axis>(<Index>0 到 7 = X、Y、Z、Rx、Ry、Rz、Slider、第二個滑桿;<AxEvent>、<AxScale>、<AxNull>)、<Entry>(從 0 起算的按鈕<Index>、<Down>/<Up>,重複事件為<DownRpt>1)和<POV>(整個帽子開關)。標頭encoding="Windows-1252"。 - 裝置:每個 DirectInput 裝置一個對應,名稱為
<instance name>{<instance GUID>};依 GUID 比對,否則在恰好只有一個已連接裝置使用該名稱時依名稱比對。檔案中沒有的裝置會得到新的對應。每個裝置回報 32 個按鈕和 8 個軸。 - 對應:
JOY_X..JOY_SLIDER2對應到<Index>0 到 7,JOY_BTN<n>對應到<Index>n-1,帽子開關放在其向上方向(JOY_BTN_POV1_U)。 - 指令清單:
engine fsx refresh-db(以及fsxse、p3d4、p3d5、p3d6):約 150 個帶有 JoyPro 標題的事件,加上您的控制設定檔和模擬器範本中提到的每個事件;AXIS_*事件是軸。 - 匯入 / 匯出:
engine fsx paths(使用中的檔案排在最前)、engine fsx import、engine fsx scan、engine fsx export,以及engine fsxse export、engine p3d4 export、engine p3d5 export、engine p3d6 export的對應指令。首次寫入前會先備份。
#已知限制
- 所有內容都需要在實際安裝上檢查:Prepar3D v4+ 的標頭以及
<Name>是否仍帶有 GUID、模擬器寫入的確切位元組、第二個滑桿的軸名稱,以及模擬器是否會保留 JoyPro 為它尚未看過的裝置新增的對應。 - FSX: Steam Edition 的設定檔名稱是推斷出來的。
- 測試:
engine\tests\smoke\fsx.ps1,使用依據文件格式建立的合成檔案。
此遊戲的所有技術說明(由儲存庫產生): fsx-p3d.md.