传感器
说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
导入模块
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<[AccelerometerUncalibratedResponse]> | 是 | 注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 |
| 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<[GyroscopeUncalibratedResponse]> | 是 | 注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 |
| 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<[MagneticFieldUncalibratedResponse]> | 是 | 注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 |
| 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<[AccelerometerUncalibratedResponse]> | 是 | 注册一次未校准加速度传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 |
示例：
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<[GyroscopeUncalibratedResponse]> | 是 | 注册一次未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 |
示例：
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<[MagneticFieldUncalibratedResponse]> | 是 | 注册一次未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 |
示例：
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<[AccelerometerUncalibratedResponse]> | 是 | 取消注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 |
示例：
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<[GyroscopeUncalibratedResponse]> | 是 | 取消注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 |
示例：
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<[MagneticFieldUncalibratedResponse]> | 是 | 取消注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 |
示例：
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
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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);
