鸿蒙开发设备管理：ohos.sensor 传感器

jf_46214456 2024-07-03 960

电子说

1.4w人已加入

描述

传感器

说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

import sensor from '@ohos.sensor';

sensor.on

ACCELEROMETER

on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback,options?: Options): void

监听加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<[AccelerometerResponse]>	是	注册加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
},
    {interval: 10000000}
);

LINEAR_ACCELERATION

on(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback, options?: Options): void

监听线性加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<[LinearAccelerometerResponse]>	是	注册线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。
options	Options	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
},
    {interval: 10000000}
);

ACCELEROMETER_UNCALIBRATED

on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback, options?: Options): void

监听未校准加速度计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的未校准加速度计传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<[AccelerometerUncaliatedResponse]>	是	注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncaliatedResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
},
    {interval: 10000000}
);

GRAVITY

on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback,options?: Options): void

监听重力传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的重力传感器类型为SENSOR_TYPE_ID_GRAVITY。
callback	Callback<[GravityResponse]>	是	注册重力传感器的回调函数，上报的数据类型为GravityResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
},
    {interval: 10000000}
);

GYROSCOPE

on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback, options?: Options): void

监听陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.GYROSCOPE ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<[GyroscopeResponse]>	是	注册陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
},
    {interval: 10000000}
);

GYROSCOPE_UNCALIBRATED

on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:Callback, options?: Options): void

监听未校准陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.GYROSCOPE ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<[GyroscopeUncaliatedResponse]>	是	注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncaliatedResponse。
options	[Options]	否	可选参数列表，设置上报频率。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
},
    {interval: 10000000}
);

SIGNIFICANT_MOTION

on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback, options?: Options): void

监听大幅动作传感器数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的大幅动作传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。
callback	Callback<[SignificantMotionResponse]>	是	注册有效运动传感器的回调函数，上报的数据类型为SignificantMotionResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION,function(data){
    console.info('Scalar data: ' + data.scalar);
},
    {interval: 10000000}
);

PEDOMETER_DETECTION

on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback: Callback, options?: Options): void

监听计步检测传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<[PedometerDetectionResponse]>	是	注册计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION,function(data){
    console.info('Scalar data: ' + data.scalar);
},
    {interval: 10000000}
);

PEDOMETER

on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback, options?: Options): void

监听计步传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<[PedometerResponse]>	是	注册计步传感器的回调函数，上报的数据类型为PedometerResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER,function(data){
    console.info('Steps: ' + data.steps);
},
    {interval: 10000000}
);

AMBIENT_TEMPERATURE

on(type:SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:Callback, options?: Options): void

监听环境温度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<[AmbientTemperatureResponse]>	是	注册环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,function(data){
    console.info('Temperature: ' + data.temperature);
},
    {interval: 10000000}
);

MAGNETIC_FIELD

on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback,options?: Options): void

监听磁场传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。
callback	Callback<[MagneticFieldResponse]>	是	注册磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
},
    {interval: 10000000}
);

MAGNETIC_FIELD_UNCALIBRATED

on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback: Callback, options?: Options): void

监听未校准磁场传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<[MagneticFieldUncaliatedResponse]>	是	注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncaliatedResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
},
    {interval: 10000000}
);

PROXIMITY

on(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback,options?: Options): void

监听接近光传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<[ProximityResponse]>	是	注册接近光传感器的回调函数，上报的数据类型为ProximityResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY,function(data){
    console.info('Distance: ' + data.distance);
},
    {interval: 10000000}
);

HUMIDITY

on(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback,options?: Options): void

监听湿度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<[HumidityResponse]>	是	注册湿度传感器的回调函数，上报的数据类型为HumidityResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY,function(data){
    console.info('Humidity: ' + data.humidity);
},
    {interval: 10000000}
);

BAROMETER

on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback,options?: Options): void

监听气压计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。
callback	Callback<[BarometerResponse]>	是	注册气压计传感器的回调函数，上报的数据类型为BarometerResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER,function(data){
    console.info('Atmospheric pressure: ' + data.pressure);
},
    {interval: 10000000}
);

HALL

on(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback, options?: Options): void

