小米已接入快游戏联盟（OVMR）标准，通过新标准进行导出。近期小米小游戏已经停止Cocos导出，为避免影响您的游戏正常打包，请尽快迁移至快游戏联盟标准。

• 新开发者：请直接按快联盟标准接入
• 存量开发者：请直接按快联盟标准打包，避免新版本无法导出

Compass

基础信息说明

功能概述：提供罗盘数据监听能力，实时获取设备朝向与精度等级，并支持开始/停止监听及回调管理

方法说明

参数说明

qg.startCompass(object) / qg.stopCompass(object)

qg.onCompassChange(callback)

qg.offCompassChange(callback)

返回值说明

所有方法均为无返回（void），通过参数中的回调或事件回调获取结果

回调结果说明

回调成功
onCompassChange 回调参数

精度映射规则来源于实现层对底层精度值的转换逻辑。
调用 qg.onCompassChange 后会自动开始监听，可使用 qg.stopCompass 停止监听。

accuracy参数说明
Android：accuracy 是一个 String 类型的枚举值

startCompass/stopCompass 结果回调

示例代码

// 开始监听罗盘
qg.startCompass({
  success() {
    console.log('startCompass success')
  },
  fail(err) {
    console.log('startCompass fail', err)
  },
  complete() {
    console.log('startCompass complete')
  }
})

// 注册罗盘数据变化回调
qg.onCompassChange(function (res) {
  // res: { direction: Number, accuracy: String }
  console.log('direction:', res.direction, 'accuracy:', res.accuracy)
})

// 停止监听罗盘
qg.stopCompass({
  success() {
    console.log('stopCompass success')
  }
})

注意事项

• 监听罗盘回调频率约为 5 次/秒。
• 仅支持单一回调，重复调用 onCompassChange 会覆盖之前的回调。