> ## 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 GitHub 프로젝트](https://github.com/microsoftconnect/GameInput)에서 찾을 수 있는 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에서 사용 가능한 구성(있는 경우), 이 도구로 생성한 기존 레지스트리 파일 또는 처음부터 시작하여 계속 진행할 수 있습니다. 도구는 장치의 입력 보고서를 게임패드, 플라이트 스틱, 레이싱 휠, UI 내비게이션 컨트롤러 등 GameInput 인터페이스에 매핑하는 과정을 안내합니다. 그런 다음 이러한 매핑을 장치 고유의 레이블과 조율하거나, 기본값으로 XInput 장치에 사용되는 레이블로 설정할 수 있습니다. 햅틱 및 자이로와 같은 고급 기능에 대한 지원도 추가할 수 있습니다. 마지막으로, 변경 사항을 커밋하기 전에 결과 매핑을 실시간으로 테스트할 수 있습니다. 이 도구는 매핑을 파일로 내보낼 수 있습니다. 그런 다음 이 파일을 검토 요청을 위해 Microsoft에 수동으로 제출하거나([GameInput NuGet 페이지](https://www.nuget.org/packages/Microsoft.GameInput)의 'Contact Owners' 링크 사용), 드라이버와 함께 배포하거나, 애플리케이션 설치 패키지에 포함할 수 있습니다. ## 함께 보기 [GameInput 개요](/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](/ko/build/core-features/common/input/hardware/input-hardware-topics.md) - [GameInput 하드웨어: 포스 피드백, 햅틱 및 센서](/ko/build/core-features/common/input/hardware/index.md) - [Handheld Compatibility 가이드라인 및 테스트 케이스](/ko/build/gdk-and-engines/handheld/handheld-guidelines-and-testcases.md) - [인증 단계별 가이드](/ko/publishing/game-publishing/concepts/certification/certification-guide.md) - [다양한 GameInput 장치 유형과의 인터페이스](/ko/build/core-features/common/input/hardware/input-hardware-interfaces.md)