Skip to main content

GameInputSensorsState

描述感應器的狀態。

語法

成員

accelerationInGX
類型:float
相對於 x 軸的線性加速度 (以 g 力為單位)。若 GameInputSensorsInfo 回報 GameInputSensorsKindAccelerometer,則此值有效。 accelerationInGY
類型:float
相對於 y 軸的線性加速度 (以 g 力為單位)。若 GameInputSensorsInfo 回報 GameInputSensorsKindAccelerometer,則此值有效。 accelerationInGZ
類型:float
相對於 z 軸的線性加速度 (以 g 力為單位)。若 GameInputSensorsInfo 回報 GameInputSensorsKindAccelerometer,則此值有效。 angularVelocityInRadPerSecX
類型:float
相對於 x 軸的角速度 (以每秒弧度為單位)。若 GameInputSensorsInfo 回報 GameInputSensorsKindGyrometer,則此值有效。 angularVelocityInRadPerSecY
類型:float
相對於 y 軸的角速度 (以每秒弧度為單位)。若 GameInputSensorsInfo 回報 GameInputSensorsKindGyrometer,則此值有效。 angularVelocityInRadPerSecZ
類型:float
相對於 z 軸的角速度 (以每秒弧度為單位)。若 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 讀數。 是否存在有效資料,由 GameInputDeviceInfo 中的 GameInputKindSensors 表示。未回報為存在的資料將會以 預設的靜止值填入。

座標系統

裝置應以 Y 軸朝上的右手座標系統回報裝置加速度。角速度遵循繞這些軸的右手 定則。 X 軸從裝置中心指向右側。Y 軸從裝置中心指向 使用者的臉部。Z 軸從裝置中心指向底部外側。 範例加速度輸出 (以 g 為單位):
  • 裝置平放在桌上:
    • 靜止時的角速度 (以每秒弧度為單位) 為
  • 接著將裝置向上舉起:增加為
  • 接著讓裝置落下:減少為
  • 旋轉裝置,使頂部邊緣懸空、底部邊緣接觸表面:
    • 移動期間,角速度 X 變為正值:
  • 回到平放狀態。
  • 旋轉裝置,使左側邊緣懸空、右側邊緣接觸表面:
    • 移動期間,角速度 Z 變為負值:
  • 回到平放狀態。
  • 順時針旋轉裝置 (與右手定則相反)
    • 移動期間,角速度 Y 變為負值:

需求

標頭: GameInput.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

GameInput 概觀
GameInput

版本歷程記錄

Last modified on October 6, 2026