OrientationSensor.GetCurrentReading 方法

定義

命名空間:

Windows.Devices.Sensors

取得目前的感應器讀數。

public:
 virtual OrientationSensorReading ^ GetCurrentReading() = GetCurrentReading;

OrientationSensorReading GetCurrentReading();

public OrientationSensorReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As OrientationSensorReading

傳回

OrientationSensorReading

目前的感應器讀數。

範例

下列範例示範使用 XAML 和 C# 建置的 UWP 應用程式如何擷取方向感應器的目前讀數。

private void DisplayCurrentReading(object sender, object args)
{
    OrientationSensorReading reading = _sensor.GetCurrentReading();
    if (reading != null)
    {
        // Quaternion values
        SensorQuaternion quaternion = reading.Quaternion;   // get a reference to the object to avoid re-creating it for each access
        ScenarioOutput_X.Text = String.Format("{0,8:0.00000}", quaternion.X);
        ScenarioOutput_Y.Text = String.Format("{0,8:0.00000}", quaternion.Y);
        ScenarioOutput_Z.Text = String.Format("{0,8:0.00000}", quaternion.Z);
        ScenarioOutput_W.Text = String.Format("{0,8:0.00000}", quaternion.W);

        // Rotation Matrix values
        SensorRotationMatrix rotationMatrix = reading.RotationMatrix;
        ScenarioOutput_M11.Text = String.Format("{0,8:0.00000}", rotationMatrix.M11);
        ScenarioOutput_M12.Text = String.Format("{0,8:0.00000}", rotationMatrix.M12);
        ScenarioOutput_M13.Text = String.Format("{0,8:0.00000}", rotationMatrix.M13);
        ScenarioOutput_M21.Text = String.Format("{0,8:0.00000}", rotationMatrix.M21);
        ScenarioOutput_M22.Text = String.Format("{0,8:0.00000}", rotationMatrix.M22);
        ScenarioOutput_M23.Text = String.Format("{0,8:0.00000}", rotationMatrix.M23);
        ScenarioOutput_M31.Text = String.Format("{0,8:0.00000}", rotationMatrix.M31);
        ScenarioOutput_M32.Text = String.Format("{0,8:0.00000}", rotationMatrix.M32);
        ScenarioOutput_M33.Text = String.Format("{0,8:0.00000}", rotationMatrix.M33);
    }
}

備註

應用程式可以使用這個方法來輪詢感應器以取得目前讀數，做為註冊 ReadingChanged 事件處理常式的替代方法。 這是以特定畫面播放速率更新其使用者介面之應用程式的慣用替代方案。 無論輪詢一次還是多次，應用程式都必須建立所需的 ReportInterval。 這會通知感應器驅動程式應該配置資源以滿足後續輪詢要求

使用這個方法的傳回值之前，應用程式必須先檢查該值不是 Null。 (如果值為 null 且您嘗試擷取此值，Windows 將會產生 exception.)