Использование компаса

Статья
07/05/2024

Узнайте, как использовать компас для определения текущего заголовка.

Важные API

Необходимые компоненты

Вы должны быть знакомы с языком разметки расширяемых приложений (XAML), Microsoft Visual C# и событиями.

Устройство или эмулятор, которое вы используете, должно поддерживать компас.

Создание простого приложения компаса

Приложение может получить текущий заголовок относительно магнитного или истинного, северного. Приложения навигации используют компас для определения направления, с которым сталкивается устройство, а затем ориентации карты соответствующим образом.

Примечание.

Для более полной реализации см. пример компаса.

Instructions

Создайте проект, выбрав пустое приложение (универсальное приложение Windows) из шаблонов проектов Visual C# .
Откройте файл MainPage.xaml.cs проекта и замените существующий код следующим.

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

Вам потребуется переименовать пространство имен в предыдущем фрагменте кода с именем, которым вы предоставили проект. Например, если вы создали проект с именем CompassCS, замените namespace App1 его namespace CompassCS.

Откройте файл MainPage.xaml и замените исходное содержимое следующим 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>

Необходимо заменить первую часть имени класса в предыдущем фрагменте на пространство имен приложения. Например, если вы создали проект с именем CompassCS, замените x:Class="App1.MainPage" его x:Class="CompassCS.MainPage". Также следует заменить xmlns:local="using:App1" xmlns:local="using:CompassCS"на .

Нажмите клавишу F5 или выберите отладку отладки для>сборки, развертывания и запуска приложения.

После запуска приложения можно изменить значения компаса, переместив устройство или используя средства эмулятора.

Остановите приложение, вернитесь в Visual Studio и нажав клавиши SHIFT+F5 или выберите "Остановить отладку отладки>", чтобы остановить приложение.

Описание

В предыдущем примере показано, насколько мало кода необходимо написать для интеграции входных данных компаса в приложение.

Приложение устанавливает соединение с компасом по умолчанию в методе MainPage .

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

Приложение устанавливает интервал отчета в методе MainPage . Этот код извлекает минимальный интервал, поддерживаемый устройством, и сравнивает его с запрошенным интервалом в 16 миллисекунд (приблизительно 60-Гц скорость обновления). Если минимальный поддерживаемый интервал больше запрошенного интервала, код задает значение минимальному. В противном случае оно задает значение запрошенного интервала.

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

Новые данные компаса записываются в методе ReadingChanged . Каждый раз, когда драйвер датчика получает новые данные от датчика, он передает значения приложению с помощью этого обработчика событий. Приложение регистрирует этот обработчик событий в следующей строке.

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

Эти новые значения записываются в TextBlocks, найденные в XAML проекта.

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

Поделиться через

Использование компаса

Необходимые компоненты

Создание простого приложения компаса

Instructions

Описание

Обратная связь

Дополнительные ресурсы