微信小程序API 设备方向

wx.stopDeviceMotionListening(Object object)

基础库 2.3.0 开始支持，低版本需做兼容处理。

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

参数

Object object

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

---

wx.startDeviceMotionListening(Object object)

基础库 2.3.0 开始支持，低版本需做兼容处理。

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

参数

Object object

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

object.interval 的合法值

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

---

wx.onDeviceMotionChange(function callback)

基础库 2.3.0 开始支持，低版本需做兼容处理。

监听设备方向变化事件。频率根据 wx.startDeviceMotionListening() 的 interval 参数。可以使用 wx.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)。右边朝着地球表面转动为正。

---

wx.offDeviceMotionChange(function callback)

基础库 2.9.3 开始支持，低版本需做兼容处理。

取消监听设备方向变化事件，参数为空，则取消所有的事件监听。

参数

function callback

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

wx.offDeviceMotionChange(function callback)

基础库 2.9.3 开始支持，低版本需做兼容处理。

取消监听设备方向变化事件，参数为空，则取消所有的事件监听。

参数

function callback

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

基础库 2.9.3 开始支持，低版本需做兼容处理。

取消监听设备方向变化事件，参数为空，则取消所有的事件监听。

参数

function callback

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