Inclinometer Classe

Definição

Namespace:

Windows.Devices.Sensors

Representa um sensor de inclinômetro que fornece valores de rotação, rolagem e rotação correspondentes aos ângulos de rotação ao redor dos eixos x, y e z, respectivamente.

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

Public NotInheritable Class Inclinometer

Herança

Object Platform::Object IInspectable Inclinometer

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 https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometerde inclinô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 inclinômetro. Se nenhum inclinômetro integrado for encontrado, o método retornará um valor nulo.

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

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

O exemplo a seguir mostra o manipulador de eventos ReadingChanged .

async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	GetDefault(SensorReadingType)
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 inclinô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 leitura do sensor.
ReportInterval	Obtém ou define o intervalo de relatório atual para o inclinômetro.
ReportLatency	Obtém ou define o atraso entre lotes de informações do sensor.
ReportThreshold	Obtém o InclinometerDataThreshold 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 inclinômetro atual.
GetDefault()	Retorna o inclinômetro padrão para leituras absolutas.
GetDefault(SensorReadingType)	Retorna o inclinômetro padrão com base no SensorReadingType.
GetDefaultForRelativeReadings()	Retorna o inclinômetro padrão para leituras relativas.
GetDeviceSelector(SensorReadingType)	Obtém o seletor de dispositivo.

Eventos

ReadingChanged

Ocorre sempre que o inclinômetro relata uma nova leitura do sensor.

Confira também

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