接口: SensorExt


接口: SensorExt

sensors.SensorExt

getSensor返回的对象的拓展,在Android原生Sensor类open in new window上拓展了额外的函数,主要是enableSensorEventdisableSensorEvent

继承关系

  • unknown

    SensorExt

目录

方法

Events

方法

disableSensorEvent

disableSensorEvent(): SensorExt

禁用传感器事件。在调用本函数后,传感器将不会发送changeaccuracy_change事件。

返回值

SensorExt


enableSensorEvent

enableSensorEvent(delay?): SensorExt

启用传感器事件。在调用本函数前,传感器将不会发送changeaccuracy_change事件。

参数

名称 类型 描述
delay? SensorDelay 传感器事件频率

返回值

SensorExt

Events

on

on(event, listener): SensorExt

传感器数据回调事件。其回调的第一个参数是android.hardware.SensorEventopen in new window对象,后面的参数则根据传感器类型不同而不同。

常见的传感器的参数类型为:

  • accelerometer: (event: SensorEvent, ax: number, agy: number, az: number),表示各个方向的加速度,单位是m/s^2
  • magnetic_field: (event: SensorEvent, hx: number, hy: number, hz: number),表示各个方向磁场强度,单位是uT
  • orientation: (event: SensorEvent, azimuth: number, pitch: number, roll: number),表示方向,参见SensorEvent.valuesopen in new window
  • gyroscope: (event: SensorEvent, axisX: number, axisY: number, axisZ: number),表示各个方向的角速度,单位是rad/s
  • light: (event: SensorEvent, lux: number),表示光线强度,单位是lx
  • pressure: (event: SensorEvent, pressure: number),表示气压,单位是hPa
  • temperature: (event: SensorEvent, temperature: number),表示温度,单位是°C
  • proximity: (event: SensorEvent, distance: number),表示距离,单位是cm
  • gravity: (event: SensorEvent, gx: number, gy: number, gz: number),表示各个方向的重力加速度,单位是m/s^2
  • linear_acceleration: (event: SensorEvent, ax: number, ay: number, az: number),表示各个方向的线性加速度,单位是m/s^2

参见

SensorEventopen in new window change

参数

名称 类型
event "change"
listener (event: SensorEvent, ...args: any) => void

返回值

SensorExt

on(event, listener): SensorExt

传感器精度变化事件。传感器精度accuracy范围为0~3,0表示数据不可靠,1~3表示低精度到高精度。

参见

onAccuracyChangedopen in new window accuracy_change

参数

名称 类型
event "accuracy_change"
listener (event: SensorEvent, accuracy: number) => void

返回值

SensorExt