Skip to main content
版本：v3

Accelerometer

API_LEVEL 3.0 开始支持，API 兼容性请参考 API_LEVEL。

Accelerometer_image}

加速度传感器。沿三个正交轴（x,y,z）测量设备的加速度，x、y 轴与屏幕平行，正方向参考图示，z 轴垂直于设备的屏幕，正方向指向上方。

信息

权限代码： device:os.accelerometer

方法​

start​

开始监听加速度传感器数据

start(): void

stop​

停止监听加速度传感器数据

stop(): void

getCurrent​

获取当前加速度传感器数据

getCurrent(): Result

Result​

属性类型说明API_LEVEL
xnumberx 轴的加速度，单位 cm/s^23.0
ynumbery 轴的加速度，单位 cm/s^23.0
znumberz 轴的加速度，单位 cm/s^23.0

onChange​

注册加速度传感器数据变化事件监听回调函数

onChange(callback: () => void): void

offChange​

取消加速度传感器数据变化事件监听回调函数

offChange(callback: () => void): void

setFreqMode​

API_LEVEL 3.0

设置触发频率的模式，mode 值参考频率模式常量

setFreqMode(mode: number): void

常量​

频率模式​
常量说明API_LEVEL
FREQ_MODE_LOW低功耗模式，触发频率低3.0
FREQ_MODE_NORMAL正常功耗模式，触发频率中等3.0
FREQ_MODE_HIGH高功耗模式，触发频率高3.0

getFreqMode​

API_LEVEL 3.0

获取触发频率模式，结果值参考频率模式常量

getFreqMode(): number

常量​

频率模式​
常量说明API_LEVEL
FREQ_MODE_LOW低功耗模式，触发频率低3.0
FREQ_MODE_NORMAL正常功耗模式，触发频率中等3.0
FREQ_MODE_HIGH高功耗模式，触发频率高3.0

代码示例​

import { Accelerometer, FREQ_MODE_NORMAL } from '@zos/sensor'

const accelerometer = new Accelerometer()

const callback = () => {
  console.log(accelerometer.getCurrent())
}
accelerometer.onChange(callback)
accelerometer.setFreqMode(FREQ_MODE_NORMAL)
accelerometer.start()

// When not needed for use
accelerometer.offChange()
accelerometer.stop()