# 罗盘

# qq.stopCompass

QQ mac版本:不支持

QQ windows版本:不支持

# qq.stopCompass(Object object)

停止监听罗盘数据

# 参数

# Object object
属性 类型 默认值 必填 说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例代码

qq.stopCompass()
1

# qq.startCompass

QQ mac版本:不支持

QQ windows版本:不支持

# qq.startCompass(Object object)

开始监听罗盘数据

# 参数

# Object object
属性 类型 默认值 必填 说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例代码

qq.startCompass()
1

# qq.onCompassChange

QQ mac版本:不支持

QQ windows版本:不支持

# qq.onCompassChange(function callback)

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

# 参数

# function callback

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

# 参数

Object res

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

# 示例代码

qq.onCompassChange(function (res) {
  console.log(res.direction)
})
1
2
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 不是一个标准的精度枚举值