监听霍尔传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的霍尔传感器类型为SENSOR_TYPE_ID_HALL。
callback	Callback<[HallResponse]>	是	注册霍尔传感器的回调函数，上报的数据类型为 HallResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HALL,function(data){
    console.info('Status: ' + data.status);
},
    {interval: 10000000}
);

AMBIENT_LIGHT

on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback, options?: Options): void

监听环境光传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<[LightResponse]>	是	注册环境光传感器的回调函数，上报的数据类型为LightResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT,function(data){
    console.info(' Illumination: ' + data.intensity);
},
    {interval: 10000000}
);

ORIENTATION

on(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback, options?: Options): void

监听方向传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的方向传感器类型为SENSOR_TYPE_ID_ORIENTATION
callback	Callback<[OrientationResponse]>	是	注册方向传感器的回调函数，上报的数据类型为OrientationResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION,function(data){
    console.info('The device rotates at an angle around the X axis: ' + data.beta);
    console.info('The device rotates at an angle around the Y axis: ' + data.gamma);
    console.info('The device rotates at an angle around the Z axis: ' + data.alpha);
},
    {interval: 10000000}
);

HEART_RATE

on(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback, options?: Options): void

监听心率传感器数据变化一次。

需要权限 ：ohos.permission.READ_HEALTH_DATA

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<[HeartRateResponse]>	是	注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HEART_RATE,function(data){
    console.info("Heart rate: " + data.heartRate);
},
    {interval: 10000000}
);

ROTATION_VECTOR

on(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR,callback: Callback,options?: Options): void

监听旋转矢量传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<[RotationVectorResponse]>	是	注册旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。
options	[Options]	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('Scalar quantity: ' + data.w);
},
    {interval: 10000000}
);

WEAR_DETECTION

on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback,options?: Options): void

监听佩戴检测传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要订阅的佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。
callback	Callback<[WearDetectionResponse]>	是	注册佩戴检测传感器的回调函数，上报的数据类型为WearDetectionResponse。
options	Options	否	可选参数列表，设置上报频率，默认值为200000000ns。

示例：

sensor.on(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION,function(data){
    console.info('Wear status: ' + data.value);
},
    {interval: 10000000}
);

sensor.once

ACCELEROMETER

once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback): void

监听加速度传感器的数据变化一次。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<[AccelerometerResponse]>	是	注册一次加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER,function(data){
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

LINEAR_ACCELERATION

once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback): void

监听线性加速度传感器数据变化一次。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<[LinearAccelerometerResponse]>	是	注册一次线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

ACCELEROMETER_UNCALIBRATED

once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback): void

监听未校准加速度传感器的数据变化一次。

需要权限 ：ohos.permission.ACCELEROMETER ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	未校准加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<[AccelerometerUncaliatedResponse]>	是	注册一次未校准加速度传感器的回调函数，上报的数据类型为AccelerometerUncaliatedResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

GRAVITY

once(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback): void

监听重力传感器的数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	重力传感器类型为SENSOR_TYPE_ID_GRAVITY。
callback	Callback<[GravityResponse]>	是	注册一次重力传感器的回调函数，上报的数据类型为GravityResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

GYROSCOPE

once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback): void

监听陀螺仪传感器的数据变化一次。

需要权限 ：ohos.permission.GYROSCOPE ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<[GyroscopeResponse]>	是	注册一次陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

GYROSCOPE_UNCALIBRATED

once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback: Callback): void

监听未校准陀螺仪传感器的数据变化一次。

需要权限 ：ohos.permission.GYROSCOPE ，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<[GyroscopeUncaliatedResponse]>	是	注册一次未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncaliatedResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

SIGNIFICANT_MOTION

once(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION,callback: Callback): void

监听有效运动传感器的数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	有效运动传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。
callback	Callback<[SignificantMotionResponse]>	是	注册一次有效运动传感器的回调函数，上报的数据类型为SignificantMotionResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, function(data) {
    console.info('Scalar data: ' + data.scalar);
  }
);

PEDOMETER_DETECTION

once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION,callback: Callback): void

监听计步检测传感器数据变化一次。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<[PedometerDetectionResponse]>	是	注册一次计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, function(data) {
    console.info('Scalar data: ' + data.scalar);
  }
);

PEDOMETER

once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback): void

监听计步器传感器数据变化一次。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<[PedometerResponse]>	是	注册一次计步传感器的回调函数，上报的数据类型为PedometerResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, function(data) {
    console.info('Steps: ' + data.steps);
  }
);

