GameInput API는 게임 컨트롤러, 비행 스틱, 레이스 휠, 터치식 입력 등 다양한 장치에서 사용자 입력을 캡처하는 데 사용됩니다. 이러한 API에서 명시적으로 지원하지 않는 장치는 원시 장치 입력으로 읽을 수 있습니다.
참고 항목
Xbox가 아닌 Windows용으로 개발하는 경우 GameInput v.1 API로 업그레이드할 수 있습니다. 최신 버전이지만 콘솔과 호환되는 1:1이 아닙니다.
인터페이스
| 인터페이스 | 설명 |
|---|---|
| IGameInput | 장치 입력 스트림에 액세스하는 데 사용되는 프로세스별 싱글톤. |
| IGameInputDevice | 입력 장치를 나타냅니다. |
| IGameInputDispatcher | GameInput API로 실행되는 배경 작업 예약을 수동으로 제어할 수 있습니다. |
| IGameInputForceFeedbackEffect | 지원 입력 장치에서 힘 피드백 효과를 기술하고 추적합니다. |
| IGameInputRawDeviceReport | 입력 장치에 대해 전달된 원시 바이트 버퍼를 나타냅니다. |
| IGameInputReading | 단일 입력 업데이트를 위해 데이터를 캡슐화합니다. |
함수
| 함수 | 설명 |
|---|---|
| GameInputCreate | IGameInput 인터페이스의 인스턴스를 얻습니다. |
| GameInputDeviceCallback | 장치 연결 및 연결 끊김 이벤트에 대해 타이틀이 정의한 콜백. |
| GameInputKeyboardLayoutCallback | 자판 배열 변경 이벤트에 대한 타이틀 정의 콜백 |
| GameInputReadingCallback | 새 읽기 도착 이벤트에 대해 타이틀이 정의한 콜백. |
| GameInputSystemButtonCallback | 가이드 또는 공유 단추(누름 또는 해제) 이벤트에 대한 타이틀 정의 콜백입니다. |
구조
| 구조 | 설명 |
|---|---|
| GameInputArcadeStickInfo | 아케이드 스틱의 속성에 대해 설명합니다. |
| GameInputArcadeStickState | 아케이드 스틱의 상태를 기술합니다. |
| GameInputBatteryState | 입력 장치의 배터리 상태를 기술합니다. |
| GameInputControllerAxisInfo | 입력 장치의 축을 기술합니다. |
| GameInputControllerButtonInfo | 입력 디바이스의 단추를 설명합니다. |
| GameInputControllerSwitchInfo | 입력 장치의 스위치를 기술합니다. |
| GameInputDeviceInfo | 입력 장치에 대한 모든 정보를 기술합니다. |
| GameInputFlightStickInfo | 플라이트 스틱의 속성에 대해 설명합니다. |
| GameInputFlightStickState | 플라이트 스틱의 상태를 기술합니다. |
| GameInputForceFeedbackConditionParams | 힘 피드백 효과의 일부 실제 특성을 정의합니다. |
| GameInputForceFeedbackConstantParams | 힘 피드백 효과의 상수 실제 특성을 정의합니다. |
| GameInputForceFeedbackEnvelope | 힘 피드백 효과를 수정하는 봉투를 정의합니다. |
| GameInputForceFeedbackMagnitude | 힘 피드백 효과로 표시할 힘의 크기를 정의합니다. |
| GameInputForceFeedbackMotorInfo | 포스 피드백 모터 정보를 정의합니다. |
| GameInputForceFeedbackParams | 힘 피드백 효과의 API 지원 특성을 정의합니다. |
| GameInputForceFeedbackPeriodicParams | 주기적인 힘 피드백 효과를 정의하는 매개 변수입니다. |
| GameInputForceFeedbackRampParams | 램프 힘 피드백 효과를 위한 매개 변수를 정의합니다. |
| GameInputGamepadInfo | 게임패드의 속성에 대해 설명합니다. |
| GameInputGamepadState | 게임 패드 입력 장치의 상태를 기술합니다. |
| GameInputHapticFeedbackMotorInfo | 입력 장치의 촉각 피드백 모터를 기술합니다. |
| GameInputHapticFeedbackParams | 입력 장치에 대한 촉각 피드백 효과를 기술합니다. |
| GameInputHapticWaveformInfo | 햅틱 피드백 효과의 특성을 설명합니다. |
| GameInputKeyboardInfo | 키보드의 속성에 대해 설명합니다. |
| GameInputKeyState | 게임 컨트롤러에서 활성 키의 상태를 나타냅니다. |
| GameInputMotionInfo | 동작이 활성화된 입력 장치의 측정 가능한 속성에 대해 기술합니다. |
| GameInputMotionState | 동작이 활성화된 입력 장치로부터 가져온 동작 입력의 상태를 기술합니다. |
| GameInputMouseInfo | 마우스의 속성에 대해 설명합니다. |
| GameInputMouseState | 마우스의 상태를 기술합니다. |
| GameInputRacingWheelInfo | 레이싱 휠의 속성에 대해 설명합니다. |
| GameInputRacingWheelState | 레이싱 휠의 상태를 설명합니다. |
| GameInputRawDeviceItemCollectionInfo | 원시 장치 항목 모음에 대해 설명합니다. |
| GameInputRawDeviceReportInfo | 입력 장치의 원시 스트림 보고서를 설명합니다. |
| GameInputRawDeviceReportItemInfo | 원시 장치 보고서 항목을 기술하는 정보입니다. |
| GameInputRumbleParams | 표준 컨트롤러에서 생성되는 진동 효과를 기술합니다. |
| GameInputString | 입력 장치에 대한 정보를 포함하는 문자열을 설명합니다. |
| GameInputTouchSensorInfo | 입력 장치에 대한 터치 센서를 기술합니다. |
| GameInputTouchState | 터치식 입력 장치의 상태를 설명합니다. |
| GameInputUiNavigationInfo | UI의 탐색 단추 레이블을 설명합니다. |
| GameInputUiNavigationState | UI 탐색 입력의 상태를 설명합니다. |
| GameInputUsage | 특정 HID 사용법에 대해 설명합니다. |
| GameInputVersion | 네 부분으로 된 버전 번호를 설명합니다. |
열거형
| 열거형 | 설명 |
|---|---|
| GameInputArcadeStickButtons | 아케이드 스틱에서 입력을 열거합니다. |
| GameInputBatteryStatus | 입력 장치의 배터리 상태를 열거합니다. |
| GameInputDeviceCapabilities | 입력 장치의 특정 기능을 열거합니다. |
| GameInputDeviceFamily | 입력 장치의 제품군을 열거합니다. |
| GameInputDeviceStatus | 입력 장치의 상태 열거형. |
| GameInputEnumerationKind | 입력 장치 열거를 위한 동작 유형을 열거합니다. |
| GameInputFeedbackAxes | 입력 장치에서 사용할 수 있는 힘 피드백 모터의 방향 유형의 열거형. |
| GameInputFeedbackEffectState | 포스 피드백 효과의 상태를 열거합니다. |
| GameInputFlightStickButtons | 비행 스틱 버튼을 열거합니다. |
| GameInputFocusPolicy | 입력 장치에 대한 포커스 정책을 열거합니다. |
| GameInputForceFeedbackEffectKind | 힘 피드백 효과에 적용할 수 있는 시간 경과에 따른 힘 유형의 열거형. |
| GameInputGamepadButtons | 방향 패드(D-패드)를 포함하는 게임 패드 단추를 열거합니다. |
| GameInputKeyboardKind | 키 레이아웃별 키보드 유형을 열거합니다. |
| GameInputKind | 유효한 GameInput 장치 유형의 열거형. |
| GameInputLabel | 지원되는 버튼 레이블의 열거형. |
| GameInputLocation | 입력 장치의 부분을 열거합니다. |
| GameInputMotionAccuracy | 입력 디바이스에 있는 동작 센서의 정확도 수준을 열거합니다. |
| GameInputMouseButtons | 마우스 버튼을 열거하세요. |
| GameInputRacingWheelButtons | 레이싱 바퀴의 단추를 나열하세요. |
| GameInputRawDeviceItemCollectionKind | 원시 장치 항목 컬렉션 유형을 열거합니다. |
| GameInputRawDevicePhysicalUnitKind | 입력 장치의 입력과 연관된 물리적 단위를 열거합니다. |
| GameInputRawDeviceReportItemFlags | 원시 장치 보고 항목의 유형을 열거합니다. |
| GameInputRawDeviceReportKind | 원시 장치 보고서의 유형을 열거합니다. |
| GameInputRumbleMotors | API에서 지원하는 입력 장치의 진동 모터를 열거합니다. |
| GameInputSwitchKind | 입력 장치에서 지원되는 스위치 유형을 열거합니다. |
| GameInputSwitchPosition | 입력 장치에서 스위치 위치를 열거합니다. |
| GameInputSystemButtons | 시스템 제어에 사용되는 버튼을 열거합니다. |
| GameInputTouchShape | 터치 센서의 모양을 열거합니다. |
| GameInputUiNavigationButtons | UI 탐색 단추를 열거합니다. |