단일 입력 업데이트를 위해 데이터를 캡슐화합니다. 이 인터페이스의 메서드를 사용하면 여러 장치의 렌즈를 통해 게임 입력을 해석하고, 입력을 전송하는 장치에 대한 정보를 얻을 수 있습니다. 이 인터페이스는 특정 순간의 게임 컨트롤러 상태에 대해 입력을 실행 가능한 정보로 변환하는 데 도움을 줍니다.
구문
class IGameInputReading : public IUnknown
메서드
| 메서드 | 설명 |
|---|---|
| GetArcadeStickState | 게임 컨트롤러의 아케이드 스틱 상태를 가져옵니다. |
| GetControllerAxisCount | 게임 컨트롤러의 축 수를 가져옵니다. |
| GetControllerAxisState | 게임 컨트롤러에서 축의 상태를 가져옵니다. |
| GetControllerButtonCount | 게임 컨트롤러의 단추 수를 가져옵니다. |
| GetControllerButtonState | 게임 컨트롤러의 단추 상태를 가져옵니다. |
| GetControllerSwitchCount | 게임 컨트롤러의 스위치 수를 가져옵니다. |
| GetControllerSwitchState | 게임 컨트롤러의 스위치 상태를 가져옵니다. |
| GetDevice | 현재 읽기에 연결된 디바이스를 가져옵니다. |
| GetFlightStickState | 게임 컨트롤러의 플라이트 스틱 상태를 가져옵니다. |
| GetGamepadState | 게임 컨트롤러의 게임 패드 상태를 가져옵니다. |
| GetInputKind | 이 읽기에서 제공하는 입력 형식을 가져옵니다. |
| GetKeyCount | 게임 컨트롤러의 활성 키 수를 가져옵니다. |
| GetKeyState | 게임 컨트롤러의 활성 키 상태를 가져옵니다. |
| GetMouseState | 게임 컨트롤러의 마우스 상태를 가져옵니다. |
| GetRacingWheelState | 게임 컨트롤러에서 레이싱 휠의 상태를 가져옵니다. |
| GetSensorsState | 게임 컨트롤러의 센서 상태를 가져옵니다. |
| GetTimestamp | 읽기의 타임스탬프를 마이크로초로 가져옵니다. |
| GetUiNavigationState | 게임 컨트롤러에서 UI 탐색의 상태를 가져옵니다. |
비고
디바이스에서 받은 모든 입력 상태 변경 내용은 instance 캡처됩니다 IGameInputReading . 기본적으로 특정 순간에 디바이스의 입력 상태를 나타내는 스냅샷입니다. 인터페이스는 IGameInputReading 디바이스의 원시 입력 보고서 데이터뿐만 아니라 해당 데이터의 다양한 변환에 대한 액세스를 제공합니다.
새 보고서에서 원시 입력 데이터를 캡처한 후 GameInput API는 데이터를 조사하고 추가적인(보다 유용한) 표현으로 변환하려고 시도합니다. 예외가 거의 없는 경우 데이터는 단추 및 축 값의 배열, 키 상태 배열 등 하나 이상의 기본적인 표현으로 변환됩니다. 가능하면 데이터는 게임 패드 상태와 같은 하나 이상의 추상 고정 형식 표현으로 변환됩니다.
따라서 단일 IGameInputReading instance 동일한 입력 데이터의 여러 "보기"를 포함하는 경우가 많습니다. 이러한 방식은 필요한 입력 데이터에 따라 가장 자세한 것부터 가장 대략적인 것까지 수준에 따라 서로 다른 다양한 애플리케이션에 맞게 데이터를 제공합니다. 열거형에 GameInputKind 정의된 각 종류의 입력 데이터에 대해 해당 종류의 데이터를 검색하는 해당 IGameInputReading 메서드가 있습니다.
입력 스트림에서 검색되는 모든 IGameInputReading 항목은 싱글톤입니다. 동일한 읽기를 여러 번 검색하면 기본 개체의 참조 수가 증가합니다. 따라서 IGameInputReading 인스턴스를 참조 같음으로 비교할 수 있습니다.
IGameInputReading인스턴스는 읽기 instance 대한 모든 참조가 해제될 때까지 항상 유효하고 상태를 검색할 수 있습니다. 기본 디바이스가 시스템에서 연결이 끊어졌거나 읽기가 너무 오래되었더라도 더 이상 입력 스트림 버퍼에 없습니다. 이 인터페이스에서 모든 메서드는 단순히 수치에 저장된 캐시 데이터를 검색하기 때문에, 모든 메서드가 매우 빠르게 반환되며, 시간에 민감한 컨텍스트에서 안전하게 호출할 수 있습니다.
요구 사항
헤더: GameInput.h
지원되는 플랫폼: Windows