> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInput 裝置對應工具和測試指南

> GameInput 裝置對應工具和測試指南

GameInput 裝置對應工具可在 [GameInput GitHub 專案](https://github.com/microsoftconnect/GameInput)中找到，是硬體開發人員用來測試 GameInput API 如何辨識及對應其裝置的公用程式。此工具提供視覺化介面，可用於檢查裝置的輸入報告，以及 API 所產生的 GameInput 讀數和裝置資訊。此資訊特別有助於偵錯及驗證新裝置的行為，或了解 GameInput 如何解譯現有裝置。

由於一般 HID 裝置可能會被目標系統以多種方式解譯，GameInput 依賴內建於 Windows 登錄中的一系列裝置對應延伸模組。您可以在 `HKLM\SOFTWARE\Microsoft\GameInputRedist` 中找到它們。Windows.Gaming.Input (WGI) API 會共用這些對應，並為 GameInput 提供額外的延伸模組。如需詳細資訊，請參閱[遊戲控制器的登錄資料](https://learn.microsoft.com/windows/uwp/gaming/registry-data-for-game-controllers)。GameInput 裝置對應工具可讓硬體開發人員為其裝置產生這些對應，並即時進行測試。

啟動此工具時，您可以選取其中一個已連線的遊戲台配件。GameInput 會列舉所有啟用 XInput 的裝置，以及使用方式頁面為 0x0001 (Generic Desktop Controls) 且使用方式為 0x0005 (Game Pad) 或 0x0004 (Joystick) 的 HID 裝置。選取裝置時，此工具預設會顯示產生的 GameInput 讀數和裝置資訊。

進入設定流程後，您可以從 Windows PC 上目前可用的任何設定 (如果有的話)、從此工具所建立的現有登錄檔案，或從頭開始繼續。此工具會引導您完成將裝置的輸入報告對應至 GameInput 介面 (例如遊戲台、飛行搖桿、賽車方向盤和 UI 瀏覽控制器) 的過程。接著，您可以將這些對應與裝置特有的標籤協調一致，或將其預設為 XInput 裝置所使用的標籤。您也可以新增對觸覺回饋和陀螺儀等進階功能的支援。最後，您可以在認可變更之前即時測試產生的對應。

此工具可以將對應匯出為檔案。接著，您可以手動將檔案提交給 Microsoft 以供考量 (請使用 [GameInput NuGet 頁面](https://www.nuget.org/packages/Microsoft.GameInput)中的 'Contact Owners' 連結)、隨驅動程式一起出貨，或將其納入應用程式的安裝套件中。

<a id="seealsoSection" />

## 另請參閱

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)
[XInput 遊戲控制器 API](https://learn.microsoft.com/windows/win32/api/_xinput/)
[Game Input Protocol (GIP) / XInputHID 驅動程式文件 (下載)](https://aka.ms/gipdocs)
[遊戲控制器的登錄資料](https://learn.microsoft.com/windows/uwp/gaming/registry-data-for-game-controllers)


## Related topics

- [適用於硬體開發人員的 GameInput](/zh-TW/build/core-features/common/input/hardware/input-hardware-topics.md)
- [GameInput 硬體：力回饋、觸覺回饋和感應器](/zh-TW/build/core-features/common/input/hardware/index.md)
- [GameInput 中的鍵盤和滑鼠](/zh-TW/build/core-features/common/input/advanced/input-keyboard-mouse.md)
- [GameInput 裝置](/zh-TW/build/core-features/common/input/overviews/input-devices.md)
- [與不同的 GameInput 裝置類型互動](/zh-TW/build/core-features/common/input/hardware/input-hardware-interfaces.md)
