다음을 통해 공유


GameInputSensorsState

센서의 상태를 설명합니다.

구문

struct GameInputSensorsState
{
    // GameInputSensorsAccelerometer
    float accelerationInGX;
    float accelerationInGY;
    float accelerationInGZ;

    // GameInputSensorsGyrometer
    float angularVelocityInRadPerSecX;
    float angularVelocityInRadPerSecY;
    float angularVelocityInRadPerSecZ;

    // GameInputSensorsCompass
    float headingInDegreesFromMagneticNorth;
    GameInputSensorAccuracy headingAccuracy;

    // GameInputSensorsOrientation
    float orientationW;
    float orientationX;
    float orientationY;
    float orientationZ;
};

멤버

accelerationInGX
형식: float

x축과 관련하여 선형 가속(g-force)입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindAccelerometer.

accelerationInGY
형식: float

y 축과 관련하여 선형 가속(g-force)입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindAccelerometer.

accelerationInGZ
형식: float

z 축과 관련하여 선형 가속(g-force)입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindAccelerometer.

angularVelocityInRadPerSecX
형식: float

x 축과 관련하여 속도(초당 라디안)를 Angular. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindGyrometer.

angularVelocityInRadPerSecY
형식: float

Angular 속도(초당 라디안)이며 y 축과 관련이 있습니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindGyrometer.

angularVelocityInRadPerSecZ
형식: float

z 축과 관련하여 속도(초당 라디안)를 Angular. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindGyrometer.

headingInDegreesFromMagneticNorth
형식: float

자기 북쪽에서, 도에서 제목. 범위: [0, 360). 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindCompass.

headingAccuracy
형식: GameInputSensorAccuracy

제목의 정확도입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindCompass.

orientationW
형식: float

디바이스 방향을 나타내는 쿼터니언의 w 구성 요소입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindOrientation.

orientationX
형식: float

디바이스 방향을 나타내는 쿼터니언의 x 구성 요소입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindOrientation.

orientationY
형식: float

디바이스 방향을 나타내는 쿼터니언의 y 구성 요소입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindOrientation.

orientationZ
형식: float

디바이스 방향을 나타내는 쿼터니언의 z 구성 요소입니다. 를 보고하는 경우 GameInputSensorsInfo 유효합니다 GameInputSensorsKindOrientation.

비고

이 구조체는 IGameInputReading::GetSensorsState 메서드에서 사용됩니다.

자세한 내용은 GameInput 판독값을 참조하세요.

유효한 데이터의 존재는 GameInputDeviceInfoGameInputKindSensors에 의해 표시됩니다. 있는 것으로 보고되지 않은 데이터는 기본 미사용 시 값으로 채워집니다.

좌표계

디바이스는 Y업 오른손잡이 시스템으로 디바이스 가속을 보고해야 합니다. Angular 속도는 이러한 축에 대한 오른쪽 규칙을 따릅니다.

게임 패드 좌표계 핸드헬드 좌표계
게임 패드에 표시되는 센서 좌표계 핸드헬드에 표시된 센서 좌표계

X축은 디바이스 중앙에서 오른쪽으로 이동합니다. Y축은 디바이스 중앙에서 사용자의 얼굴로 이동합니다. Z축은 디바이스 중앙에서 아래쪽으로 이동합니다.

샘플 가속 출력(g:

  • 테이블에 평평하게 놓는 장치: {0, 1, 0}
    • Angular 속도(초당 라디안)는 {0, 0, 0}입니다.
  • 여기에서 디바이스를 위쪽으로 들어 올립니다. {0, 2, 0} 증가
  • 여기에서 디바이스 삭제: {0, 0, 0} 감소
  • 위쪽 가장자리가 공기 중이고 아래쪽 가장자리가 표면에 있도록 디바이스 회전: {0, 0, -1}
    • 움직이는 동안 각 속도 X는 긍정이 됩니다. {2, 0, 0}
  • 플랫으로 돌아가기.
  • 왼쪽 가장자리가 공기 중이고 오른쪽 가장자리가 표면에 있도록 디바이스 회전: {-1, 0, 0}
    • 움직이는 동안 각 속도 Z는 음수가 됩니다. {0, 0, -2}
  • 플랫으로 돌아가기.
  • 디바이스를 시계 방향으로 회전(오른쪽 규칙 반대)
    • 움직이는 동안 각 속도 Y는 음수가 됩니다. {0, -2, 0}

요구 사항

헤더: GameInput.h

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

참고 항목

GameInput 개요
GameInput