Gyrometer Classe

Definição

Namespace:

Windows.Devices.Sensors

Representa um sensor de giroscópio que fornece valores de velocidade angular em relação aos eixos x, y e z.

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

Public NotInheritable Class Gyrometer

Herança

Object Platform::Object IInspectable Gyrometer

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)

Exemplos

Para obter um exemplo de implementação, consulte o exemplo de girômetro.

Comentários

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 do 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 gyrometer. Se nenhum giroscópio integrado for encontrado, o método retornará um valor nulo.

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _gyrometer.ReadingChanged += new TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs>(ReadingChanged);

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

O exemplo a seguir mostra o manipulador de eventos ReadingChanged .

async private void ReadingChanged(object sender, GyrometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        GyrometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AngularVelocityX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AngularVelocityY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AngularVelocityZ);
    });
}

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1.709	16299	FromIdAsync
1.709	16299	GetDeviceSelector
1.709	16299	MaxBatchSize
1.709	16299	ReportLatency
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 pelo sensor.
MinimumReportInterval	Obtém o intervalo mínimo de relatório com suporte pelo giroscópio.
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.
ReportInterval	Obtém ou define o intervalo de relatório atual para o giroscópio.
ReportLatency	Obtém ou define o atraso entre lotes de informações do sensor.
ReportThreshold	Obtém o GyrometerDataThreshold para o sensor de giroscópio.

Métodos

FromIdAsync(String)	Obtém de forma assíncrona o sensor de seu identificador.
GetCurrentReading()	Obtém a leitura do giroscópio atual.
GetDefault()	Retorna o giroscópio padrão.
GetDeviceSelector()	Obtém o seletor de dispositivo.

Eventos

ReadingChanged

Ocorre sempre que o giroscópio relata a leitura do sensor atual.

Confira também

• Exemplo de girômetro
• Dados do sensor e orientação de exibição