Usar o inclinômetro

Artigo
07/05/2024

Aprenda a usar o inclinômetro para determinar a inclinação, rotação e guinada.

APIs importantes

Pré-requisitos

Você deve estar familiarizado com XAML (Extensible Application Markup Language), Microsoft Visual C# e eventos.

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

Crie um aplicativo de inclinômetro simples

Alguns jogos 3D requerem um inclinômetro como dispositivo de entrada. Um exemplo comum é o simulador de vôo, que mapeia os três eixos do inclinômetro (X, Y e Z) para as entradas do elevador, aileron e leme da aeronave.

Observação

Para uma implementação mais completa, consulte o exemplo do inclinômetro.

Instruções

Crie um novo projeto, escolhendo um Aplicativo em Branco (Universal do Windows) nos modelos de projeto do Visual C# .
Abra o arquivo MainPage.xaml.cs do seu projeto e substitua o código existente pelo seguinte.

    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;

    using Windows.UI.Core;
    using Windows.Devices.Sensors;


    namespace App1
    {
        /// <summary>
        /// An empty page that can be used on its own or navigated to within a Frame.
        /// </summary>
        public sealed partial class MainPage : Page
        {
            private Inclinometer _inclinometer;

            // This event handler writes the current inclinometer reading to
            // the three text blocks on the app' s main page.

            private async void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
            {
                await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
                {
                    InclinometerReading reading = e.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);
                });
            }

            public MainPage()
            {
                this.InitializeComponent();
                _inclinometer = Inclinometer.GetDefault();


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

                    // Establish the event handler
                    _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);
                }
            }
        }
    }

Você precisará renomear o namespace no snippet anterior com o nome que você deu ao seu projeto. Por exemplo, se você criou um projeto chamado InclinometerCS, substitua namespace App1 por namespace InclinometerCS.

Abra o arquivo MainPage.xaml e substitua o conteúdo original pelo XML a seguir.

        <Page
        x:Class="App1.MainPage"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:App1"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d">

        <Grid x:Name="LayoutRoot" Background="#FF0C0C0C">
            <TextBlock HorizontalAlignment="Left" Height="21" Margin="0,8,0,0" TextWrapping="Wrap" Text="Pitch: " VerticalAlignment="Top" Width="45" Foreground="#FFF9F4F4"/>
            <TextBlock x:Name="txtPitch" HorizontalAlignment="Left" Height="21" Margin="59,8,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="71" Foreground="#FFFDF9F9"/>
            <TextBlock HorizontalAlignment="Left" Height="23" Margin="0,29,0,0" TextWrapping="Wrap" Text="Roll:" VerticalAlignment="Top" Width="55" Foreground="#FFF7F1F1"/>
            <TextBlock x:Name="txtRoll" HorizontalAlignment="Left" Height="23" Margin="59,29,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="50" Foreground="#FFFCF9F9"/>
            <TextBlock HorizontalAlignment="Left" Height="19" Margin="0,56,0,0" TextWrapping="Wrap" Text="Yaw:" VerticalAlignment="Top" Width="55" Foreground="#FFF7F3F3"/>
            <TextBlock x:Name="txtYaw" HorizontalAlignment="Left" Height="19" Margin="55,56,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="54" Foreground="#FFF6F2F2"/>

        </Grid>
    </Page>

Você precisará substituir a primeira parte do nome da classe no snippet anterior pelo namespace do seu aplicativo. Por exemplo, se você criou um projeto chamado InclinometerCS, substitua x:Class="App1.MainPage" por x:Class="InclinometerCS.MainPage". Você também deve substituir xmlns:local="using:App1" por xmlns:local="using:InclinometerCS".

Pressione F5 ou selecione Depurar>Iniciar Depuração para compilar, implantar e executar o aplicativo.

Depois que o aplicativo estiver em execução, você poderá alterar os valores do inclinômetro movendo o dispositivo ou usando as ferramentas do emulador.

Pare o aplicativo retornando ao Visual Studio e pressionando Shift+F5 ou selecione Depurar>Parar Depuração para interromper o aplicativo.

Explicação

O exemplo anterior demonstra o pouco código que você precisará escrever para integrar a entrada do inclinômetro em seu aplicativo.

O aplicativo estabelece uma conexão com o inclinômetro padrão no método MainPage .

_inclinometer = Inclinometer.GetDefault();

O aplicativo estabelece o intervalo de relatório dentro do método MainPage . Esse código recupera o intervalo mínimo com suporte do dispositivo e o compara a um intervalo solicitado de 16 milissegundos (que se aproxima de 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, ele define o valor para o intervalo solicitado.

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

Os novos dados do inclinômetro são capturados no método ReadingChanged . Cada vez que o driver do sensor recebe novos dados do sensor, ele passa os valores para seu aplicativo usando esse manipulador de eventos. O aplicativo registra esse manipulador de eventos na linha a seguir.

_inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer,
InclinometerReadingChangedEventArgs>(ReadingChanged);

Esses novos valores são gravados nos TextBlocks encontrados no XAML do projeto.

<TextBlock HorizontalAlignment="Left" Height="21" Margin="0,8,0,0" TextWrapping="Wrap" Text="Pitch: " VerticalAlignment="Top" Width="45" Foreground="#FFF9F4F4"/>
 <TextBlock x:Name="txtPitch" HorizontalAlignment="Left" Height="21" Margin="59,8,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="71" Foreground="#FFFDF9F9"/>
 <TextBlock HorizontalAlignment="Left" Height="23" Margin="0,29,0,0" TextWrapping="Wrap" Text="Roll:" VerticalAlignment="Top" Width="55" Foreground="#FFF7F1F1"/>
 <TextBlock x:Name="txtRoll" HorizontalAlignment="Left" Height="23" Margin="59,29,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="50" Foreground="#FFFCF9F9"/>
 <TextBlock HorizontalAlignment="Left" Height="19" Margin="0,56,0,0" TextWrapping="Wrap" Text="Yaw:" VerticalAlignment="Top" Width="55" Foreground="#FFF7F3F3"/>
 <TextBlock x:Name="txtYaw" HorizontalAlignment="Left" Height="19" Margin="55,56,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="54" Foreground="#FFF6F2F2"/>

Compartilhar via

Usar o inclinômetro

Pré-requisitos

Crie um aplicativo de inclinômetro simples

Instruções

Explicação

Comentários

Recursos adicionais