Gunakan kompas

API Penting

Sampel

Pelajari cara menggunakan kompas untuk menentukan judul saat ini.

Aplikasi dapat mengambil judul saat ini sehubungan dengan magnetik, atau benar, utara. Aplikasi navigasi menggunakan kompas untuk menentukan arah yang dihadapi perangkat dan kemudian mengarahkan peta yang sesuai.

Prasyarat

Anda harus terbiasa dengan Extensible Application Markup Language (XAML), Microsoft Visual C#, dan acara.

Perangkat atau emulator yang Anda gunakan harus mendukung kompas.

Membuat aplikasi kompas sederhana

Bagian ini dibagi menjadi dua subbagian. Subbagian pertama akan membawa Anda melalui langkah-langkah yang diperlukan untuk membuat aplikasi kompas sederhana dari awal. Subbagian berikut menjelaskan aplikasi yang baru saja Anda buat.

Instruksi

  • Buat proyek baru, pilih Aplikasi Kosong (Universal Windows) dari templat proyek Visual C#.

  • Buka file MainPage.xaml.cs proyek Anda dan ganti kode yang ada dengan yang berikut.

    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);
                }
            }
        }
    }

Anda harus mengganti nama ruang nama di cuplikan sebelumnya dengan nama yang Anda berikan kepada proyek Anda. Misalnya, jika Anda membuat proyek bernama CompassCS, Anda akan menggantinya namespace App1 dengan namespace CompassCS.

  • Buka file MainPage.xaml dan ganti konten asli dengan XML berikut.
    <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>

Anda harus mengganti bagian pertama dari nama kelas di cuplikan sebelumnya dengan ruang nama aplikasi Anda. Misalnya, jika Anda membuat proyek bernama CompassCS, Anda akan menggantinya x:Class="App1.MainPage" dengan x:Class="CompassCS.MainPage". Anda juga harus mengganti xmlns:local="using:App1" dengan xmlns:local="using:CompassCS".

  • Tekan F5 atau pilih DebugStart>Debugging untuk membangun, menyebarkan, dan menjalankan aplikasi.

Setelah aplikasi berjalan, Anda dapat mengubah nilai kompas dengan memindahkan perangkat atau menggunakan alat emulator.

  • Hentikan aplikasi dengan kembali ke Visual Studio dan tekan Shift +F5 atau pilih DebugStop>Debugging untuk menghentikan aplikasi.

Penjelasan

Contoh sebelumnya menunjukkan betapa sedikit kode yang perlu Anda tulis untuk mengintegrasikan input kompas di aplikasi Anda.

Aplikasi ini membuat koneksi dengan kompas default dalam metode MainPage .

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

Aplikasi menetapkan interval laporan dalam metode MainPage . Kode ini mengambil interval minimum yang didukung oleh perangkat dan membandingkannya dengan interval yang diminta 16 milidetik (yang mendekati refresh rate 60-Hz). Jika interval minimum yang didukung lebih besar dari interval yang diminta, kode menetapkan nilai ke minimum. Jika tidak, itu mengatur nilai ke interval yang diminta.

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

Data kompas baru ditangkap dalam metode ReadingChanged . Setiap kali driver sensor menerima data baru dari sensor, ia meneruskan nilai ke aplikasi Anda menggunakan penangan peristiwa ini. Aplikasi ini mendaftarkan penangan peristiwa ini pada baris berikut.

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

Nilai-nilai baru ini ditulis ke TextBlocks yang ditemukan di XAML proyek.

 <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"/>