Usare la bussola

Articolo
03/21/2024

Informazioni su come usare la bussola per determinare l'intestazione corrente.

API importanti

Prerequisiti

È consigliabile familiarizzare con Extensible Application Markup Language (XAML), Microsoft Visual C# ed eventi.

Il dispositivo o l'emulatore in uso deve supportare una bussola.

Creare una semplice app bussola

Un'applicazione può recuperare la direzione corrente rispetto al nord magnetico o vero. Le app di spostamento usano la bussola per determinare la direzione in cui si trova un dispositivo e quindi orientare la mappa di conseguenza.

Nota

Per un'implementazione più completa, vedere esempio di bussola.

Istruzioni

Creare un nuovo progetto scegliendo un'app vuota (Windows universale) dai modelli di progetto Visual C# .
Aprire il file di MainPage.xaml.cs del progetto e sostituire il codice esistente con il codice seguente.

    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; // Required to access the core dispatcher object
    using Windows.Devices.Sensors; // Required to access the sensor platform and the compass


    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 Compass _compass; // Our app' s compass object

            // This event handler writes the current compass reading to
            // the textblocks on the app' s main page.

            private async void ReadingChanged(object sender, CompassReadingChangedEventArgs e)
            {
               await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
                {
                    CompassReading reading = e.Reading;
                    txtMagnetic.Text = String.Format("{0,5:0.00}", reading.HeadingMagneticNorth);
                    if (reading.HeadingTrueNorth.HasValue)
                        txtNorth.Text = String.Format("{0,5:0.00}", reading.HeadingTrueNorth);
                    else
                        txtNorth.Text = "No reading.";
                });
            }

            public MainPage()
            {
                this.InitializeComponent();
               _compass = Compass.GetDefault(); // Get the default compass object

                // Assign an event handler for the compass reading-changed event
                if (_compass != null)
                {
                    // Establish the report interval for all scenarios
                    uint minReportInterval = _compass.MinimumReportInterval;
                    uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
                    _compass.ReportInterval = reportInterval;
                    _compass.ReadingChanged += new TypedEventHandler<Compass, CompassReadingChangedEventArgs>(ReadingChanged);
                }
            }
        }
    }

Sarà necessario rinominare lo spazio dei nomi nel frammento precedente con il nome assegnato al progetto. Ad esempio, se è stato creato un progetto denominato CompassCS, sostituire namespace App1 con namespace CompassCS.

Aprire il file MainPage.xaml e sostituire i contenuti originali con il seguente XML:

    <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="22" Margin="8,18,0,0" TextWrapping="Wrap" Text="Magnetic Heading:" VerticalAlignment="Top" Width="104" Foreground="#FFFBF9F9"/>
            <TextBlock HorizontalAlignment="Left" Height="18" Margin="8,58,0,0" TextWrapping="Wrap" Text="True North Heading:" VerticalAlignment="Top" Width="104" Foreground="#FFF3F3F3"/>
            <TextBlock x:Name="txtMagnetic" HorizontalAlignment="Left" Height="22" Margin="130,18,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="116" Foreground="#FFFBF6F6"/>
            <TextBlock x:Name="txtNorth" HorizontalAlignment="Left" Height="18" Margin="130,58,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="116" Foreground="#FFF5F1F1"/>

         </Grid>
    </Page>

È necessario sostituire la prima parte del nome della classe nel frammento di codice precedente con lo spazio dei nomi dell'app. Ad esempio, se è stato creato un progetto denominato CompassCS, sostituire x:Class="App1.MainPage" con x:Class="CompassCS.MainPage". È anche consigliabile sostituire xmlns:local="using:App1" con xmlns:local="using:CompassCS".

Premere F5 oppure selezionare Debug>Avvio debug per compilare, distribuire ed eseguire l'app.

Una volta eseguita l'app, è possibile modificare i valori della bussola, spostando il dispositivo o usando gli strumenti dell'emulatore.

Arrestare l'app restituendo a Visual Studio e premendo MAIUSC+F5 oppure selezionare Debug>Arresta debug per bloccare l'app.

Spiegazione

L'esempio precedente illustra quanto poco codice è necessario scrivere per integrare l'input della bussola nell'app.

L'app stabilisce una connessione con la bussola predefinita nel metodo MainPage.

_compass = Compass.GetDefault(); // Get the default compass object

L'app stabilisce l'intervallo di report all'interno del metodo MainPage . Questo codice recupera l'intervallo minimo supportato dal dispositivo e lo confronta con un intervallo richiesto di 16 millisecondi (che approssima una frequenza di aggiornamento a 60 Hz). Se l'intervallo minimo supportato è maggiore dell'intervallo richiesto, il codice imposta il valore al minimo. In caso contrario, imposta il valore sull'intervallo richiesto.

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

I nuovi dati della bussola vengono acquisiti nel metodo ReadingChanged. Ogni volta che il driver del sensore riceve nuovi dati dal sensore, passa i valori all'app usando questo gestore eventi. L'app registra questo gestore eventi nella riga seguente.

_compass.ReadingChanged += new TypedEventHandler<Compass,
CompassReadingChangedEventArgs>(ReadingChanged);

Questi nuovi valori vengono scritti nei TextBlock presenti nel codice XAML del progetto.

 <TextBlock HorizontalAlignment="Left" Height="22" Margin="8,18,0,0" TextWrapping="Wrap" Text="Magnetic Heading:" VerticalAlignment="Top" Width="104" Foreground="#FFFBF9F9"/>
 <TextBlock HorizontalAlignment="Left" Height="18" Margin="8,58,0,0" TextWrapping="Wrap" Text="True North Heading:" VerticalAlignment="Top" Width="104" Foreground="#FFF3F3F3"/>
 <TextBlock x:Name="txtMagnetic" HorizontalAlignment="Left" Height="22" Margin="130,18,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="116" Foreground="#FFFBF6F6"/>
 <TextBlock x:Name="txtNorth" HorizontalAlignment="Left" Height="18" Margin="130,58,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="116" Foreground="#FFF5F1F1"/>

Condividi tramite

Usare la bussola

Prerequisiti

Creare una semplice app bussola

Istruzioni

Spiegazione

Commenti e suggerimenti

Risorse aggiuntive