Xamarin.Essentials：磁力计

  • 项目

Magnetometer 类使你能够监视设备的磁力计传感器，此传感器指示设备相对于地球磁场的方向。

入门

若要开始使用此 API，请阅读 Xamarin.Essentials 的入门指南，确保在项目中正确安装和设置库。

使用 Magnetometer

在类中添加对 Xamarin.Essentials 的引用：

using Xamarin.Essentials;

通过调用 Start 和 Stop 方法来使用 Magnetometer 功能以侦听磁力计的变化。 然后通过 ReadingChanged 事件反馈任何变化。 示例用法如下：


public class MagnetometerTest
{
    // Set speed delay for monitoring changes.
    SensorSpeed speed = SensorSpeed.UI;

    public MagnetometerTest()
    {
        // Register for reading changes.
        Magnetometer.ReadingChanged += Magnetometer_ReadingChanged;
    }

    void Magnetometer_ReadingChanged(object sender, MagnetometerChangedEventArgs e)
    {
        var data = e.Reading;
        // Process MagneticField X, Y, and Z
        Console.WriteLine($"Reading: X: {data.MagneticField.X}, Y: {data.MagneticField.Y}, Z: {data.MagneticField.Z}");
    }

    public void ToggleMagnetometer()
    {
        try
        {
            if (Magnetometer.IsMonitoring)
              Magnetometer.Stop();
            else
              Magnetometer.Start(speed);
        }
        catch (FeatureNotSupportedException fnsEx)
        {
            // Feature not supported on device
        }
        catch (Exception ex)
        {
            // Other error has occurred.
        }
    }
}

所有数据将以 µT（微特斯拉）为单位返回。

传感器速度

  • 最快 – 尽快获取传感器数据（不保证在 UI 线程上返回）。
  • 游戏 – 适合游戏的速度（不保证在 UI 线程上返回）。
  • 默认 - 适合屏幕方向更改的默认速率。
  • UI – 适合常规用户界面的速率。

如果事件处理程序不能保证在 UI 线程上运行，并且如果事件处理程序需要访问用户界面元素，请使用 MainThread.BeginInvokeOnMainThread 方法在 UI 线程上运行该代码。

API