MAUI怎么访问加速度计和陀螺仪 MAUI传感器API教程

来源:这里教程网 时间:2026-02-21 17:36:36 作者:

.NET MAUI 访问加速度计和陀螺仪不依赖平台写法,而是通过统一的 Sensors API 实现——只要设备支持、权限到位,一行代码就能启动监听。 它底层自动桥接 Android 的

SensorManager
、iOS 的
CMMotionManager
和 Windows 的
Accelerometer
/
Gyrometer
类,开发者无需手动处理原生调用。

启用传感器前的必要准备

确保三件事已落实,否则传感器会静默失败:

Platforms/Android/AndroidManifest.xml
中添加权限:
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"></uses-permission>
(Android 10+ 需要)
<uses-permission android:name="android.permission.BODY_SENSORS"></uses-permission>
(仅陀螺仪在部分 Android 版本需要)
iOS 需在
Platforms/iOS/Info.plist
中添加描述键:
<key>NSMotionUsageDescription</key><string>应用需访问运动数据以提供体感交互</string>
运行时请求权限(推荐使用
Permissions.RequestAsync<sensors>()</sensors>
),尤其 Android 12+ 和 iOS 必须显式授权

用 Sensors API 监听加速度计

加速度计返回的是设备在 X/Y/Z 轴上的**合加速度**(单位 m/s²),包含重力分量。典型用途:姿态检测、晃动触发、简易计步。

启动监听只需两步:
① 调用
Accelerometer.Start(SensorSpeed.UI)
(推荐
UI
Game
速率)
② 订阅
Accelerometer.ReadingChanged
事件
事件参数
e.Reading.AccelerationX/Y/Z
是实时浮点值,例如手机平放桌面时:
→ X≈0, Y≈0, Z≈9.81(重力向下)
→ 手机竖直立起时:Z≈0, Y≈9.81
停止监听务必调用
Accelerometer.Stop()
,避免后台耗电(尤其在页面
OnDisappearing
中执行)

用 Sensors API 监听陀螺仪

陀螺仪返回绕 X/Y/Z 轴的**角速度**(单位 rad/s),反映旋转快慢,不包含重力。适合:VR 头部追踪、图像防抖、旋转控制。

调用方式与加速度计高度一致:
Gyroscope.Start(SensorSpeed.Game)

Gyroscope.ReadingChanged += (s, e) => { var x = e.Reading.AngularVelocityX; ... };
注意:陀螺仪存在漂移(drift),长时间积分求角度会累积误差;如需精准方向,应融合加速度计和磁力计,用传感器融合算法(如互补滤波)校正 某些低端 Android 设备可能无硬件陀螺仪,可用
Gyroscope.IsSupported
提前判断

跨平台差异处理技巧

虽然 Sensors API 统一了接口,但实际行为仍有细微差别,建议主动适配:

Android 上陀螺仪默认采样率偏低,可改用平台特定代码提升精度:
#if ANDROID
块中调用
Android.SensorManager.SetDelay()
设置更小延迟
iOS 的
CMMotionManager
对陀螺仪有更高精度和更低延迟,但需确保
gyroAvailable
为 true 再启用
Windows 平台需确认设备带物理陀螺仪(Surface Pro 等),否则
Gyroscope.IsSupported
返回 false
所有平台都建议加异常捕获:传感器可能被系统禁用、被其他应用独占,或用户手动关闭硬件开关

基本上就这些。不需要写 Java/Kotlin 或 Swift,也不用管底层驱动,MAUI 的 Sensors 封装已经足够直接可靠。重点是权限、速率选择和及时释放资源。

相关推荐