微信小程序开发文档 微信小程序API 设备方向

2024-02-25 开发教程 微信小程序开发文档 匿名 3

wx.stopDeviceMotionListening(Object object)

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

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

参数

Object object

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

wx.startDeviceMotionListening(Object object)

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

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

参数

Object object

属性类型默认值必填说明
intervalstringnormal监听设备方向的变化回调函数的执行频率
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

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
属性类型说明
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)。右边朝着地球表面转动为正。

wx.offDeviceMotionChange(function callback)

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

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

参数

function callback

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

wx.offDeviceMotionChange(function callback)

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

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

参数

function callback

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

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

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

参数

function callback

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