uni.oncompasschange仅在app端稳定可用，小程序需基础库2.25.0+且授权scope.userlocation，h5不支持；必须先调用uni.startcompass()才能触发，返回res.direction为磁北角度（0–360°），需补偿磁偏角；页面卸载或隐藏时须调用uni.stopcompass()防耗电。
uni.onCompassChange 能用，但只在 App 和部分小程序生效
这个 API 名字叫 uni.onCompassChange，名义上是监听手机罗盘（地磁方向），但它在 H5 端完全不工作——浏览器不提供底层地磁传感器访问权限；微信小程序端从基础库 2.25.0 起才开始有限支持，且需用户授权 scope.userLocation（因为罗盘数据常与定位强绑定）；真正稳定可用的只有 App 端（iOS/Android 原生 WebView 可透传硬件数据）。
调用前必须先启动：不调 uni.startCompass()，uni.onCompassChange 不会触发回调。它不是“注册即监听”，而是依赖原生模块激活状态。
常见错误现象：
-
uni.onCompassChange注册后没反应 → 忘了uni.startCompass()，或调用失败未检查fail回调 - 回调里
res.direction一直是0或NaN→ 设备未校准（尤其 Android 部分机型需手动画∞字）、或周围有强磁场干扰（如靠近音箱、金属桌面） - H5 页面报错
uni.startCompass is not a function→ 没做条件编译，直接在非 App 环境调用了
必须用 #ifdef APP-PLUS 包裹，否则构建或运行时报错
uni.startCompass 和 uni.onCompassChange 是原生能力，H5 和多数小程序平台没有对应实现。不加条件编译，HBuilderX 云打包时可能跳过，但本地调试 H5 会直接报 TypeError，微信小程序则报 plus is not defined。
正确写法是：
#ifdef APP-PLUS
uni.startCompass({
success: () => {
uni.onCompassChange(res => {
console.log('当前朝向角度：', res.direction);
});
},
fail: err => {
console.error('启动罗盘失败', err);
}
});
#endif
别把 #ifdef 写在方法体外（比如整个 onLoad 函数外），那样会导致 H5 页面连生命周期钩子都失效。只包裹实际调用语句即可。
res.direction 不是绝对地理北，而是设备顶部指向的磁北角度
res.direction 返回的是一个 0–360 的数字，单位是度，含义是“设备顶部所指方向相对于磁北的夹角”。0° = 正北，90° = 正东，180° = 正南，270° = 正西——但它不补偿磁偏角（magnetic declination），所以和真实地理北有偏差（国内偏差约 -5° 到 -10°，随地区变化）。
如果你要做导航类应用，不能直接拿 res.direction 当真北用。需要：
- 查当地磁偏角表（如 NOAA 提供的在线计算器），硬编码补偿值
- 或结合
uni.getLocation获取经纬度后，调用服务端接口计算实时磁偏角（精度更高） - 注意：iOS 真机上
res.direction常比 Android 更平滑，但首次回调可能延迟 1–2 秒；Android 部分低端机（如旧款 Redmi）会出现突变抖动，建议加简单中值滤波
页面卸载时必须手动 stop，否则后台持续耗电
uni.onCompassChange 是长连接式监听，不像 uni.onWindowResize 那样能靠 uni.offWindowResize 清理。它没有对应的 offCompassChange 方法，唯一清理方式是调用 uni.stopCompass()。
漏掉这步的后果很实在：App 进入后台后罗盘模块仍在运行，iOS 会快速弹出“此应用正在使用位置服务”提示，Android 则明显增加待机耗电（实测某华为机型后台多耗 3–5%/小时）。
务必在 onUnload 或 onHide 中执行：
#ifdef APP-PLUS uni.stopCompass(); #endif
别依赖用户手动退出——很多用户只是切到微信聊两句再回来，onUnload 不触发，但 onHide 会，所以更稳妥的做法是在 onHide 里 stopCompass，onShow 里再 startCompass。
