uni.startGyroscope在App端未实现，应改用uni.startDeviceMotionListening获取姿态角；需显式设interval字符串，注意权限与硬件兼容性，高精度需求须走原生通道。
uni-app 官方 API 的 uni.startGyroscope 在 App 端完全不工作——不是你漏了权限、没写回调，是原生层压根没实现。 iOS 和 Android 的陀螺仪底层（CMMotionManager / SensorManager）差异太大，uni-app 选择跳过封装。真机实测：调用后静默失败，uni.onGyroscopeChange 永远不触发。
别用 uni.startGyroscope，改用 uni.startDeviceMotionListening
这是目前唯一被 uni-app 官方支持、且在 iOS/Android App 真机上实际有效的替代方案：
- 它不返回原始角速度（rad/s），而是返回设备姿态角：
alpha（绕 z 轴）、beta（绕 x 轴）、gamma（绕 y 轴），单位为度（°） -
interval必须显式传字符串：'game'（≈60Hz）、'ui'（≈20Hz）、'normal'（≈10Hz）；设成数字或省略会降级为最低频 - iOS 13+ 首次调用会自动弹授权框；Android 不需要额外权限，但部分厂商 ROM 可能检查
ACCESS_FINE_LOCATION - H5 端也支持，但 Safari 必须先调
DeviceMotionEvent.requestPermission()，否则静默失败 - 注意：
beta和gamma只能反映旋转趋势，不能用于积分计算 yaw 角，精度和响应延迟都不满足 AR 或体感控制需求
要真实角速度（x/y/z rad/s），必须走原生通道
Native.js 是最快验证路径，但极易出错，关键点如下：
- 不能在
onLoad阶段调用，必须等plus.ready触发后才安全，否则plus.android.runtimeMainActivity()返回null - Android 必须动态申请
BODY_SENSORS权限（安卓 12+ 强制），仅ACCESS_FINE_LOCATION不够 - iOS 需在
Info.plist添加NSMotionUsageDescription字符串，否则CMMotionManager初始化直接失败，无日志、无提示 - 设备兼容性必须检查：
sensorManager.getDefaultSensor(3)（TYPE_GYROSCOPE = 3）返回null表示硬件不支持（常见于低端平板、部分华为旧机型） - Native.js 中类名、方法签名、参数类型写错，会直接报错或无响应——它不是“增强 JS”，就是 JS 直接调 Java/Objective-C
别把加速度计当陀螺仪用
常见误操作：uni.startAccelerometer + uni.onAccelerometerChange 返回的是三轴线性加速度（m/s²），含重力分量，抖动大、低频（默认 10–20Hz），和角速度无关：
-
uni.getAccelerometerFrequency只设置频率，不启动监听；必须配对uni.startAccelerometer()才生效 - 摇一摇逻辑若只比
Math.abs(x) > 1.5，躺着摇、边走边摇都会漏判或误判；应算加速度变化率（jerk）：缓存最近几帧，算差值平方和，连续超阈值再判定 - 页面卸载后没调
uni.stopAccelerometer()，uni.onAccelerometerChange仍执行 → 典型内存泄漏，可能报Cannot read property 'xxx' of null
真正需要高精度角速度的场景（如 AR、体感游戏、姿态解算），绕不开原生能力补全；而 uni.startDeviceMotionListening 仅适合 UI 层轻量级方向反馈。最容易被忽略的是：设备硬件支持检查和权限声明缺一不可，且 Native.js 的生命周期约束比想象中更严格。
