智能小程序 Ray 开发设备 API —— 设备方向、加速计 API 合集

设备方向 API 

startDeviceMotionListening

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

引入

import { startDeviceMotionListening } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
interval	DeviceMotionInterval		否	监听加速度数据回调函数的执行频率
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否

 

stopDeviceMotionListening

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

引入

import { stopDeviceMotionListening } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

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

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

onDeviceMotionChange

监听设备方向变化事件

引入

import { onDeviceMotionChange } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

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)。右边朝着地球表面转动为正。

 

offDeviceMotionChange

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

引入

import { offDeviceMotionChange } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

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)。右边朝着地球表面转动为正。

 

加速计 API

startAccelerometer

开始监听加速度数据

引入

import { startAccelerometer } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
interval	AccelerometerInterval		否	监听加速度数据回调函数的执行频率
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否

 

stopAccelerometer

停止监听加速度数据

引入

import { stopAccelerometer } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

Object object

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

 

onAccelerometerChange

监听加速度数据事件

引入

import { onAccelerometerChange } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

function callback

监听加速度数据事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
x	number		是	X 轴
y	number		是	Y 轴
z	number		是	Z 轴

 

offAccelerometerChange

取消监听加速度数据事件，参数为空，则取消所有的事件监听

引入

import { offAccelerometerChange } from '@ray-js/ray';

需引入BaseKit，且在>=2.3.2版本才可使用

参数

function callback

取消监听加速度数据事件，参数为空，则取消所有的事件监听的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
x	number		是	X 轴
y	number		是	Y 轴
z	number		是	Z 轴

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。