.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 封装已经足够直接可靠。重点是权限、速率选择和及时释放资源。
