.NET MAUI通过统一Sensors API跨平台访问加速度计和陀螺仪,需配置权限、运行时授权并调用Start/Stop;加速度计返回含重力的合加速度(m/s²),陀螺仪返回角速度(rad/s),注意漂移与平台差异。

.NET MAUI 访问加速度计和陀螺仪不依赖平台写法,而是通过统一的 Sensors API 实现——只要设备支持、权限到位,一行代码就能启动监听。 它底层自动桥接 Android 的 SensorManager、iOS 的 CMMotionManager 和 Windows 的 Accelerometer/Gyrometer 类,开发者无需手动处理原生调用。
启用传感器前的必要准备
确保三件事已落实,否则传感器会静默失败:
- 在
Platforms/Android/AndroidManifest.xml中添加权限:(Android 10+ 需要)(仅陀螺仪在部分 Android 版本需要) - iOS 需在
Platforms/iOS/Info.plist中添加描述键:NSMotionUsageDescription 应用需访问运动数据以提供体感交互 - 运行时请求权限(推荐使用
Permissions.RequestAsync),尤其 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 封装已经足够直接可靠。重点是权限、速率选择和及时释放资源。










