接入指南 API 工具 其他

设备方向

qg.startDeviceMotionListening(Object object)

开始监听设备方向的变化。

参数

Object object

属性类型默认值必填说明
intervalStringnormal监听设备方向的变化回调函数的执行频率
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)
interval 监听设备方向的变化回调函数的执行频率
合法值说明
game适用于更新游戏的回调频率,在 20ms/次 左右
ui适用于更新 UI 的回调频率,在 60ms/次 左右
normal普通的回调频率,在 200ms/次 左右

qg.stopDeviceMotionListening(Object object)

停止监听设备方向的变化。

参数

Object object

属性类型默认值必填说明
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

qg.onDeviceMotionChange(Function listener)

监听设备方向变化事件。频率根据 qg.startDeviceMotionListening() 的 interval 参数。可以使用 qg.stopDeviceMotionListening() 停止监听。

参数 listener(Object res)

设备方向变化事件的监听函数

属性类型说明
alphaNumber当 手机坐标 X/Y 和 地球 X/Y 重合时,绕着 Z 轴转动的夹角为 alpha,范围值为 [0, 2*PI)。逆时针转动为正。
betaNumber当手机坐标 Y/Z 和地球 Y/Z 重合时,绕着 X 轴转动的夹角为 beta。范围值为 [-1*PI, PI) 。顶部朝着地球表面转动为正。也有可能朝着用户为正。
gammaNumber当手机 X/Z 和地球 X/Z 重合时,绕着 Y 轴转动的夹角为 gamma。范围值为 [-1*PI/2, PI/2)。右边朝着地球表面转动为正。

qg.offDeviceMotionChange(Function listener)

移除设备方向变化事件的监听函数

参数 listener

onDeviceMotionChange 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

qg.onDeviceMotionChange(listener);
qg.offDeviceMotionChange(listener); // 需传入与监听时同一个的函数对象

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容