js-apidiff-sensor.md

# 泛Sensor子系统JS API变更

OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，泛Sensor子系统的API变更如下:

## 接口变更

| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 |
|---|---|---|---|
| ohos.vibrator | VibratorStopMode | VIBRATOR_STOP_MODE_PRESET = "preset" | 新增 |
| ohos.vibrator | VibratorStopMode | VIBRATOR_STOP_MODE_TIME = "time" | 新增 |
| ohos.vibrator | EffectId | EFFECT_CLOCK_TIMER = "haptic.clock.timer" | 新增 |
| ohos.vibrator | vibrator | function stop(stopMode: VibratorStopMode): Promise<void>;<br>function stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void; | 新增 |
| ohos.vibrator | vibrator | function vibrate(duration: number, callback?: AsyncCallback<void>): void;<br>function vibrate(duration: number): Promise<void>;<br>function vibrate(effectId: EffectId): Promise<void>;<br>function vibrate(effectId: EffectId, callback?: AsyncCallback<void>): void; | 新增 |
| ohos.sensor | WearDetectionResponse | value: number; | 新增 |
| ohos.sensor | HeartRateResponse | heartRate: number; | 新增 |
| ohos.sensor | BarometerResponse | pressure: number; | 新增 |
| ohos.sensor | AmbientTemperatureResponse | temperature: number; | 新增 |
| ohos.sensor | PedometerDetectionResponse | scalar: number; | 新增 |
| ohos.sensor | HumidityResponse | humidity: number; | 新增 |
| ohos.sensor | PedometerResponse | steps: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | biasZ: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | biasY: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | biasX: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | z: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | y: number; | 新增 |
| ohos.sensor | MagneticFieldUncalibratedResponse | x: number; | 新增 |
| ohos.sensor | MagneticFieldResponse | z: number; | 新增 |
| ohos.sensor | MagneticFieldResponse | y: number; | 新增 |
| ohos.sensor | MagneticFieldResponse | x: number; | 新增 |
| ohos.sensor | HallResponse | status: number; | 新增 |
| ohos.sensor | LightResponse | intensity: number; | 新增 |
| ohos.sensor | ProximityResponse | distance: number; | 新增 |
| ohos.sensor | SignificantMotionResponse | scalar: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | biasZ: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | biasY: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | biasX: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | z: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | y: number; | 新增 |
| ohos.sensor | GyroscopeUncalibratedResponse | x: number; | 新增 |
| ohos.sensor | GyroscopeResponse | z: number; | 新增 |
| ohos.sensor | GyroscopeResponse | y: number; | 新增 |
| ohos.sensor | GyroscopeResponse | x: number; | 新增 |
| ohos.sensor | RotationVectorResponse | w: number; | 新增 |
| ohos.sensor | RotationVectorResponse | z: number; | 新增 |
| ohos.sensor | RotationVectorResponse | y: number; | 新增 |
| ohos.sensor | RotationVectorResponse | x: number; | 新增 |
| ohos.sensor | OrientationResponse | gamma: number; | 新增 |
| ohos.sensor | OrientationResponse | beta: number; | 新增 |
| ohos.sensor | OrientationResponse | alpha: number; | 新增 |
| ohos.sensor | GravityResponse | z: number; | 新增 |
| ohos.sensor | GravityResponse | y: number; | 新增 |
| ohos.sensor | GravityResponse | x: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | biasZ: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | biasY: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | biasX: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | z: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | y: number; | 新增 |
| ohos.sensor | AccelerometerUncalibratedResponse | x: number; | 新增 |
| ohos.sensor | LinearAccelerometerResponse | z: number; | 新增 |
| ohos.sensor | LinearAccelerometerResponse | y: number; | 新增 |
| ohos.sensor | LinearAccelerometerResponse | x: number; | 新增 |
| ohos.sensor | AccelerometerResponse | z: number; | 新增 |
| ohos.sensor | AccelerometerResponse | y: number; | 新增 |
| ohos.sensor | AccelerometerResponse | x: number; | 新增 |
| ohos.sensor | Response | timestamp: number; | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED = 281 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_WEAR_DETECTION = 280 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_HEART_RATE = 278 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_PEDOMETER = 266 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_PEDOMETER_DETECTION = 265 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_SIGNIFICANT_MOTION = 264 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED = 263 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED = 261 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_AMBIENT_TEMPERATURE = 260 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_ROTATION_VECTOR = 259 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_LINEAR_ACCELERATION = 258 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_GRAVITY = 257 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_ORIENTATION = 256 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_HUMIDITY = 13 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_PROXIMITY = 12 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_HALL = 10 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_BAROMETER = 8 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_MAGNETIC_FIELD = 6 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_AMBIENT_LIGHT = 5 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_GYROSCOPE = 2 | 新增 |
| ohos.sensor | SensorType | SENSOR_TYPE_ID_ACCELEROMETER = 1 | 新增 |
| ohos.sensor | Options | interval?: number; | 新增 |
| ohos.sensor | RotationMatrixResponse | inclination: Array<number> | 新增 |
| ohos.sensor | RotationMatrixResponse | rotation: Array<number>; | 新增 |
| ohos.sensor | sensor | function getDirection(rotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void;<br>function getDirection(rotationMatrix: Array<number>): Promise<Array<number>>; | 新增 |
| ohos.sensor | sensor | function createQuaternion(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void;<br>function createQuaternion(rotationVector: Array<number>): Promise<Array<number>>; | 新增 |
| ohos.sensor | sensor | function transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions, callback: AsyncCallback<Array<number>>): void;<br>function transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions): Promise<Array<number>>; | 新增 |
| ohos.sensor | CoordinatesOptions | y: number; | 新增 |
| ohos.sensor | CoordinatesOptions | x: number; | 新增 |
| ohos.sensor | sensor | function createRotationMatrix(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void;<br>function createRotationMatrix(rotationVector: Array<number>): Promise<Array<number>>;<br>function createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>, callback: AsyncCallback<RotationMatrixResponse>): void;<br>function createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>,): Promise<RotationMatrixResponse>; | 新增 |
| ohos.sensor | sensor | function getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void;<br>function getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>): Promise<Array<number>>;| 新增 |
| ohos.sensor | sensor | function getGeomagneticDip(inclinationMatrix: Array<number>, callback: AsyncCallback<number>): void;<br>function getGeomagneticDip(inclinationMatrix: Array<number>): Promise<number>; | 新增 |
| ohos.sensor | sensor | function getAltitude(seaPressure: number, currentPressure: number, callback: AsyncCallback<number>): void;<br>function getAltitude(seaPressure: number, currentPressure: number): Promise<number>; | 新增 |
| ohos.sensor | sensor | function getGeomagneticField(locationOptions: LocationOptions, timeMillis: number, callback: AsyncCallback<GeomagneticResponse>): void;<br>function getGeomagneticField(locationOptions: LocationOptions, timeMillis: number): Promise<GeomagneticResponse>; | 新增 |
| ohos.sensor | GeomagneticResponse | totalIntensity: number; | 新增 |
| ohos.sensor | GeomagneticResponse | levelIntensity: number; | 新增 |
| ohos.sensor | GeomagneticResponse | deflectionAngle: number; | 新增 |
| ohos.sensor | GeomagneticResponse | geomagneticDip: number; | 新增 |
| ohos.sensor | GeomagneticResponse | z: number; | 新增 |
| ohos.sensor | GeomagneticResponse | y: number; | 新增 |
| ohos.sensor | GeomagneticResponse | x: number; | 新增 |
| ohos.sensor | LocationOptions | altitude: number; | 新增 |
| ohos.sensor | LocationOptions | longitude: number; | 新增 |
| ohos.sensor | LocationOptions | latitude: number; | 新增 |
| ohos.sensor | sensor | function off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback?: Callback<AccelerometerResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback?: Callback<AccelerometerUncalibratedResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback?: Callback<LightResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback?: Callback<AmbientTemperatureResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback?: Callback<BarometerResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback?: Callback<GravityResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback?: Callback<GyroscopeResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback?: Callback<GyroscopeUncalibratedResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_HALL, callback?: Callback<HallResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback?: Callback<HeartRateResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback?: Callback<HumidityResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback?: Callback<LinearAccelerometerResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback?: Callback<MagneticFieldResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback?: Callback<MagneticFieldUncalibratedResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback?: Callback<OrientationResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback?: Callback<PedometerResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback?: Callback<PedometerDetectionResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback?: Callback<ProximityResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback?: Callback<RotationVectorResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback?: Callback<SignificantMotionResponse>): void;<br>function off(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback?: Callback<WearDetectionResponse>): void;| 新增 |
| ohos.sensor | sensor | function once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<AccelerometerResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback<LightResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback<GravityResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback<HallResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback<HeartRateResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback<HumidityResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback: Callback<LinearAccelerometerResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback<OrientationResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback<PedometerResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback<ProximityResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: Callback<RotationVectorResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>): void;<br>function once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback<WearDetectionResponse>): void; | 新增 |
| ohos.sensor | sensor | function on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<AccelerometerResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback<LightResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback<GravityResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback<HallResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback<HeartRateResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback<HumidityResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback: Callback<LinearAccelerometerResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback<OrientationResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback<PedometerResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback<ProximityResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: Callback<RotationVectorResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>, options?: Options): void;<br>function on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback<WearDetectionResponse>, options?: Options): void; | 新增 |