Inclinometer Clase

Definición

Espacio de nombres:

Windows.Devices.Sensors

Representa un sensor de inclinómetro que proporciona valores de inclinación, giro y giro correspondientes a los ángulos de rotación alrededor de los ejes x, y y z, respectivamente.

public ref class Inclinometer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Inclinometer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Inclinometer

Public NotInheritable Class Inclinometer

Herencia

Object Platform::Object IInspectable Inclinometer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Para ver una implementación de ejemplo, consulte el ejemplo de inclinómetro https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometer.

Comentarios

Los datos del sensor se proporcionan en relación con el sistema fijo de coordenadas del sensor del dispositivo y son independientes de la orientación de la pantalla. En el caso de las aplicaciones que dependen de los datos del sensor para el control de entrada o para manipular elementos en la pantalla, el desarrollador debe tener en cuenta la orientación de visualización actual y compensar los datos de forma adecuada. Para obtener más información sobre el sistema de coordenadas del sensor, consulta Orientación de visualización y datos del sensor.

En el ejemplo siguiente se muestra cómo una aplicación para UWP compilada con XAML y C# usa el método GetDefault para establecer una conexión a un inclinómetro. Si no se encuentra ningún inclinómetro integrado, el método devolverá un valor NULL.

_inclinometer = Inclinometer.GetDefault();

En el ejemplo siguiente se muestra cómo una aplicación para UWP compilada con XAML registra un controlador de eventos ReadingChanged .

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_inclinometer != null)
    {
        // Establish the report interval
        _inclinometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No inclinometer found", NotifyType.StatusMessage);
    }
}

En el ejemplo siguiente se muestra el controlador de eventos ReadingChanged .

async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	GetDefault(SensorReadingType)
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

Propiedades

DeviceId	Obtiene el identificador del dispositivo.
MaxBatchSize	Obtiene el número máximo de eventos que el sensor puede procesar por lotes.
MinimumReportInterval	Obtiene el intervalo de informe mínimo admitido por el inclinómetro.
ReadingTransform	Obtiene o establece la transformación que se debe aplicar a los datos del sensor. Las transformaciones que se van a aplicar están vinculadas a la orientación de visualización con la que se alinean los datos del sensor.
ReadingType	Obtiene el tipo de lectura del sensor.
ReportInterval	Obtiene o establece el intervalo de informe actual para el inclinómetro.
ReportLatency	Obtiene o establece el retraso entre lotes de información del sensor.
ReportThreshold	Obtiene el InclinometerDataThreshold para el sensor del girómetro.

Métodos

FromIdAsync(String)	Obtiene de forma asincrónica el sensor de su identificador.
GetCurrentReading()	Obtiene la lectura del inclinómetro actual.
GetDefault()	Devuelve el inclinómetro predeterminado para lecturas absolutas.
GetDefault(SensorReadingType)	Devuelve el inclinómetro predeterminado basado en SensorReadingType.
GetDefaultForRelativeReadings()	Devuelve el inclinómetro predeterminado para las lecturas relativas.
GetDeviceSelector(SensorReadingType)	Obtiene el selector de dispositivos.

Eventos

ReadingChanged

Se produce cada vez que el inclinómetro notifica una nueva lectura del sensor.

Consulte también

• Muestra de inclinómetro
• Orientación de visualización y datos del sensor
• Ejemplo de inclinómetro relativo