设备方向
优质
小牛编辑
132浏览
2023-12-01
jd.startDeviceMotionListening(Object object)
开始监听设备方向的变化。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| interval | string | normal | 否 | 监听设备方向的变化回调函数的执行频率 |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
object.interval 的合法值
| 值 | 说明 |
|---|---|
| game | 适用于更新游戏的回调频率，在 20ms/次 左右 |
| ui | 适用于更新 UI 的回调频率，在 60ms/次 左右 |
| normal | 普通的回调频率，在 200ms/次 左右 |
jd.stopDeviceMotionListening(Object object)
停止监听设备方向的变化。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
jd.onDeviceMotionChange(function callback)
监听设备方向变化事件。频率根据 jd.startDeviceMotionListening() 的 interval 参数。可以使用 jd.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)。右边朝着地球表面转动为正。 |
jd.offDeviceMotionChange(function callback)
取消监听设备方向变化事件，参数为空，则取消所有的事件监听。
参数
function callback
设备方向变化事件的回调函数