AMBIENT_TEMPERATURE

once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback: Callback): void

监听环境温度传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<[AmbientTemperatureResponse]>	是	注册一次环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, function(data) {
    console.info('Temperature: ' + data.temperature);
  }
);

MAGNETIC_FIELD

once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback): void

监听磁场传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。
callback	Callback<[MagneticFieldResponse]>	是	注册一次磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
  }
);

MAGNETIC_FIELD_UNCALIBRATED

once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback: Callback): void

监听未校准磁场传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<[MagneticFieldUncaliatedResponse]>	是	注册一次未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncaliatedResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
  }
);

PROXIMITY

once(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback): void

监听接近光传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<[ProximityResponse]>	是	注册一次接近光传感器的回调函数，上报的数据类型为ProximityResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, function(data) {
    console.info('Distance: ' + data.distance);
  }
);

HUMIDITY

once(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback): void

监听湿度传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<[HumidityResponse]>	是	注册一次湿度传感器的回调函数，上报的数据类型为HumidityResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, function(data) {
    console.info('Humidity: ' + data.humidity);
  }
);

BAROMETER

once(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback): void

监听气压计传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。
callback	Callback<[BarometerResponse]>	是	注册一次气压计传感器的回调函数，上报的数据类型为BarometerResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(data) {
    console.info('Atmospheric pressure: ' + data.pressure);
  }
);

HALL

once(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback): void

监听霍尔传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	霍尔传感器类型为SENSOR_TYPE_ID_HALL。
callback	Callback<[HallResponse]>	是	注册一次霍尔传感器的回调函数，上报的数据类型为HallResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HALL, function(data) {
    console.info('Status: ' + data.status);
  }
);

AMBIENT_LIGHT

once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback): void

监听环境光传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<[LightResponse]>	是	注册一次环境光传感器的回调函数，上报的数据类型为LightResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, function(data) {
    console.info(' Illumination: ' + data.intensity);
  }
);

ORIENTATION

once(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback): void

监听方向传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	方向传感器类型为SENSOR_TYPE_ID_ORIENTATION。
callback	Callback<[OrientationResponse]>	是	注册一次方向传感器的回调函数，上报的数据类型为OrientationResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, function(data) {
    console.info('The device rotates at an angle around the X axis: ' + data.beta);
    console.info('The device rotates at an angle around the Y axis: ' + data.gamma);
    console.info('The device rotates at an angle around the Z axis: ' + data.alpha);
  }
);

ROTATION_VECTOR

once(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: Callback): void

监听旋转矢量传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<[RotationVectorResponse]>	是	注册一次旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, function(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('Scalar quantity: ' + data.w);
  }
);

HEART_RATE

once(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback): void

监听心率传感器数据变化一次。

需要权限 ：ohos.permission.READ_HEALTH_DATA

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<[HeartRateResponse]>	是	注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HEART_RATE, function(data) {
    console.info("Heart rate: " + data.heartRate);
  }
);

WEAR_DETECTION

once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback): void

监听佩戴检测传感器数据变化一次。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。
callback	Callback<[WearDetectionResponse]>	是	注册一次穿戴检测传感器的回调函数，上报的数据类型为WearDetectionResponse。

示例：

sensor.once(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, function(data) {
    console.info("Wear status: "+ data.value);
  }
);

sensor.off

ACCELEROMETER

off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.ACCELEROMETER, 该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<[AccelerometerResponse]>	是	取消注册加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。

示例：

