메인 콘텐츠로 건너뛰기

GameInputGamepadInfo

게임패드의 속성을 설명합니다.

구문

멤버

supportedLayout
형식: GameInputGamepadButtons
게임패드의 레이아웃을 설명합니다. 축은 버튼 변환을 가지므로, 이를 사용해 게임패드에 존재하는 축을 확인할 수 있습니다. menuButtonLabel
형식: GameInputLabel
Menu 버튼의 물리적 레이블입니다. viewButtonLabel
형식: GameInputLabel
View 버튼의 물리적 레이블입니다. aButtonLabel
형식: GameInputLabel
A 버튼의 물리적 레이블입니다. bButtonLabel
형식: GameInputLabel
B 버튼의 물리적 레이블입니다. cButtonLabel
형식: GameInputLabel
C 버튼의 물리적 레이블입니다. xButtonLabel
형식: GameInputLabel
X 버튼의 물리적 레이블입니다. yButtonLabel
형식: GameInputLabel
Y 버튼의 물리적 레이블입니다. zButtonLabel
형식: GameInputLabel
Z 버튼의 물리적 레이블입니다. dpadUpLabel
형식: GameInputLabel
D 패드 위의 물리적 레이블입니다. dpadDownLabel
형식: GameInputLabel
D 패드 아래의 물리적 레이블입니다. dpadLeftLabel
형식: GameInputLabel
D 패드 왼쪽의 물리적 레이블입니다. dpadRightLabel
형식: GameInputLabel
D 패드 오른쪽의 물리적 레이블입니다. leftShoulderButtonLabel
형식: GameInputLabel
왼쪽 숄더 버튼의 물리적 레이블입니다. rightShoulderButtonLabel
형식: GameInputLabel
오른쪽 숄더 버튼의 물리적 레이블입니다. leftThumbstickButtonLabel
형식: GameInputLabel
왼쪽 썸스틱의 물리적 레이블입니다. rightThumbstickButtonLabel
형식: GameInputLabel
오른쪽 썸스틱의 물리적 레이블입니다. extraButtonCount
형식: uint32_t
게임패드 버튼에 매핑되지 않은 장치 버튼의 개수입니다. extraAxisCount
형식: uint32_t
게임패드 축에 매핑되지 않은 장치 축의 개수입니다.

설명

이 구조체는 GameInputDeviceInfo 구조체에서 사용됩니다. GameInputDeviceInfo는 IGameInputDevice::GetDeviceInfo 메서드에서 사용됩니다. 자세한 내용은 GameInput 장치를 참조하세요.

게임패드 레이아웃

GameInput은 단일 표준 레이아웃에 대한 지원을 제한하지 않고 다양한 형태의 게임패드를 지원합니다. 이는 GameInputGamepadButtons 형식의 비트 필드로 이 구조체의 supportedLayout 멤버를 통해 노출됩니다. 축은 GameInputGamepadLeftTriggerButton과 같은 축-대-버튼 변환을 통해 이 열거형에도 존재합니다. 이러한 변환에 대한 자세한 내용은 GameInputGamepadButtons를 참조하세요. 게임패드에 필요한 최소 레이아웃은 없으며, 지원되는 축과 버튼의 어떤 조합도 가질 수 있습니다. 지원되지 않는 버튼이나 축은 남겨두고 추가 축이나 버튼으로 접근할 것으로 기대됩니다. 일반적인 게임패드 요소 그룹과 일반적인 레이아웃을 상수로 정의했습니다. 이를 사용하여 일반적인 레이아웃을 빠르게 식별하거나 특정 입력을 필터링하거나 사용자 지정 레이아웃을 만들 수 있습니다. 자세한 내용은 GameInputGamepadButtons를 참조하세요. 예상되는 지원 레이아웃과 형태의 범위가 무제한이기 때문에, 매핑 및 게임패드 사용자가 따라야 할 몇 가지 소수의 고려 사항과 동작이 있습니다:
  • 썸스틱, 숄더 또는 트리거와 같이 두 개가 있는 요소의 경우, 중앙에 하나가 있다면 기본적으로 왼쪽 요소가 되어야 합니다. 장치의 왼쪽이나 오른쪽에 배치된 경우 그에 따라 매핑되어야 합니다.
  • 서로 다른 글리프로 인한 모호성을 방지하기 위해, 페이스 버튼은 글리프에 관계없이 물리적 위치에 따라 다음과 같이 매핑되고 읽혀야 합니다:
게임패드 페이스 버튼 레이아웃 가이드라인 다음 코드 예제는 게임패드가 레이아웃 또는 특정 입력이나 모듈을 지원하는지 확인하는 방법을 보여줍니다.
다음 코드 예제는 사용자 지정 레이아웃을 만들고 게임패드가 이를 지원하는지 확인하는 방법을 보여줍니다.

요구 사항

헤더: GameInput.h 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
GameInput

버전 기록

부록: 이전 버전

v0, v1, v2

마지막 수정일 2026년 10월 19일