Compass.GetCurrentReading Método

Definición

Espacio de nombres:

Windows.Devices.Sensors

Obtiene la lectura de la brújula actual.

public:
 virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;

CompassReading GetCurrentReading();

public CompassReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As CompassReading

Devoluciones

CompassReading

Lectura de la brújula actual.

Ejemplos

En el ejemplo siguiente se muestra cómo una aplicación para UWP compilada con XAML y C# recupera el encabezado actual de la brújula predeterminada.

private void DisplayCurrentReading(object sender, object args)
{
    CompassReading reading = _compass.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_MagneticNorth.Text = String.Format("{0,5:0.00}", reading.HeadingMagneticNorth);
        if (reading.HeadingTrueNorth != null)
        {
            ScenarioOutput_TrueNorth.Text = String.Format("{0,5:0.00}", reading.HeadingTrueNorth);
        }
        else
        {
            ScenarioOutput_TrueNorth.Text = "No data";
        }
    }
}

Comentarios

Una aplicación puede usar este método para sondear el sensor de la lectura actual como alternativa al registro de un controlador de eventos ReadingChanged . Esta sería la alternativa preferida para una aplicación que actualiza su interfaz de usuario a una velocidad de fotogramas específica. Tanto si sondea una o varias veces, la aplicación debe establecer un reportInterval deseado. Esto informa al controlador del sensor de que se deben asignar recursos para satisfacer las solicitudes de sondeo posteriores.

El valor devuelto es un encabezado magnético especificado en grados.

La precisión de este valor depende de las funcionalidades de la brújula.

Antes de usar el valor devuelto de este método, la aplicación debe comprobar primero que el valor no es NULL. (Si el valor es null e intenta recuperarlo, Windows generará una excepción).