Accelerometer Clase

Definición

Espacio de nombres:

Windows.Devices.Sensors

Representa un sensor de acelerómetro.

Este sensor devuelve valores de fuerza G con respecto a los ejes x, y y z.

Para ver una implementación de ejemplo, consulte la muestra de acelerómetro.

public ref class Accelerometer 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 Accelerometer 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 Accelerometer

Public NotInheritable Class Accelerometer

Herencia

Object Platform::Object IInspectable Accelerometer

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)

Comentarios

Las aplicaciones usan los métodos de esta clase para determinar si la lectura del sensor ha cambiado o el dispositivo se ha agitado.

Las aplicaciones usan las propiedades de esta clase para recuperar y ajustar el intervalo de informe del sensor.

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 con un acelerómetro. Si no se encuentra ningún acelerómetro integrado, el método devolverá un valor NULL.

_accelerometer = Accelerometer.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 (_accelerometer != null)
    {
        // Establish the report interval
        _accelerometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _accelerometer.ReadingChanged += new TypedEventHandler<Accelerometer, AccelerometerReadingChangedEventArgs>(ReadingChanged);

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

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

async private void ReadingChanged(object sender, AccelerometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        AccelerometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);
    });
}

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	GetDefault(AccelerometerReadingType)
1607	14393	ReadingType
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
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 aceleró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 sensor de acelerómetro que representa este objeto.
ReportInterval	Obtiene o establece el intervalo de informe actual para el acelerómetro.
ReportLatency	Obtiene o establece el retraso entre lotes de información del sensor.
ReportThreshold	Obtiene el AccelerometerDataThreshold para el sensor de acelerómetro.

Métodos

FromIdAsync(String)	Obtiene de forma asincrónica el sensor de su identificador.
GetCurrentReading()	Obtiene la lectura del acelerómetro actual.
GetDefault()	Devuelve el acelerómetro predeterminado.
GetDefault(AccelerometerReadingType)	Devuelve el acelerómetro predeterminado de un tipo específico de sensor. Los posibles sensores de acelerómetro se definen mediante AccelerometerReadingType.
GetDeviceSelector(AccelerometerReadingType)	Obtiene el selector de dispositivos.

Eventos

ReadingChanged	Se produce cada vez que el acelerómetro notifica una nueva lectura del sensor.
Shaken	Se produce cuando el acelerómetro detecta que el EQUIPO se ha agitado.

Consulte también

• Ejemplo de acelerómetro
• Orientación de visualización y datos del sensor
• Ejemplo de acelerómetro (Windows 10)
• Ejemplo de sensores en segundo plano (Windows 10)