罗盘

qq.stopCompass

qq.stopCompass(Object object)

停止监听罗盘数据

参数

Object object
属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

  1. qq.stopCompass()

qq.startCompass

qq.startCompass(Object object)

开始监听罗盘数据

参数

Object object
属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

  1. qq.startCompass()

qq.onCompassChange

qq.onCompassChange(function callback)

监听罗盘数据变化事件。频率：5 次/秒，接口调用后会自动开始监听，可使用 qq.stopCompass 停止监听。

参数

function callback

罗盘数据变化事件的回调函数

参数

Object res

属性类型说明最低版本
directionnumber面对的方向度数
accuracynumber/string精度

示例代码

  1. qq.onCompassChange(function (res) {
  2.   console.log(res.direction)
  3. })

accuracy 在 iOS/Android 的差异

由于平台差异，accuracy 在 iOS/Android 的值不同。

  • iOS：accuracy 是一个 number 类型的值，表示相对于磁北极的偏差。0 表示设备指向磁北，90 表示指向东，180 表示指向南，依此类推。
  • Android：accuracy 是一个 string 类型的枚举值。
    值说明
    high高精度
    medium中等精度
    low低精度
    no-contact不可信，传感器失去连接
    unreliable不可信，原因未知
    unknow ${value}未知的精度枚举值，即该 Android 系统此时返回的表示精度的 value 不是一个标准的精度枚举值