bl.onCompassChange(function callback)
基础库版本 >=
3.57.0支持
监听罗盘数据变化事件。频率：5 次/秒，接口调用后会自动开始监听，可使用 bl.stopCompass 停止监听。
参数
function callback
罗盘数据变化事件的回调函数
参数
object res 的结构说明
| 属性 | 类型 | 说明 | 版本 |
|---|---|---|---|
| direction | number | 面对的方向度数 | 3.57.0 |
| accuracy | number/string | 精度 | 3.57.0 |
示例代码
bl.onCompassChange(function (res) {
console.log(res.direction)
})
Bug & Tip
accuracy 在 iOS/Android 的差异
由于平台差异，accuracy 在 iOS/Android 的值不同。
- iOS：accuracy 是一个 number 类型的值，表示相对于磁北极的偏差。0 表示设备指向磁北，90 表示指向东，180 表示指向南，依此类推。
- Android：accuracy 是一个 string 类型的枚举值。
| 值 | 说明 | 版本 |
|---|---|---|
| high | 高精度 | 3.57.0 |
| medium | 中等精度 | 3.57.0 |
| low | 低度数 | 3.57.0 |
| no-contact | 不可信，传感器失去连接 | 3.57.0 |
| unreliable | 不可信，原因未知 | 3.57.0 |
| unknow ${value} | 未知的精度枚举值，即该 Android 系统此时返回的表示精度的 value 不是一个标准的精度枚举值 | 3.57.0 |