uni.startgyroscope在app端无效是因官方未实现原生层支持，仅鸿蒙4.0+可用；android/ios需native.js或原生插件，注意权限、设备支持、数据滤波与后台限制。
uni-app 官方 API 在 App 端不支持陀螺仪（uni.startGyroscope 是个空实现，真机无效）；H5 和小程序端受限于平台策略，根本无法可靠获取角速度数据。真正能用的，只有 App 端 + 原生能力补全这一条路。
为什么 uni.startGyroscope 在 App 端调不通
这不是你配置错了，也不是权限没开全——是 uni-app 官方压根没在 Android/iOS 原生层实现这个 API。文档里写着，但底层没接通。实测所有 3.x 版本的 App 打包后调用 uni.startGyroscope 都会静默失败，uni.onGyroscopeChange 从不触发。官方选择跳过陀螺仪，是因为 iOS 的 CMMotionManager 和 Android 的 SensorManager 生命周期、权限模型、回调线程差异太大，统一封装风险高、维护成本大。
常见错误现象：
- 调用
uni.startGyroscope后无报错、无日志、无回调 -
uni.getSystemInfoSync().platform === 'app'为 true，但传感器数据始终为 0 - Android 真机上
adb logcat查不到任何陀螺仪注册日志
App 端必须用 Native.js 或原生插件接入陀螺仪
Native.js 是 HBuilderX 提供的 JS 直接调 Java/Objective-C 的通道，适合快速验证和中小型项目；原生插件（nativePlugins 目录）更适合长期维护、多端复用或需深度定制的场景。
关键实操点：
- Android 端必须动态申请
BODY_SENSORS权限（安卓 12+ 强制），仅ACCESS_FINE_LOCATION不够 - iOS 端需在
Info.plist添加NSMotionUsageDescription描述，否则CMMotionManager初始化直接失败 - Native.js 中不能在
onLoad阶段就调用传感器，要等plus.ready触发后才安全 - 务必检查设备是否支持：Android 调用
sensorManager.getDefaultSensor(Sensor.TYPE_GYROSCOPE)返回 null 就代表不支持（部分低端机、平板无此传感器）
示例（Android Native.js 获取传感器实例）：
const main = plus.android.runtimeMainActivity();
const Context = plus.android.importClass('android.content.Context');
const SensorManager = plus.android.importClass('android.hardware.SensorManager');
const sensorManager = main.getSystemService(Context.SENSOR_SERVICE);
const gyroSensor = sensorManager.getDefaultSensor(3); // TYPE_GYROSCOPE = 3
if (!gyroSensor) {
uni.showToast({ title: '设备不支持陀螺仪', icon: 'none' });
return;
}
数据单位、频率与滤波必须手动处理
原生返回的陀螺仪数据单位是 rad/s（弧度每秒），不是 deg/s；而 uni.onAccelerometerChange 返回的是 m/s²。两者物理意义不同，绝对不能混用或直接相加。
采样频率不可控，且抖动严重：
- Android 默认
SENSOR_DELAY_NORMAL≈ 20Hz，但实际间隔波动大（实测 12–28ms 不等） - 原始数据含高频噪声，直接用于旋转计算会导致画面“抽搐”
- 不做偏移校准：手机静置时 x/y/z 应趋近于 0，但实测常有 ±0.02～±0.05 rad/s 漂移
建议立即做的三件事：
- 静止时采集 500ms 数据求均值，作为 offset，在后续每个
onSensorChanged中减去 - 用一阶 IIR 滤波（如
y[n] = 0.8 * y[n-1] + 0.2 * x[n]）平滑输出 - 若用于 UI 旋转，优先转成欧拉角再应用，别直接用 raw x/y/z 驱动 transform
鸿蒙平台是个例外：uni.onGyroscopeChange 真的能用
鸿蒙（HarmonyOS）在 4.0+ 系统中已原生支持 uni.startGyroscope 和 uni.onGyroscopeChange，无需 Native.js。但注意：
- 仅限
app-plus编译目标为 HarmonyOS 时生效，Android/iOS 子包仍无效 - 必须在
manifest.json的h5或mp-weixin等字段外单独配置鸿蒙权限：ohos.permission.ACCELEROMETER和ohos.permission.GYROSCOPE - 回调数据结构与其他平台一致：
{ x, y, z }，单位仍是rad/s
这意味着：如果你只做鸿蒙应用，可以放心用官方 API；但只要还要兼容 Android/iOS，就必须准备两套逻辑——鸿蒙走 uni.*Gyroscope，其他端走 Native.js 或插件。
最易被忽略的一点：所有原生传感器调用都**没有跨进程保活能力**。App 进入后台后，Android 系统会在几秒内暂停 SensorListener，iOS 则可能直接终止。需要持续感知的场景（比如运动计时），必须结合前台服务或后台任务机制，不能只依赖传感器监听器本身。
