Skip to main content
Version: v3.x

Gyroscope

Start from API_LEVEL 3.0 . Please refer to API_LEVEL.

gyroscope.

info

permission code: device:os.gyroscope

Methods​

start​

Start listening to gyroscope data

start(): void

stop​

Stop listening to gyroscope data

stop(): void

getCurrent​

Get current gyroscope data

getCurrent(): Result

Result​

PropertyTypeDescriptionAPI_LEVEL
xnumberAngular velocity of x-axis in DPS, degrees per second3.0
ynumberAngular velocity of y-axis in DPS, degrees per second3.0
znumberAngular velocity of z-axis in DPS, degrees per second3.0

onChange​

Register the gyroscope data change event listener callback function

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

offChange​

Cancel the gyroscope data change event listener callback function

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

setFreqMode​

Start from API_LEVEL 3.0

Set the mode of trigger frequency, mode value reference frequency mode constant

setFreqMode(mode: number): void

Constants​

Frequency Mode​
ConstantDescriptionAPI_LEVEL
FREQ_MODE_LOWLow power mode with low trigger frequency3.0
FREQ_MODE_NORMALNormal power consumption mode, medium trigger frequency3.0
FREQ_MODE_HIGHHigh power consumption mode with high trigger frequency3.0

getFreqMode​

Start from API_LEVEL 3.0

Get the mode of trigger frequency, result value reference frequency mode constant

getFreqMode(): number

Constants​

Frequency Mode​
ConstantDescriptionAPI_LEVEL
FREQ_MODE_LOWLow power mode with low trigger frequency3.0
FREQ_MODE_NORMALNormal power consumption mode, medium trigger frequency3.0
FREQ_MODE_HIGHHigh power consumption mode with high trigger frequency3.0

Example​

import { Gyroscope } from '@zos/sensor'

const gyroscope = new Gyroscope()

const callback = () => {
console.log(gyroscope.getCurrent())
}
gyroscope.onChange(callback)
gyroscope.start()

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