Usar o inclinômetro

Saiba como usar o inclinômetro para determinar o pitch, roll e yaw.

Este exemplo cria um aplicativo simples que depende de um inclinômetro como um dispositivo de entrada. Alguns jogos 3D exigem um inclinômetro como um dispositivo de entrada. Um exemplo comum é um simulador de voo, que pode mapear os três eixos do inclinômetro (X, Y e Z) para as entradas de elevador, aileron e leme da aeronave.

Prerequisites

Você deve estar familiarizado com o sensor de inclinômetro e seus usos. Consulte Sensores: Inclinometer.

O dispositivo ou emulador que você está usando deve dar suporte a um inclinômetro.

Código de exemplo

using Microsoft.UI.Dispatching;
using Microsoft.UI.Xaml.Controls;
using Windows.Devices.Sensors;

namespace DevicesDemo.Pages
{
    public sealed partial class InclinometerPage : Page
    {
        private Inclinometer? inclinometer;

        public InclinometerPage()
        {
            InitializeComponent();

            // Get the default inclinometer sensor object.
            inclinometer = Inclinometer.GetDefault();

            if (inclinometer != null)
            {
                // Establish the report interval.
                uint minReportInterval = inclinometer.MinimumReportInterval;
                uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
                inclinometer.ReportInterval = reportInterval;

                // Assign an event handler for the reading-changed event.
                inclinometer.ReadingChanged += Inclinometer_ReadingChanged;
            }
            else
            {
                statusBar.Message = "No inclinometer was found.";
                statusBar.Severity = InfoBarSeverity.Error;
                statusBar.IsOpen = true;
            }
        }

        // This event handler writes the current inclinometer
        // reading to the text blocks on the XAML page.
        private void Inclinometer_ReadingChanged(Inclinometer sender, InclinometerReadingChangedEventArgs args)
        {
            DispatcherQueue?.TryEnqueue(DispatcherQueuePriority.Normal, () =>
            {
                InclinometerReading reading = args.Reading;
                txtPitch.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
                txtRoll.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
                txtYaw.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
            });
        }
    }
}

<Grid>
    <Grid.RowDefinitions>
        <RowDefinition />
        <RowDefinition Height="Auto"/>
    </Grid.RowDefinitions>
    <Grid Margin="24">
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto"/>
            <ColumnDefinition/>
        </Grid.ColumnDefinitions>
        <Grid.RowDefinitions>
            <RowDefinition Height="44"/>
            <RowDefinition Height="44"/>
            <RowDefinition Height="44"/>
        </Grid.RowDefinitions>
        <TextBlock Text="Pitch:" Style="{StaticResource LabelTextBlockStyle}"/>
        <TextBlock x:Name="txtPitch" Grid.Column="1" Text="---"/>

        <TextBlock Grid.Row="1" Text="Roll:" Style="{StaticResource LabelTextBlockStyle}"/>
        <TextBlock x:Name="txtRoll" Grid.Column="1" Grid.Row="1" Text="---"/>

        <TextBlock Grid.Row="2" Text="Yaw:" Style="{StaticResource LabelTextBlockStyle}"/>
        <TextBlock x:Name="txtYaw" Grid.Column="1" Grid.Row="2" Text="---"/>
    </Grid>

    <InfoBar x:Name="statusBar" Grid.Row="1"/>
</Grid>

Quando o aplicativo é executado, você pode alterar os valores do inclinômetro movendo o dispositivo.

O exemplo anterior demonstra o código essencial que você precisa escrever para integrar a entrada de inclinômetro ao seu aplicativo.

Conectar-se ao sensor

Chame o método GetDefault para estabelecer uma conexão com o inclinômetro padrão.

private Inclinometer? inclinometer;
// ...
inclinometer = Inclinometer.GetDefault();

Você também pode chamar FromIdAsync para criar um objeto Inclinometer de um valor DeviceInformation.Id. Para obter mais informações, consulte Enumerar dispositivos.

Se nenhum sensor de inclinômetro for detectado, a mensagem de status será atualizada para informar o usuário.

Definir o intervalo de relatório

O intervalo de relatório é definido dentro do construtor da página. Esse código recupera o intervalo mínimo com suporte do dispositivo e o compara a um intervalo solicitado de 16 milissegundos (que aproxima uma taxa de atualização de 60 Hz). Se o intervalo mínimo com suporte for maior que o intervalo solicitado, o código definirá o valor como o mínimo. Caso contrário, define o valor para o intervalo solicitado.

uint minReportInterval = inclinometer.MinimumReportInterval;
uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
inclinometer.ReportInterval = reportInterval;

Ler dados do sensor

Os novos dados do inclinômetro são capturados no manipulador de eventos ReadingChanged . Sempre que o driver do sensor recebe novos dados do sensor, ele passa os valores para seu aplicativo usando esse evento. Para este exemplo, esses novos valores são gravados nos blocos de texto encontrados no XAML da página correspondente.

inclinometer.ReadingChanged += Inclinometer_ReadingChanged;
// ...

private void Inclinometer_ReadingChanged(Inclinometer sender, InclinometerReadingChangedEventArgs args)
{
    DispatcherQueue?.TryEnqueue(DispatcherQueuePriority.Normal, () =>
    {
        InclinometerReading reading = args.Reading;
        txtPitch.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        txtRoll.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        txtYaw.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

Tópicos relacionados:

• Exemplo de inclinômetro (UWP)