Inclinometer Classe

Definição

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

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.

Aplica-se a

Confira também