Skip to main content
GameInput은 모든 종류의 입력 장치를 하나의 일관된 인터페이스를 통해 노출하는 차세대 입력 API입니다. 사용하기 쉬운 단순한 프로그래밍 모델로 설계되었습니다. GameInput은 가능한 최고의 성능을 위해 처음부터 새로 만들어졌습니다. GameInput API의 주요 기능은 다음과 같습니다.
  • 가용성 GameInput은 Microsoft Game Development Kit(GDK)를 통해 XBOX에서 사용할 수 있으며, NuGet을 통해 PC에서 사용할 수 있습니다. Windows 10 19H1(2019년 5월 업데이트)까지 거슬러 올라가는 이전 Windows 버전도 지원합니다.
  • 일관성 GameInput은 키보드, 마우스, 게임패드 및 기타 게임 컨트롤러의 입력을 하나의 통합된 입력 모델을 통해 공통 시간 기준에 동기화하여 노출합니다. 이러한 장치의 입력을 처리하는 코드는 동일한 함수를 많이 사용하지만 다른 필터가 적용되어 거의 동일합니다. 이러한 일관성 덕분에 입력 코드를 크게 변경하지 않고도 추가 입력 장치에 대한 지원을 쉽게 추가할 수 있습니다.
  • 기능 GameInput은 기존의 모든 입력 API(XInput, DirectInput, Raw Input, Human Interface Device(HID), WinRT API)의 기능을 모두 아우르는 상위 집합이며, 자체적인 새 기능도 추가합니다. GameInput의 기능은 단순한 고정 형식의 게임패드 상태부터 상세한 저수준 원시 장치 액세스까지 다양합니다. 폴링이나 콜백을 통해 이벤트 기반 방식으로 입력을 얻을 수 있습니다. 햅틱, 센서, 포스 피드백이 완전히 지원됩니다. 개발자는 GameInput 위에 서드파티 장치 SDK를 쉽게 작성하여 사용자 지정 장치 기능에 대한 액세스를 제공할 수 있습니다.
  • 성능 GameInput은 가능한 가장 낮은 입력 지연 시간과 리소스 사용량을 위해 Windows 하드웨어 인터페이스 바로 위에 구축되었습니다. 거의 모든 API 함수는 100% 스레드 안전을 유지하면서도 엄격한 성능 보장을 갖춘 락 프리입니다. 이러한 설계 덕분에 렌더 스레드처럼 시간에 민감한 컨텍스트에서 호출하기에 안전합니다(가장 큰 예외는 GameInputCreate 호출입니다). 고급 애플리케이션은 GameInput의 내부 비동기 작업 큐 스케줄링을 직접 제어하여, 어떤 스레드가 작업을 수행할지, 얼마나 자주 수행할지 제어할 수 있습니다.
  • 서비스 용이성 새 버전의 GameInput 런타임은 v.0에서 현재 버전까지의 모든 API 버전을 지원하며, 게임은 어떤 API 버전으로 개발되었는지 지정할 수 있습니다. 이러한 버전 관리 덕분에 새 기능과 개선 사항이 담긴 새로운 GameInput 버전이 릴리스되더라도 게임은 예상대로 계속 작동합니다. 또한 Windows 플랫폼이 발전함에 따라 새로 출시된 HW 장치 지원과 플랫폼 측 수정 사항을 포함하여 기존 타이틀도 삶의 질 개선을 누릴 수 있습니다.
  • 사용성 GameInput은 사용 편의성을 최우선으로 하여 설계되었습니다. 대부분의 일반적인 입력 작업은 단 몇 줄의 코드로 구현할 수 있습니다.

시작하기

대상 플랫폼에 관계없이 모든 새 코드에는 GameInput API를 사용하세요. 이전 버전의 Windows를 포함한 모든 Microsoft 플랫폼을 지원하며, 기존 API에 비해 뛰어난 성능을 제공합니다.
XBOX One용 GDK로 개발되는 게임의 경우 GameInput이 유일하게 사용 가능한 입력 API입니다.
PC를 대상으로 하는 게임을 개발하는 경우 Microsoft.GameInput NuGet 패키지에서 GameInput을 설치하세요. GameInput API에 대해 자세히 알아보려면 GameInput 기본 사항부터 시작하세요. 기존 코드베이스에서 입력 코드를 포팅 중이거나 GameInput의 확장 기능을 병행하여 적용할 계획이라면 API별 지침에 대해 GameInput 포팅 가이드를 참조하세요.

함께 보기

GameInput 기본 사항 NuGet으로 사용하는 PC용 GameInput GameInput 포팅 가이드 GameInput API 참조 Microsoft Game Development Kit
마지막 수정일 2026년 8월 24일