2023年微信小程序API-设备-罗盘
作者: --时间: 2022-09-29
阅读量:
微信小程序API-设备-罗盘提供了方便的罗盘数据监听和控制功能,是企业开发小程序时必不可少的一部分。
1. 实时监听罗盘数据
wx.onCompassChange()函数可用于实时监听罗盘数据,每秒更新5次。调用该函数后系统会开始自动监听,可通过wx.stopCompass()停止监听。回调函数返回当前的朝向角度。
| 参数 | 类型 | 说明 |
|---|---|---|
| direction | Number | 面对的方向度数 |
wx.onCompassChange(function (res) {
console.log(res.direction)
})
2. 开始/停止监听罗盘数据
wx.startCompass()函数可用于开始监听罗盘数据,低版本需做兼容处理。成功开始监听后,可在回调函数中执行相应逻辑。wx.stopCompass()函数可用于停止监听罗盘数据。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
wx.startCompass()
停止监听罗盘数据:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
wx.stopCompass()
3. 取消监听罗盘数据变化事件
wx.offCompassChange()函数可用于取消监听罗盘数据变化事件,若不传入回调函数参数则取消所有事件监听。
function callback
罗盘数据变化事件的回调函数

