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.)