> ## 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 Device Mapping Tool およびテストガイド

> GameInput Device Mapping Tool およびテストガイド

GameInput Device Mapping Tool は [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 向けの追加拡張と共に共有します。詳細については、[Registry Data for Game Controllers](https://learn.microsoft.com/windows/uwp/gaming/registry-data-for-game-controllers) を参照してください。GameInput Device Mapping Tool を使用すると、ハードウェア開発者はデバイス用のこれらのマッピングを生成し、リアルタイムでテストできます。

ツールを起動すると、接続されているゲームパッドアクセサリのいずれかを選択できます。GameInput は、すべての XInput 対応デバイス、および usage page 0x0001 (Generic Desktop Controls) と usage 0x0005 (Game Pad) または 0x0004 (Joystick) を持つ HID デバイスを列挙します。デバイスを選択すると、ツールは既定で結果の GameInput 読み取り結果とデバイス情報を表示します。

構成フローに進むことで、現在 Windows PC で利用可能な構成 (存在する場合)、このツールで作成された既存のレジストリファイル、またはゼロから続行できます。ツールは、デバイスの入力レポートを、ゲームパッド、フライトスティック、レーシングホイール、UI ナビゲーションコントローラーなどの GameInput インターフェイスにマッピングするプロセスをガイドします。その後、これらのマッピングをデバイス固有のラベルと調整するか、これらを XInput デバイスで使用されるラベルに既定で設定できます。触覚やジャイロなどの高度な機能のサポートを追加することもできます。最後に、変更をコミットする前に、結果として得られるマッピングをリアルタイムでテストできます。

ツールはマッピングをファイルとしてエクスポートできます。その後、そのファイルを検討のために Microsoft に手動で提出する ([GameInput NuGet ページ](https://www.nuget.org/packages/Microsoft.GameInput) の「Contact Owners」リンクを使用)、ドライバーとともに出荷する、またはアプリケーションのインストールパッケージに含めることができます。

<a id="seealsoSection" />

## 関連項目

[GameInput の概要](/build/core-features/common/input/overviews/input-overview)
[XInput Game Controller APIs](https://learn.microsoft.com/windows/win32/api/_xinput/)
[Game Input Protocol (GIP) / XInputHID driver documentation (download)](https://aka.ms/gipdocs)
[Registry Data for Game Controllers](https://learn.microsoft.com/windows/uwp/gaming/registry-data-for-game-controllers)


## Related topics

- [ハードウェア開発者向け GameInput](/ja-jp/build/core-features/common/input/hardware/input-hardware-topics.md)
- [PlayFab Party 音声認識およびテキスト表示 UX ガイドライン](/ja-jp/services/playfab/community/voice-communications/party-speech-to-text-ux-guidelines.md)
- [PlayFab Party テキスト読み上げおよびテキスト入力 UX ガイドライン](/ja-jp/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines.md)
- [Handheld Compatibility ガイドラインとテスト ケース](/ja-jp/build/gdk-and-engines/handheld/handheld-guidelines-and-testcases.md)
- [コンテンツ更新の作成、検査、およびテスト](/ja-jp/build/core-features/common/packaging/packaging-testing-updates.md)
