Skip to main content

GameInputSensorsState

Descreve o estado dos sensores.

Sintaxe

Membros

accelerationInGX
Tipo: float
Aceleração linear, em força g, em relação ao eixo x. Válido se GameInputSensorsInfo relatar GameInputSensorsKindAccelerometer. accelerationInGY
Tipo: float
Aceleração linear, em força g, em relação ao eixo y. Válido se GameInputSensorsInfo relatar GameInputSensorsKindAccelerometer. accelerationInGZ
Tipo: float
Aceleração linear, em força g, em relação ao eixo z. Válido se GameInputSensorsInfo relatar GameInputSensorsKindAccelerometer. angularVelocityInRadPerSecX
Tipo: float
Velocidade angular, em radianos por segundo, em relação ao eixo x. Válido se GameInputSensorsInfo relatar GameInputSensorsKindGyrometer. angularVelocityInRadPerSecY
Tipo: float
Velocidade angular, em radianos por segundo, em relação ao eixo y. Válido se GameInputSensorsInfo relatar GameInputSensorsKindGyrometer. angularVelocityInRadPerSecZ
Tipo: float
Velocidade angular, em radianos por segundo, em relação ao eixo z. Válido se GameInputSensorsInfo relatar GameInputSensorsKindGyrometer. headingInDegreesFromMagneticNorth
Tipo: float
Direção, em graus, a partir do norte magnético. Intervalo: [0, 360). Válido se GameInputSensorsInfo relatar GameInputSensorsKindCompass. headingAccuracy
Tipo: GameInputSensorAccuracy
Precisão da direção. Válido se GameInputSensorsInfo relatar GameInputSensorsKindCompass. orientationW
Tipo: float
O componente w de um quatérnio que representa a orientação do dispositivo. Válido se GameInputSensorsInfo relatar GameInputSensorsKindOrientation. orientationX
Tipo: float
O componente x de um quatérnio que representa a orientação do dispositivo. Válido se GameInputSensorsInfo relatar GameInputSensorsKindOrientation. orientationY
Tipo: float
O componente y de um quatérnio que representa a orientação do dispositivo. Válido se GameInputSensorsInfo relatar GameInputSensorsKindOrientation. orientationZ
Tipo: float
O componente z de um quatérnio que representa a orientação do dispositivo. Válido se GameInputSensorsInfo relatar GameInputSensorsKindOrientation.

Comentários

Essa estrutura é usada pelo método IGameInputReading::GetSensorsState. Para obter mais informações, consulte Leituras do GameInput. A presença de dados válidos é indicada por GameInputKindSensors em GameInputDeviceInfo. Os dados que não forem relatados como presentes serão preenchidos com valores padrão de repouso.

Sistema de coordenadas

Espera-se que os dispositivos relatem a aceleração do dispositivo como um sistema destro com Y para cima. A velocidade angular segue a regra da mão direita em torno desses eixos. O eixo X vai do centro do dispositivo em direção à direita. O eixo Y vai do centro do dispositivo em direção ao rosto do usuário. O eixo Z vai do centro do dispositivo para fora pela parte inferior. Exemplo de saída de aceleração, em g:
  • Dispositivo deitado sobre a mesa:
    • A velocidade angular em repouso, em radianos por segundo, é
  • A partir daí, levante o dispositivo: aumenta
  • A partir daí, solte o dispositivo: diminui
  • Gire o dispositivo de forma que a borda superior fique no ar e a borda inferior fique na superfície:
    • Durante o movimento, a velocidade angular X torna-se positiva:
  • Volte à posição plana.
  • Gire o dispositivo de forma que a borda esquerda fique no ar e a borda direita fique na superfície:
    • Durante o movimento, a velocidade angular Z torna-se negativa:
  • Volte à posição plana.
  • Gire o dispositivo no sentido horário (oposto à regra da mão direita)
    • Durante o movimento, a velocidade angular Y torna-se negativa:

Requisitos

Cabeçalho: GameInput.h Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Visão geral do GameInput
GameInput

Histórico de versões

Last modified on October 6, 2026