uni.onAccelerometerChange监听加速度计（非陀螺仪），返回x/y/z线性加速度（m/s²）；App端需通过原生插件接入陀螺仪，H5端受限无法可靠获取角速度。
uni-app 中怎么调用 uni.onAccelerometerChange 获取陀螺仪数据？
不是所有设备都支持陀螺仪，uni.onAccelerometerChange 实际监听的是加速度计（accelerometer），不是陀螺仪（gyroscope）。uni-app 官方 API 目前不提供原生陀螺仪接口，iOS/Android 原生的 deviceorientation 或 webkitDeviceOrientation 也无法在 WebView 环境下直接使用。
- 调用
uni.startAccelerometer后，uni.onAccelerometerChange返回的是 x/y/z 三个方向的线性加速度值（单位 m/s²），含重力分量 - 想要角速度（即陀螺仪输出的 α/β/γ 或 x/y/z 角速率），必须走原生插件或条件编译 + App 端扩展
- H5 端受限于浏览器策略，
DeviceMotionEvent在部分 iOS Safari 版本中默认禁用，需用户手动授权（requestPermission）
App 端如何用原生插件补全陀螺仪功能？
只有 App 端（iOS/Android）能真正访问陀螺仪硬件。H5 和小程序端无法绕过平台限制。
- 必须通过
uni-app的「原生插件」机制，在nativePlugins目录下集成已封装好的陀螺仪模块（如基于 AndroidSensor.TYPE_GYROSCOPE或 iOSCMMotionManager） - 插件需导出统一 JS 接口，例如：
gyro.start()、gyro.onGyroscopeChange(callback) - 注意权限配置：Android 需在
AndroidManifest.xml加<uses-permission android:name="android.permission.BODY_SENSORS"></uses-permission>；iOS 需在Info.plist添加NSMotionUsageDescription - 插件返回的数据单位通常是 rad/s，和
uni.onAccelerometerChange的 m/s² 不可混用，做姿态解算时必须区分传感器类型
为什么 uni.onAccelerometerChange 数据抖动大、不准？
这不是 bug，是加速度计本身的物理特性叠加了 uni-app 的采样策略。
- 默认采样频率低（约 10–20Hz），且不同平台实际触发间隔不稳定；高频读取会显著增加功耗，uni-app 主动做了节流
- 原始数据含噪声和重力偏移，直接用于角度估算误差极大（比如手机平放时 y 轴应接近 -9.8，但实测常为 -9.3～-10.1）
- 解决方法不是“调高频率”，而是：
- 用低通滤波（如移动平均、一阶 IIR）平滑原始
x/y/z - 静止时校准偏移值（采集 1 秒空闲数据求均值，后续减去该偏移）
- 若需倾角，优先用
Math.atan2(x, Math.sqrt(y*y + z*z))等比值计算，避开绝对数值误差
- 用低通滤波（如移动平均、一阶 IIR）平滑原始
uni-app 条件编译下，H5 能否用 DeviceMotionEvent 替代？
可以，但仅限部分 Android 浏览器和新版 Chrome，iOS Safari 基本不可用（尤其 iOS 13+ 默认禁用，且无可靠唤醒方式）。
- 必须在用户手势触发后（如
click、touchend）内调用DeviceMotionEvent.requestPermission()，否则静默失败 - 即使授权成功，
rotationRate字段在 Safari 中始终为null，只能拿到acceleration（仍不是陀螺仪） - H5 端真正可用的只有加速度粗略估算，别指望做稳定姿态跟踪；如果业务强依赖陀螺仪，请明确告知用户「仅 App 可用」并隐藏 H5 入口
真实项目里，最容易被忽略的是：把加速度当角速度用、在未校准状态下直接积分求角度、以及对 H5 端能力过度乐观——这三个点几乎必踩坑。
