本主題提供方向感測器閾值的相關信息。
下表顯示方向感測器的可用閾值。 如需類型數據行中顯示的類型詳細資訊,請參閱 PROPVARIANT 結構。
屬性索引鍵 | 類型 | 必要/選用 | 預設值 | 描述 |
---|---|---|---|---|
PKEY_SensorData_RotationAngle_Degrees | VT_R4 | 必要 | 10.0f | 在達到臨界值所需的任何座標軸周圍,方向角度的最小量變更,以度為單位。 此值應該計算為兩個四元數之間的角度。 數學上,這表示為:2*cos-1 (點乘積 (q1, q2) ) |
PKEY_SensorData_LinearAccelerationX_Gs | VT_R4 | 選擇性 | n/a | 以 g 為單位測量的臨界值時,沿著 x 軸增加或減少的加速量下限。 |
PKEY_SensorData_LinearAccelerationY_Gs | VT_R4 | 選擇性 | n/a | 在達到以 g 為單位的臨界值所需的 Y 軸上,加速增加或減少的最小數量。 |
PKEY_SensorData_LinearAccelerationZ_Gs | VT_R4 | 選擇性 | n/a | 在達到閾值所需的 z 軸上增加或減少的加速量下限,以 g 為單位。 |
PKEY_SensorData_CorrectedAngularVelocityX_DegreesPerSecond | VT_R4 | 選擇性 | n/a | 達到每秒以度為單位測量的臨界值所需 x 軸的最小角度速度變更量。 |
PKEY_SensorData_CorrectedAngularVelocityY_DegreesPerSecond | VT_R4 | 選擇性 | n/a | 達到每秒以度為單位測量的臨界值所需 x 軸的最小角度速度變更量。 |
PKEY_SensorData_CorrectedAngularVelocityZ_DegreesPerSecond | VT_R4 | 選擇性 | n/a | 達到每秒以度為單位測量的臨界值所需 x 軸的最小角度速度變更量。 |
方向感測器驅動程序必須在符合PKEY_SensorData_RotationAngle_Degrees閾值時呼叫 SensorsCxSensorDataReady ,向感測器類別延伸模塊報告範例讀取。
當PKEY_SensorData_RotationAngle_Degrees設定為0.0f時,驅動程式必須在每個間隔將樣本讀數回報給感測器類別延伸模組。 此模式稱為 感測器範例串流。
方向感測器驅動程式一律必須在感測器類別延伸模組呼叫 EvtSensorStart 回呼之後立即回報一個樣本讀取,而不論閾值為何。 此範例稱為 「初始樣本讀取」。
當符合個別閾值時,方向感測器驅動程式必須向感測器類別延伸報告範例讀取。
如果驅動程式支援下列任何可測量每個座標軸讀數的其他選擇性數據欄位,則必須公開對應座標軸的臨界值:
- PKEY_SensorData_LinearAccelerationX_Gs
- PKEY_SensorData_LinearAccelerationY_Gs
- PKEY_SensorData_LinearAccelerationZ_Gs
- PKEY_SensorData_CorrectedAngularVelocityX_DegreesPerSecond
- PKEY_SensorData_CorrectedAngularVelocityY_DegreesPerSecond
- PKEY_SensorData_CorrectedAngularVelocityZ_DegreesPerSecond
因此,驅動程式必須在任何軸上符合閾值條件時呼叫 SensorsCxSensorDataReady。