using Xamarin.Essentials;
通过调用 Start
和 Stop
方法来使用 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 视频。