Version: 2.2.1
Taro.onCompassChange(callback)
监听罗盘数据变化事件。频率:5 次/秒,接口调用后会自动开始监听,可使用 Taro.stopCompass 停止监听。
类型
(callback: Callback) => void
参数
Callback
罗盘数据变化事件的回调函数
(result: OnCompassChangeCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnCompassChangeCallbackResult |
OnCompassChangeCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| accuracy | string | number | 精度 由于平台差异,accuracy 在 iOS/Android 的值不同。 - iOS:accuracy 是一个 number 类型的值,表示相对于磁北极的偏差。0 表示设备指向磁北,90 表示指向东,180 表示指向南,依此类推。 - Android:accuracy 是一个 string 类型的枚举值。 |
| direction | number | 面对的方向度数 |
accuracy
| 参数 | 说明 |
|---|---|
| high | 高精度 |
| medium | 中等精度 |
| low | 低精度 |
| no-contact | 不可信,传感器失去连接 |
| unreliable | 不可信,原因未知 |
| unknow {value} | 未知的精度枚举值,即该 Android 系统此时返回的表示精度的 value 不是一个标准的精度枚举值 |
示例代码
Taro.onCompassChange(function (res) {
console.log(res.direction)
})
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| Taro.onCompassChange | ✔️ | ✔️ |