Accelerometer Classe

Definição

Namespace:

Windows.Devices.Sensors

Representa um sensor de acelerômetro.

Esse sensor retorna valores de força G em relação aos eixos x, y e z.

Para obter um exemplo de implementação, consulte o exemplo 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

Herança

Object Platform::Object IInspectable Accelerometer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Os aplicativos usam os métodos nessa classe para determinar se a leitura do sensor foi alterada ou se o dispositivo foi abalado.

Os aplicativos usam as propriedades nessa classe para recuperar e ajustar o intervalo de relatório do sensor.

Os dados do sensor são fornecidos em relação ao sistema de coordenadas de sensor fixo do dispositivo e são independentes da orientação de exibição. Para aplicativos que dependem de dados de sensor para controle de entrada ou para manipular elementos na tela, o desenvolvedor deve levar em conta a orientação de exibição atual e compensar os dados adequadamente. Para obter mais informações sobre o sistema de coordenadas do sensor, consulte Dados do sensor e orientação de exibição.

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# usa o método GetDefault para estabelecer uma conexão com um acelerômetro. Se nenhum acelerômetro integrado for encontrado, o método retornará um valor nulo.

_accelerometer = Accelerometer.GetDefault();

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML registra um manipulador 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);
    }
}

O exemplo a seguir mostra o manipulador 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);
    });
}

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	GetDefault(AccelerometerReadingType)
1607	14393	ReadingType
1.709	16299	FromIdAsync
1.709	16299	GetDeviceSelector
2004	19041	ReportThreshold

Propriedades

DeviceId	Obtém o identificador do dispositivo.
MaxBatchSize	Obtém o número máximo de eventos que podem ser agrupados em lote pelo sensor.
MinimumReportInterval	Obtém o intervalo mínimo de relatório com suporte pelo acelerômetro.
ReadingTransform	Obtém ou define a transformação que precisa ser aplicada aos dados do sensor. As transformações a serem aplicadas estão vinculadas à orientação de exibição com a qual alinhar os dados do sensor.
ReadingType	Obtém o tipo de sensor de acelerômetro que é representado por esse objeto.
ReportInterval	Obtém ou define o intervalo de relatório atual para o acelerômetro.
ReportLatency	Obtém ou define o atraso entre lotes de informações do sensor.
ReportThreshold	Obtém o AccelerometerDataThreshold para o sensor do acelerômetro.

Métodos

FromIdAsync(String)	Obtém de forma assíncrona o sensor de seu identificador.
GetCurrentReading()	Obtém a leitura atual do acelerômetro.
GetDefault()	Retorna o acelerômetro padrão.
GetDefault(AccelerometerReadingType)	Retorna o acelerômetro padrão de um tipo específico de sensor. Os possíveis sensores de acelerômetro são definidos por AccelerometerReadingType.
GetDeviceSelector(AccelerometerReadingType)	Obtém o seletor de dispositivo.

Eventos

ReadingChanged	Ocorre sempre que o acelerômetro relata uma nova leitura do sensor.
Shaken	Ocorre quando o acelerômetro detecta que o computador foi abalado.

Confira também

• Exemplo do acelerômetro
• Dados do sensor e orientação de exibição
• Exemplo de acelerômetro (Windows 10)
• Exemplo de sensores em segundo plano (Windows 10)