Accelerometer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 AccelerometerPublic NotInheritable Class Accelerometer- Herencia
- Atributos
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. |