# 设备方向

# qq.stopDeviceMotionListening

# qq.stopDeviceMotionListening(Object object)

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

# 参数

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

# qq.startDeviceMotionListening

# qq.startDeviceMotionListening(Object object)

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

# 参数

# Object object
属性 类型 默认值 必填 说明
interval string normal 监听设备方向的变化回调函数的执行频率
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.interval 的合法值

说明
game 适用于更新游戏的回调频率,在 20ms/次 左右
ui 适用于更新 UI 的回调频率,在 60ms/次 左右
normal 普通的回调频率,在 200ms/次 左右

# qq.onDeviceMotionChange

# qq.onDeviceMotionChange(function callback)

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

# 参数

# function callback

设备方向变化事件的回调函数

# 参数

Object res

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