using Xamarin.Essentials;

通过调用 StartStop 方法来使用 Compass 功能以侦听罗盘的变化。 然后通过 ReadingChanged 事件反馈任何变化。 下面是一个示例:

public class CompassTest
    // Set speed delay for monitoring changes.
    SensorSpeed speed = SensorSpeed.UI;
    public CompassTest()
        // Register for reading changes, be sure to unsubscribe when finished
        Compass.ReadingChanged += Compass_ReadingChanged;
    void Compass_ReadingChanged(object sender, CompassChangedEventArgs e)
        var data = e.Reading;
        Console.WriteLine($"Reading: {data.HeadingMagneticNorth} degrees");
        // Process Heading Magnetic North
    public void ToggleCompass()
            if (Compass.IsMonitoring)
              Compass.Stop();
              Compass.Start(speed);
        catch (FeatureNotSupportedException fnsEx)
            // Feature not supported on device
        catch (Exception ex)
            // Some other exception has occurred

传感器速度

  • 最快 – 尽快获取传感器数据(不保证在 UI 线程上返回)。
  • 游戏 – 适合游戏的速度(不保证在 UI 线程上返回)。
  • 默认 - 适合屏幕方向更改的默认速率。
  • UI – 适合常规用户界面的速率。
  • 如果事件处理程序不能保证在 UI 线程上运行,并且如果事件处理程序需要访问用户界面元素,请使用 MainThread.BeginInvokeOnMainThread 方法在 UI 线程上运行该代码。

    平台实现细节

    Android

    Android 不提供用于检索罗盘航向的 API。 我们使用 Google 推荐的方法,利用加速计和磁力计来计算磁北航向。

    在极少数情况下,可能会看到不一致的结果,因为需要校准传感器,这就涉及到以 8 字形来移动设备。 进行此操作的最佳方式是打开 Google 地图,点击你所在的位置点,然后选择“校准罗盘”。

    同时从应用运行多个传感器可能会调整传感器速度。

    低通筛选器

    根据 Android 罗盘值的更新和计算方式,可能需要平滑处理这些值。 可以应用一个低通滤波器来平均角度的正弦和余弦值,并且可以使用接受 参数的 bool applyLowPassFilter 方法重载来启用此滤波器:

    Compass.Start(SensorSpeed.UI, applyLowPassFilter: true);
    

    该参数仅适用于 Android 平台,iOS 和 UWP 会忽略该参数。 可以在此处查看详细信息。

  • Compass 源代码
  • Campass API 文档
  • 第 9 频道YouTube 上查找更多 Xamarin 视频。