function callback(data) {
    console.info('x-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback);

ACCELEROMETER_UNCALIBRATED

off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.ACCELEROMETER, 该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的未校准加速度计传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<[AccelerometerUncaliatedResponse]>	是	取消注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncaliatedResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback);

AMBIENT_LIGHT

off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<[LightResponse]>	是	取消注册环境光传感器的回调函数，上报的数据类型为LightResponse。

示例：

function callback(data) {
    console.info(' Illumination: ' + data.intensity);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback);

AMBIENT_TEMPERATURE

off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<[AmbientTemperatureResponse]>	是	取消注册环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。

示例：

function callback(data) {
     console.info('Temperature: ' + data.temperature);
}
sensor.off( sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback);

AMBIENT_TEMPERATURE

off(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。
callback	Callback<[BarometerResponse]>	是	取消注册气压计传感器的回调函数，上报的数据类型为BarometerResponse。

示例：

function callback(data) {
     console.info('Atmospheric pressure: ' + data.pressure);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, callback);

GRAVITY

off(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的重力传感器类型为SENSOR_TYPE_ID_GRAVITY。
callback	Callback<[GravityResponse]>	是	取消注册注册重力传感器的回调函数，上报的数据类型为GravityResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off( sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, callback);

GYROSCOPE

off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.GYROSCOPE, 该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<[GyroscopeResponse]>	是	取消注册陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback);

GYROSCOPE_UNCALIBRATED

off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.GYROSCOPE, 该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<[GyroscopeUncaliatedResponse]>	是	取消注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncaliatedResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback);

HALL

off(type: SensorType.SENSOR_TYPE_ID_HALL, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的霍尔传感器类型为SENSOR_TYPE_ID_HALL。
callback	Callback<[HallResponse]>	是	取消注册霍尔传感器的回调函数，上报的数据类型为 HallResponse。

示例：

function callback(data) {
    console.info('Status: ' + data.status);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_HALL, callback);

HEART_RATE

off(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.READ_HEALTH_DATA

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType][SensorType]	是	要取消订阅的心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<[HeartRateResponse]>	是	取消注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。

示例：

function callback(data) {
    console.info("Heart rate: " + data.heartRate);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_HEART_RATE, callback);

HUMIDITY

off(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<[HumidityResponse]>	是	取消注册湿度传感器的回调函数，上报的数据类型为HumidityResponse。

示例：

function callback(data) {
    console.info('Humidity: ' + data.humidity);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, callback);

LINEAR_ACCELERATION

off(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.ACCELEROMETER，该权限为系统权限

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<[LinearAccelerometerResponse]>	是	取消注册性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback);

MAGNETIC_FIELD

off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。
callbackcallback	Callback<[MagneticFieldResponse]>	是	取消注册磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback);

MAGNETIC_FIELD_UNCALIBRATED

off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<[MagneticFieldUncaliatedResponse]>	是	取消注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncaliatedResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('X-coordinate bias: ' + data.biasX);
    console.info('Y-coordinate bias: ' + data.biasY);
    console.info('Z-coordinate bias: ' + data.biasZ);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback);

ORIENTATION

off(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的方向传感器类型为SENSOR_TYPE_ID_ORIENTATION
callback	Callback<[OrientationResponse]>	是	取消注册方向传感器的回调函数，上报的数据类型为OrientationResponse。

示例：

function callback(data) {
    console.info('The device rotates at an angle around the X axis: ' + data.beta);
    console.info('The device rotates at an angle around the Y axis: ' + data.gamma);
    console.info('The device rotates at an angle around the Z axis: ' + data.alpha);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, callback);

PEDOMETER

off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<[PedometerResponse]>	是	取消注册计步传感器的回调函数，上报的数据类型为PedometerResponse。

示例：

function callback(data) {
    console.info('Steps: ' + data.steps);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, callback);

PEDOMETER_DETECTION

off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback?: Callback): void

取消订阅传感器数据。

需要权限 ：ohos.permission.ACTIVITY_MOTION

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<[PedometerDetectionResponse]>	是	取消注册计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。

示例：

function callback(data) {
    console.info('Scalar data: ' + data.scalar);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback);

PROXIMITY

off(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型	必填	说明
type	[SensorType]	是	要取消订阅的接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<[ProximityResponse]>	是	取消注册接近光传感器的回调函数，上报的数据类型为ProximityResponse。

示例：

function callback(data) {
    console.info('Distance: ' + data.distance);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, callback);

ROTATION_VECTOR

off(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback?: Callback): void

取消订阅传感器数据。

系统能力 ：SystemCapability.Sensors.Sensor

参数：

参数名	类型`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`	必填	说明
type	[SensorType]	是	要取消订阅的旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<[RotationVectorResponse]>	是	取消注册旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。

示例：

function callback(data) {
    console.info('X-coordinate component: ' + data.x);
    console.info('Y-coordinate component: ' + data.y);
    console.info('Z-coordinate component: ' + data.z);
    console.info('Scalar quantity: ' + data.w);
}
sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback);

审核编辑黄宇

打开APP阅读更多精彩内容