Compartilhar via


Accelerometer Classe

Definição

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

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.

Aplica-se a

Confira também