다음을 통해 공유


IGameInputReading::GetMotionState

동작 입력의 상태를 기술하는 입력 수치에 대한 보기를 검색합니다.

구문

bool GetMotionState(  
         GameInputMotionState* state  
)  

매개 변수

state _Out_
형식: GameInputMotionState*

동작 입력으로 해석되는 입력입니다.

반환 값

형식: bool

이 기능은 아직 구현되지 않았습니다. 현재는 false를 반환합니다.

구현 후에는 동작 입력 해석이 성공하면 true를 반환합니다. 동작 입력으로 인식되지 않는 입력을 읽으려고 시도할 때는 false를 반환합니다.

비고

GetMotionState 메서드는 단일 GameInputMotionState 구조로 반환되는 게임 컨트롤러에서 3DoF 동작 센서 상태를 검색합니다. 이 구조에는 [0.0, 1.0] 범위로 선형으로 정규화된, 필터링되지 않은 원시 가속도계, 자이로스코프 및 자력계 센서 데이터가 포함됩니다. (정규화되지 않은 최소/최대 값에 대한 정보를 얻기 위한 메서드가 IGameInputDevice 인터페이스에서 제공됩니다.)

GameInputMotionState 구조체에는 장치의 방향을 의미하는 방향 벡터도 포함되어 있습니다(사원수 형태). 센서 퓨전 엔진이 내장되어 있으면 하드웨어에서 방향 데이터가 옵니다. 이와 다른 경우에는 GameInput 구현의 자체 센서 퓨전 코드를 사용하여 계산합니다. 기본값으로, 모든 방향 축의 참조 프레임은 장치에서 정의합니다. 자기계를 사용할 수 있다면, 방향의 X/Y 축은 자북극에 상대적입니다. 가속도계와 자이로스코프를 모두 사용할 수 있는 경우에는 방향의 Z 축은 중력에 상대적입니다.

IGameInputReading::GetInputKind 메서드를 호출하여 일부 IGameInputReading에 대한 유효한 해석을 반환하는 Get\*State 함수를 확인하세요. 각 Get*State 함수에는 IGameInputReading::GetInputKind 열거형에 대응하는 항목이 존재합니다. 해당 IGameInputReading::GetInputKind 플래그가 설정되지 않은 상태로 Get*State 함수를 호출하려고 시도하면, 함수가 false 반환 값과 함께 사용되지 않는 값의 기본값으로 반환합니다.

요구 사항

헤더: GameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

입력 API 개요
IGameInputReading