设备方向

最近更新时间:2023-10-20 15:19:23

我的收藏

stopDeviceMotionListening

该 API 使用方法为 wx.stopDeviceMotionListening(Object object)
功能说明:停止监听设备方向的变化。
参数及说明:Object object。
属性
类型
默认值
必填
说明
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)

startDeviceMotionListening

该 API 使用方法为 wx.startDeviceMotionListening(Object object)
功能说明:开始监听设备方向的变化。
参数及说明:Object object。
属性
类型
默认值
必填
说明
interval
string
normal
监听设备方向的变化回调函数的执行频率,合法值为:
game:适用于更新游戏的回调帧率,在20ms/次左右
ui:适用于更新 UI 的回调帧率,在60ms/次左右
normal:普通的回调频率,在200ms/次左右
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)

onDeviceMotionChange

该 API 使用方法为 wx.onDeviceMotionChange(function listener)
功能说明:监听设备方向变化事件。频率根据 wx.startDeviceMotionListening() 的 interval 参数。可以使用 wx.stopDeviceMotionListening() 停止监听。
参数及说明:function listener,设备方向变化事件的监听函数。
属性
类型
说明
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)。右边朝着地球表面转动为正。

offDeviceMotionChange

该 API 使用方法为 wx.offDeviceMotionChange(function listener)
功能说明:移除设备方向变化事件的监听函数。
参数及说明:function listener,onDeviceMotionChange 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

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