sensor模塊提供了獲取傳感器數(shù)據(jù)的能力，包括獲取傳感器屬性列表，訂閱傳感器數(shù)據(jù)，以及一些通用的傳感器算法。

說明

本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import sensor from '@ohos.sensor';

sensor.on9+

ACCELEROMETER9+

on(type: SensorId.ACCELEROMETER, callback: Callback<AccelerometerResponse>,options?: Options): void

訂閱加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER	是	傳感器類型，該值固定為SensorId.ACCELEROMETER。
callback	Callback<AccelerometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AccelerometerResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ACCELEROMETER_UNCALIBRATED9+

on(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>,options?: Options): void

訂閱未校準加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AccelerometerUncalibratedResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_LIGHT9+

on(type: SensorId.AMBIENT_LIGHT, callback: Callback<LightResponse>, options?: Options): void

訂閱環(huán)境光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_LIGHT	是	傳感器類型，該值固定為SensorId.AMBIENT_LIGHT。
callback	Callback<LightResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為LightResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.AMBIENT_LIGHT, function (data) {
        console.info('The ambient light intensity: ' + data.intensity);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_TEMPERATURE9+

on(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>,options?: Options): void

訂閱溫度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_TEMPERATURE	是	傳感器類型，該值固定為SensorId.AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AmbientTemperatureResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, function (data) {
        console.info('Temperature: ' + data.temperature);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

BAROMETER9+

on(type: SensorId.BAROMETER, callback: Callback<BarometerResponse>, options?: Options): void

訂閱氣壓計傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.BAROMETER	是	傳感器類型，該值固定為SensorId.BAROMETER。
callback	Callback<BarometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為BarometerResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.BAROMETER, function (data) {
        console.info('Atmospheric pressure: ' + data.pressure);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GRAVITY9+

on(type: SensorId.GRAVITY, callback: Callback<GravityResponse>,options?: Options): void

訂閱重力傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GRAVITY	是	傳感器類型，該值固定為SensorId.GRAVITY。
callback	Callback<GravityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GravityResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE9+

on(type: SensorId.GYROSCOPE, callback: Callback<GyroscopeResponse>,options?: Options): void

訂閱校準的陀螺儀傳感器數(shù)據(jù)。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE	是	傳感器類型，該值固定為SensorId.GYROSCOPE。
callback	Callback<GyroscopeResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GyroscopeResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE_UNCALIBRATED9+

on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>,

options?: Options): void

訂閱未校準陀螺儀傳感器數(shù)據(jù)

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GyroscopeUncalibratedResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HALL9+

on(type: SensorId.HALL, callback: Callback<HallResponse>, options?: Options): void

訂閱霍爾傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HALL	是	傳感器類型，該值固定為SensorId.HALL。
callback	Callback<HallResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HallResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.HALL, function (data) {
        console.info('Hall status: ' + data.status);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HEART_RATE9+

on(type: SensorId.HEART_RATE, callback: Callback<HeartRateResponse>,options?: Options): void

訂閱心率傳感器數(shù)據(jù)。

需要權限：ohos.permission.READ_HEALTH_DATA

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HEART_RATE	是	傳感器類型，該值固定為SensorId.HEART_RATE。
callback	Callback<HeartRateResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HeartRateResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.HEART_RATE, function (data) {
        console.info('Heart rate: ' + data.heartRate);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HUMIDITY9+

on(type: SensorId.HUMIDITY, callback: Callback<HumidityResponse>,options?: Options): void

訂閱濕度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HUMIDITY	是	傳感器類型，該值固定為SensorId.HUMIDITY。
callback	Callback<HumidityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HumidityResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.HUMIDITY, function (data) {
        console.info('Humidity: ' + data.humidity);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

LINEAR_ACCELEROMETER9+

on(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback<LinearAccelerometerResponse>,

options?: Options): void

訂閱線性加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.LINEAR_ACCELEROMETER	是	傳感器類型，該值固定為SensorId.LINEAR_ACCELEROMETER。
callback	Callback<LinearAccelerometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為LinearAccelerometerResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.LINEAR_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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD9+

on(type: SensorId.MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>,options?: Options): void

訂閱地磁傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD。
callback	Callback<MagneticFieldResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為MagneticFieldResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD_UNCALIBRATED9+

on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>, options?: Options): void

訂閱未校準地磁傳感器數(shù)據(jù)

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為MagneticFieldUncalibratedResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ORIENTATION9+

on(type: SensorId.ORIENTATION, callback: Callback<OrientationResponse>,options?: Options): void

訂閱方向傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ORIENTATION	是	傳感器類型，該值固定為SensorId.ORIENTATION。
callback	Callback<OrientationResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為OrientationResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

示例：

try {
    sensor.on(sensor.SensorId.ORIENTATION, function (data) {
        console.info('The device rotates at an angle around the Z axis: ' + data.alpha);
        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);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER9+

on(type: SensorId.PEDOMETER, callback: Callback<PedometerResponse>, options?: Options): void

訂閱計步器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER	是	傳感器類型，該值固定為SensorId.PEDOMETER。
callback	Callback<PedometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為PedometerResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

示例：

try {
    sensor.on(sensor.SensorId.PEDOMETER, function (data) {
        console.info('Step count: ' + data.steps);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER_DETECTION9+

on(type: SensorId.PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>,

options?: Options): void

訂閱計步檢測器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER_DETECTION	是	傳感器類型，該值固定為SensorId.PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為PedometerDetectionResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.PEDOMETER_DETECTION, function (data) {
        console.info('Pedometer scalar: ' + data.scalar);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PROXIMITY9+

on(type: SensorId.PROXIMITY, callback: Callback<ProximityResponse>, options?: Options): void

訂閱接近光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PROXIMITY	是	傳感器類型，該值固定為SensorId.PROXIMITY。
callback	Callback<ProximityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為ProximityResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.PROXIMITY, function (data) {
        console.info('Distance: ' + data.distance);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ROTATION_VECTOR9+

on(type: SensorId.ROTATION_VECTOR, callback: Callback<RotationVectorResponse>,

options?: Options): void

訂閱旋轉(zhuǎn)矢量傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ROTATION_VECTOR	是	傳感器類型，該值固定為SensorId.ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為RotationVectorResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.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 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

SIGNIFICANT_MOTION9+

on(type: SensorId.SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>,

options?: Options): void

訂閱大幅動作檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.SIGNIFICANT_MOTION	是	傳感器類型，該值固定為SensorId.SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為SignificantMotionResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, function (data) {
        console.info('Scalar data: ' + data.scalar);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

WEAR_DETECTION9+

on(type: SensorId.WEAR_DETECTION, callback: Callback<WearDetectionResponse>,

options?: Options): void

訂閱佩戴檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.WEAR_DETECTION	是	傳感器類型，該值固定為SensorId.WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為WearDetectionResponse。
options	Options	否	設置上報頻率，默認值為200000000ns。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.on(sensor.SensorId.WEAR_DETECTION, function (data) {
        console.info('Wear status: ' + data.value);
    }, { interval: 10000000 });
} catch (err) {
    console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

sensor.once9+

ACCELEROMETER9+

once(type: SensorId.ACCELEROMETER, callback: Callback<AccelerometerResponse>): void

獲取一次加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER	是	傳感器類型，該值固定為SensorId.ACCELEROMETER。
callback	Callback<AccelerometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AccelerometerResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.ACCELEROMETER, function (data) {
        console.info('X-coordinate component: ' + data.x);
        console.info('Y-coordinate component: ' + data.y);
        console.info('Z-coordinate component: ' + data.z);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ACCELEROMETER_UNCALIBRATED9+

once(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>): void

獲取一次未校準加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AccelerometerUncalibratedResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_LIGHT9+

once(type: SensorId.AMBIENT_LIGHT, callback: Callback<LightResponse>): void

獲取一次環(huán)境光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_LIGHT	是	傳感器類型，該值固定為SensorId.AMBIENT_LIGHT。
callback	Callback<LightResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為LightResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.AMBIENT_LIGHT, function (data) {
        console.info('The ambient light intensity: ' + data.intensity);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_TEMPERATURE9+

once(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>): void

獲取一次溫度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_TEMPERATURE	是	傳感器類型，該值固定為SensorId.AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為AmbientTemperatureResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.AMBIENT_TEMPERATURE, function (data) {
        console.info('Temperature: ' + data.temperature);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

BAROMETER9+

once(type: SensorId.BAROMETER, callback: Callback<BarometerResponse>): void

獲取一次氣壓計傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.BAROMETER	是	傳感器類型，該值固定為SensorId.BAROMETER。
callback	Callback<BarometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為BarometerResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function (data) {
        console.info('Atmospheric pressure: ' + data.pressure);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GRAVITY9+

once(type: SensorId.GRAVITY, callback: Callback<GravityResponse>): void

獲取一次重力傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GRAVITY	是	傳感器類型，該值固定為SensorId.GRAVITY。
callback	Callback<GravityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GravityResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.GRAVITY, function (data) {
        console.info('X-coordinate component: ' + data.x);
        console.info('Y-coordinate component: ' + data.y);
        console.info('Z-coordinate component: ' + data.z);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE9+

once(type: SensorId.GYROSCOPE, callback: Callback<GyroscopeResponse>): void

獲取一次陀螺儀傳感器數(shù)據(jù)。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE	是	傳感器類型，該值固定為SensorId.GYROSCOPE。
callback	Callback<GyroscopeResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GyroscopeResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.GYROSCOPE, function (data) {
        console.info('X-coordinate component: ' + data.x);
        console.info('Y-coordinate component: ' + data.y);
        console.info('Z-coordinate component: ' + data.z);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE_UNCALIBRATED9+

once(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>): void

獲取一次未校準陀螺儀傳感器數(shù)據(jù)。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為GyroscopeUncalibratedResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HALL9+

once(type: SensorId.HALL, callback: Callback<HallResponse>): void

獲取霍爾傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HALL	是	傳感器類型，該值固定為SensorId.HALL。
callback	Callback<HallResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HallResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.HALL, function (data) {
        console.info('Status: ' + data.status);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HEART_RATE9+

once(type: SensorId.HEART_RATE, callback: Callback<HeartRateResponse>): void

獲取一次心率傳感器數(shù)據(jù)。

需要權限：ohos.permission.READ_HEALTH_DATA

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HEART_RATE	是	傳感器類型，該值固定為SensorId.HEART_RATE。
callback	Callback<HeartRateResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HeartRateResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.HEART_RATE, function (data) {
        console.info('Heart rate: ' + data.heartRate);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HUMIDITY9+

once(type: SensorId.HUMIDITY, callback: Callback<HumidityResponse>): void

獲取一次濕度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HUMIDITY	是	傳感器類型，該值固定為SensorId.HUMIDITY。
callback	Callback<HumidityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為HumidityResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.HUMIDITY, function (data) {
        console.info('Humidity: ' + data.humidity);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

LINEAR_ACCELEROMETER9+

once(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback<LinearAccelerometerResponse>): void

獲取一次線性加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.LINEAR_ACCELEROMETER	是	傳感器類型，該值固定為SensorId.LINEAR_ACCELEROMETER。
callback	Callback<LinearAccelerometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為LinearAccelerometerResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.LINEAR_ACCELEROMETER, function (data) {
        console.info('X-coordinate component: ' + data.x);
        console.info('Y-coordinate component: ' + data.y);
        console.info('Z-coordinate component: ' + data.z);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD9+

once(type: SensorId.MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>): void

獲取一次磁場傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD。
callback	Callback<MagneticFieldResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為MagneticFieldResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD_UNCALIBRATED9+

once(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>): void

獲取一次未經(jīng)校準的磁場傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為MagneticFieldUncalibratedResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ORIENTATION9+

once(type: SensorId.ORIENTATION, callback: Callback<OrientationResponse>): void

獲取一次方向傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ORIENTATION	是	傳感器類型，該值固定為SensorId.ORIENTATION。
callback	Callback<OrientationResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為OrientationResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER9+

once(type: SensorId.PEDOMETER, callback: Callback<PedometerResponse>): void

獲取一次計步器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER	是	傳感器類型，該值固定為SensorId.PEDOMETER。
callback	Callback<PedometerResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為PedometerResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.PEDOMETER, function (data) {
        console.info('Step count: ' + data.steps);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER_DETECTION9+

once(type: SensorId.PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>): void

獲取一次計步檢測器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER_DETECTION	是	傳感器類型，該值固定為SensorId.PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為PedometerDetectionResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.PEDOMETER_DETECTION, function (data) {
        console.info('Scalar data: ' + data.scalar);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PROXIMITY9+

once(type: SensorId.PROXIMITY, callback: Callback<ProximityResponse>): void

獲取一次接近光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PROXIMITY	是	傳感器類型，該值固定為SensorId.PROXIMITY。
callback	Callback<ProximityResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為ProximityResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.PROXIMITY, function (data) {
        console.info('Distance: ' + data.distance);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ROTATION_VECTOR9+

once(type: SensorId.ROTATION_VECTOR, callback: Callback<RotationVectorResponse>): void

獲取一次旋轉(zhuǎn)矢量傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ROTATION_VECTOR	是	傳感器類型，該值固定為SensorId.ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為RotationVectorResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.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);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

SIGNIFICANT_MOTION9+

once(type: SensorId.SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>): void

獲取一次大幅動作檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.SIGNIFICANT_MOTION	是	傳感器類型，該值固定為SensorId.SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為SignificantMotionResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.SIGNIFICANT_MOTION, function (data) {
        console.info('Scalar data: ' + data.scalar);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

WEAR_DETECTION9+

once(type: SensorId.WEAR_DETECTION, callback: Callback<WearDetectionResponse>): void

獲取一次佩戴檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.WEAR_DETECTION	是	傳感器類型，該值固定為SensorId.WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	是	回調(diào)函數(shù)，異步上報的傳感器數(shù)據(jù)固定為WearDetectionResponse。

錯誤碼：

以下錯誤碼的詳細介紹請參見 ohos.sensor(傳感器)錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.once(sensor.SensorId.WEAR_DETECTION, function (data) {
        console.info("Wear status: " + data.value);
    });
} catch (err) {
    console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

sensor.off9+

ACCELEROMETER9+

off(type: SensorId.ACCELEROMETER, callback?: Callback<AccelerometerResponse>): void

取消訂閱加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER	是	傳感器類型，該值固定為SensorId.ACCELEROMETER。
callback	Callback<AccelerometerResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.ACCELEROMETER, callback1);
    sensor.on(sensor.SensorId.ACCELEROMETER, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.ACCELEROMETER, callback1);
    // 取消SensorId.ACCELEROMETER類型的所有回調(diào)
    sensor.off(sensor.SensorId.ACCELEROMETER);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ACCELEROMETER_UNCALIBRATED9+

off(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback?: Callback<AccelerometerUncalibratedResponse>): void

取消訂閱未校準加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ACCELEROMETER_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback1);
    sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback1);
    // 取消注冊SensorId.ACCELEROMETER_UNCALIBRATED類型的所有回調(diào)
    sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_LIGHT9+

off(type: SensorId.AMBIENT_LIGHT, callback?: Callback<LightResponse>): void

取消訂閱環(huán)境光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_LIGHT	是	傳感器類型，該值固定為SensorId.AMBIENT_LIGHT。
callback	Callback<LightResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.AMBIENT_LIGHT, callback1);
    sensor.on(sensor.SensorId.AMBIENT_LIGHT, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.AMBIENT_LIGHT, callback1);
    // 取消注冊SensorId.AMBIENT_LIGHT的所有回調(diào)
    sensor.off(sensor.SensorId.AMBIENT_LIGHT);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

AMBIENT_TEMPERATURE9+

off(type: SensorId.AMBIENT_TEMPERATURE, callback?: Callback<AmbientTemperatureResponse>): void

取消訂閱溫度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.AMBIENT_TEMPERATURE	是	傳感器類型，該值固定為SensorId.AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, callback1);
    sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.AMBIENT_TEMPERATURE, callback1);
    // 取消注冊SensorId.AMBIENT_TEMPERATURE的所有回調(diào)
    sensor.off(sensor.SensorId.AMBIENT_TEMPERATURE);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

BAROMETER9+

off(type: SensorId.BAROMETER, callback?: Callback<BarometerResponse>): void

取消訂閱氣壓計傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.BAROMETER	是	傳感器類型，該值固定為SensorId.BAROMETER。
callback	Callback<BarometerResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.BAROMETER, callback1);
    sensor.on(sensor.SensorId.BAROMETER, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.BAROMETER, callback1);
    // 取消注冊SensorId.BAROMETER的所有回調(diào)
    sensor.off(sensor.SensorId.BAROMETER);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GRAVITY9+

off(type: SensorId.GRAVITY, callback?: Callback<GravityResponse>): void

取消訂閱重力傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GRAVITY	是	傳感器類型，該值固定為SensorId.GRAVITY。
callback	Callback<GravityResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.GRAVITY, callback1);
    sensor.on(sensor.SensorId.GRAVITY, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.GRAVITY, callback1);
    // 取消注冊SensorId.GRAVITY的所有回調(diào)
    sensor.off(sensor.SensorId.GRAVITY);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE9+

off(type: SensorId.GYROSCOPE, callback?: Callback<GyroscopeResponse>): void

取消訂閱陀螺儀傳感器數(shù)據(jù)。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE	是	傳感器類型，該值固定為SensorId.GYROSCOPE。
callback	Callback<GyroscopeResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.GYROSCOPE, callback1);
    sensor.on(sensor.SensorId.GYROSCOPE, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.GYROSCOPE, callback1);
    // 取消注冊SensorId.GYROSCOPE的所有回調(diào)
    sensor.off(sensor.SensorId.GYROSCOPE);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

GYROSCOPE_UNCALIBRATED9+

off(type: SensorId.GYROSCOPE_UNCALIBRATED, callback?: Callback<GyroscopeUncalibratedResponse>): void

取消訂閱未校準陀螺儀傳感器數(shù)據(jù)。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.GYROSCOPE_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback1);
    sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback1);
    // 取消注冊SensorId.GYROSCOPE_UNCALIBRATED的所有回調(diào)
    sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HALL9+

off(type: SensorId.HALL, callback?: Callback<HallResponse>): void

取消訂閱霍爾傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HALL	是	傳感器類型，該值固定為SensorId.HALL。
callback	Callback<HallResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.HALL, callback1);
    sensor.on(sensor.SensorId.HALL, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.HALL, callback1);
    // 取消注冊SensorId.HALL的所有回調(diào)
    sensor.off(sensor.SensorId.HALL);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HEART_RATE9+

off(type: SensorId.HEART_RATE, callback?: Callback<HeartRateResponse>): void

取消訂閱心率傳感器數(shù)據(jù)。

需要權限：ohos.permission.READ_HEALTH_DATA

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HEART_RATE	是	傳感器類型，該值固定為SensorId.HEART_RATE。
callback	Callback<HeartRateResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.HEART_RATE, callback1);
    sensor.on(sensor.SensorId.HEART_RATE, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.HEART_RATE, callback1);
    // 取消注冊SensorId.HEART_RATE的所有回調(diào)
    sensor.off(sensor.SensorId.HEART_RATE);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

HUMIDITY9+

off(type: SensorId.HUMIDITY, callback?: Callback<HumidityResponse>): void

取消訂閱濕度傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.HUMIDITY	是	傳感器類型，該值固定為SensorId.HUMIDITY。
callback	Callback<HumidityResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.HUMIDITY, callback1);
    sensor.on(sensor.SensorId.HUMIDITY, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.HUMIDITY, callback1);
    // 取消注冊SensorId.HUMIDITY的所有回調(diào)
    sensor.off(sensor.SensorId.HUMIDITY);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

LINEAR_ACCELEROMETER9+

off(type: SensorId.LINEAR_ACCELEROMETER, callback?: Callback<LinearAccelerometerResponse>): void

取消訂閱線性加速度傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.LINEAR_ACCELEROMETER	是	傳感器類型，該值固定為SensorId.LINEAR_ACCELERATION。
callback	Callback<LinearAccelerometerResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, callback1);
    sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER, callback1);
    // 取消注冊SensorId.LINEAR_ACCELEROMETER的所有回調(diào)
    sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD9+

off(type: SensorId.MAGNETIC_FIELD, callback?: Callback<MagneticFieldResponse>): void

取消訂閱磁場傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD。
callback	Callback<MagneticFieldResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.MAGNETIC_FIELD, callback1);
    sensor.on(sensor.SensorId.MAGNETIC_FIELD, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.MAGNETIC_FIELD, callback1);
    // 取消注冊SensorId.MAGNETIC_FIELD的所有回調(diào)
    sensor.off(sensor.SensorId.MAGNETIC_FIELD);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

MAGNETIC_FIELD_UNCALIBRATED9+

off(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback?: Callback<MagneticFieldUncalibratedResponse>): void

取消訂閱未校準的磁場傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.MAGNETIC_FIELD_UNCALIBRATED	是	傳感器類型，該值固定為SensorId.MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback1);
    sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback1);
    // 取消注冊SensorId.MAGNETIC_FIELD_UNCALIBRATED的所有回調(diào)
    sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ORIENTATION9+

off(type: SensorId.ORIENTATION, callback?: Callback<OrientationResponse>): void

取消訂閱方向傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ORIENTATION	是	傳感器類型，該值固定為SensorId.ORIENTATION。
callback	Callback<OrientationResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.ORIENTATION, callback1);
    sensor.on(sensor.SensorId.ORIENTATION, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.ORIENTATION, callback1);
    // 取消注冊SensorId.ORIENTATION的所有回調(diào)
    sensor.off(sensor.SensorId.ORIENTATION);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER9+

off(type: SensorId.PEDOMETER, callback?: Callback<PedometerResponse>): void

取消訂閱計步器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER	是	傳感器類型，該值固定為SensorId.PEDOMETER。
callback	Callback<PedometerResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.PEDOMETER, callback1);
    sensor.on(sensor.SensorId.PEDOMETER, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.PEDOMETER, callback1);
    // 取消注冊SensorId.PEDOMETER的所有回調(diào)
    sensor.off(sensor.SensorId.PEDOMETER);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PEDOMETER_DETECTION9+

off(type: SensorId.PEDOMETER_DETECTION, callback?: Callback<PedometerDetectionResponse>): void

取消訂閱計步檢測器傳感器數(shù)據(jù)。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PEDOMETER_DETECTION	是	傳感器類型，該值固定為SensorId.PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.PEDOMETER_DETECTION, callback1);
    sensor.on(sensor.SensorId.PEDOMETER_DETECTION, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.PEDOMETER_DETECTION, callback1);
    // 取消注冊SensorId.PEDOMETER_DETECTION的所有回調(diào)
    sensor.off(sensor.SensorId.PEDOMETER_DETECTION);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

PROXIMITY9+

off(type: SensorId.PROXIMITY, callback?: Callback<ProximityResponse>): void

取消訂閱接近光傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.PROXIMITY	是	傳感器類型，該值固定為SensorId.PROXIMITY。
callback	Callback<ProximityResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.PROXIMITY, callback1);
    sensor.on(sensor.SensorId.PROXIMITY, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.PROXIMITY, callback1);
    // 取消注冊SensorId.PROXIMITY的所有回調(diào)
    sensor.off(sensor.SensorId.PROXIMITY);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

ROTATION_VECTOR9+

off(type: SensorId.ROTATION_VECTOR, callback?: Callback<RotationVectorResponse>): void

取消訂閱旋轉(zhuǎn)矢量傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.ROTATION_VECTOR	是	傳感器類型，該值固定為SensorId.ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.ROTATION_VECTOR, callback1);
    sensor.on(sensor.SensorId.ROTATION_VECTOR, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.ROTATION_VECTOR, callback1);
    // 取消注冊SensorId.ROTATION_VECTOR的所有回調(diào)
    sensor.off(sensor.SensorId.ROTATION_VECTOR);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

SIGNIFICANT_MOTION9+

off(type: SensorId.SIGNIFICANT_MOTION, callback?: Callback<SignificantMotionResponse>): void

取消大幅動作檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.SIGNIFICANT_MOTION	是	傳感器類型，該值固定為SensorId.SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, callback1);
    sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.SIGNIFICANT_MOTION, callback1);
    // 取消注冊SensorId.SIGNIFICANT_MOTION的所有回調(diào)
    sensor.off(sensor.SensorId.SIGNIFICANT_MOTION);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

WEAR_DETECTION9+

off(type: SensorId.WEAR_DETECTION, callback?: Callback<WearDetectionResponse>): void

取消訂閱佩戴檢測傳感器數(shù)據(jù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId.WEAR_DETECTION	是	傳感器類型，該值固定為SensorId.WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	否	需要取消訂閱的回調(diào)函數(shù)，若無此參數(shù)，則取消訂閱當前類型的所有回調(diào)函數(shù)。

示例：

function callback1(data) {
    console.info('Callback1 data: ' + JSON.stringify(data));
}
function callback2(data) {
    console.info('Callback2 data: ' + JSON.stringify(data));
}
try {
    sensor.on(sensor.SensorId.WEAR_DETECTION, callback1);
    sensor.on(sensor.SensorId.WEAR_DETECTION, callback2);
    // 僅取消callback1的注冊
    sensor.off(sensor.SensorId.WEAR_DETECTION, callback1);
    // 取消注冊SensorId.WEAR_DETECTION的所有回調(diào)
    sensor.off(sensor.SensorId.WEAR_DETECTION);
} catch (err) {
    console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}

sensor.getGeomagneticInfo9+

getGeomagneticInfo(locationOptions: LocationOptions, timeMillis: number, callback: AsyncCallback<GeomagneticResponse>): void

獲取某時刻地球上特定位置的地磁場信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
locationOptions	LocationOptions	是	地理位置，包括經(jīng)度、緯度和海拔高度。
timeMillis	number	是	獲取磁偏角的時間，unix時間戳，單位毫秒。
callback	AsyncCallback<GeomagneticResponse>	是	回調(diào)函數(shù)，返回地磁場信息。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getGeomagneticInfo錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.getGeomagneticInfo({ latitude: 80, longitude: 0, altitude: 0 }, 1580486400000, function (err, data) {
        if (err) {
            console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        console.info("GeomagneticInfo x" + data.x);
        console.info("GeomagneticInfo y" + data.y);
        console.info("GeomagneticInfo z" + data.z);
        console.info("GeomagneticInfo geomagneticDip" + data.geomagneticDip);
        console.info("GeomagneticInfo deflectionAngle" + data.deflectionAngle);
        console.info("GeomagneticInfo levelIntensity" + data.levelIntensity);
        console.info("GeomagneticInfo totalIntensity" + data.totalIntensity);
    });
} catch (err) {
    console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getGeomagneticInfo9+

getGeomagneticInfo(locationOptions: LocationOptions, timeMillis: number): Promise<GeomagneticResponse>

獲取某時刻地球上特定位置的地磁場信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
locationOptions	LocationOptions	是	地理位置，包括經(jīng)度、緯度和海拔高度。
timeMillis	number	是	獲取磁偏角的時間，unix時間戳，單位毫秒。

返回值：

類型	說明
Promise<GeomagneticResponse>	Promise對象，返回地磁場信息。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getGeomagneticInfo錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    const promise = sensor.getGeomagneticInfo({ latitude: 80, longitude: 0, altitude: 0 }, 1580486400000);
    promise.then((data) => {
        console.info("GeomagneticInfo x" + data.x);
        console.info("GeomagneticInfo y" + data.y);
        console.info("GeomagneticInfo z" + data.z);
        console.info("GeomagneticInfo geomagneticDip" + data.geomagneticDip);
        console.info("GeomagneticInfo deflectionAngle" + data.deflectionAngle);
        console.info("GeomagneticInfo levelIntensity" + data.levelIntensity);
        console.info("GeomagneticInfo totalIntensity" + data.totalIntensity);
    }, (err)=>{
        console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get geomagneticInfo. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getDeviceAltitude9+

getDeviceAltitude(seaPressure: number, currentPressure: number, callback: AsyncCallback<number>): void

根據(jù)氣壓值獲取海拔高度。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
seaPressure	number	是	海平面氣壓值，單位為hPa。
currentPressure	number	是	指定的氣壓值，單位為hPa。
callback	AsyncCallback<number>	是	回調(diào)函數(shù)，返回指定的氣壓值對應的海拔高度，單位為米。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getDeviceAltitude錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let seaPressure = 1013.2;
    let currentPressure = 1500.0;
    sensor.getDeviceAltitude(seaPressure, currentPressure, function (err, data) {
        if (err) {
            console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        console.info('altitude: ' + data);
    });
} catch (err) {
    console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getDeviceAltitude9+

getDeviceAltitude(seaPressure: number, currentPressure: number): Promise<number>

根據(jù)氣壓值獲取海拔高度。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
seaPressure	number	是	海平面氣壓值，單位為hPa。
currentPressure	number	是	指定的氣壓值，單位為hPa。

返回值：

類型	說明
Promise<number>	Promise對象，返回指定的氣壓值對應的海拔高度，單位為米。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getDeviceAltitude錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let seaPressure = 1013.2;
    let currentPressure = 1500.0;
    const promise = sensor.getDeviceAltitude(seaPressure, currentPressure);
    promise.then((data) => {
        console.info('sensor_getDeviceAltitude_Promise success', data);
    }, (err) => {
        console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getInclination9+

getInclination(inclinationMatrix: Array<number>, callback: AsyncCallback<number>): void

根據(jù)傾斜矩陣計算地磁傾角。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inclinationMatrix	Array<number>	是	傾斜矩陣。
callback	AsyncCallback<number>	是	回調(diào)函數(shù)，返回地磁傾角，單位為弧度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getInclination錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    // inclinationMatrix可以為3*3，或者4*4
    let inclinationMatrix = [
        1, 0, 0,
        0, 1, 0,
        0, 0, 1
    ]
    sensor.getInclination(inclinationMatrix, function (err, data) {
        if (err) {
            console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        console.info('Inclination: ' + data);
    })
} catch (err) {
    console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getInclination9+

getInclination(inclinationMatrix: Array<number>): Promise<number>

根據(jù)傾斜矩陣計算地磁傾角。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inclinationMatrix	Array<number>	是	傾斜矩陣。

返回值：

類型	說明
Promise<number>	Promise對象，返回地磁傾斜角，單位為弧度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getInclination錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    // inclinationMatrix可以為3*3，或者4*4
    let inclinationMatrix = [
        1, 0, 0,
        0, 1, 0,
        0, 0, 1
    ]
    const promise = sensor.getInclination(inclinationMatrix);
    promise.then((data) => {
        console.info('Inclination: ' + data);
    }, (err) => {
        console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getAngleVariation9+

getAngleVariation(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>,

callback: AsyncCallback<Array<number>>): void

計算兩個旋轉(zhuǎn)矩陣之間的角度變化。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
currentRotationMatrix	Array<number>	是	當前旋轉(zhuǎn)矩陣。
preRotationMatrix	Array<number>	是	相對旋轉(zhuǎn)矩陣。
callback	AsyncCallback<Array<number>>	是	回調(diào)函數(shù)，返回繞z、x、y軸方向的旋轉(zhuǎn)角度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getAngleVariation錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    // 旋轉(zhuǎn)矩陣可以為3*3，或者4*4
    let currentRotationMatrix = [
        1, 0, 0,
        0, 1, 0,
        0, 0, 1
    ];
    let preRotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    sensor.getAngleVariation(currentRotationMatrix, preRotationMatrix, function (err, data) {
        if (err) {
            console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        if (data.length < 3) {
            console.error("Get angle variation failed, length" + data.length);
        }
        console.info("Z: " + data[0]);
        console.info("X: " + data[1]);
        console.info("Y  : " + data[2]);
    })
} catch (err) {
    console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getAngleVariation9+

getAngleVariation(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>): Promise<Array<number>>

得到兩個旋轉(zhuǎn)矩陣之間的角度變化。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
currentRotationMatrix	Array<number>	是	當前旋轉(zhuǎn)矩陣。
preRotationMatrix	Array<number>	是	相對旋轉(zhuǎn)矩陣

返回值：

類型	說明
Promise<Array<number>>	Promise對象，返回繞z、x、y軸方向的旋轉(zhuǎn)角度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getAngleVariation錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    // 旋轉(zhuǎn)矩陣可以為3*3，或者4*4
    let currentRotationMatrix = [
        1, 0, 0,
        0, 1, 0,
        0, 0, 1
    ];
    let preRotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    const promise = sensor.getAngleVariation(currentRotationMatrix, preRotationMatrix);
    promise.then((data) => {
        if (data.length < 3) {
            console.error("Get angle variation failed, length" + data.length);
        }
        console.info("Z: " + data[0]);
        console.info("X: " + data[1]);
        console.info("Y  : " + data[2]);
    }, (err) => {
        console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getRotationMatrix9+

getRotationMatrix(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void

根據(jù)旋轉(zhuǎn)矢量獲取旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	旋轉(zhuǎn)矢量。
callback	AsyncCallback<Array<number>>	是	回調(diào)函數(shù)，返回3*3旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877];
    sensor.getRotationMatrix(rotationVector, function (err, data) {
        if (err) {
            console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    })
} catch (err) {
    console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getRotationMatrix9+

getRotationMatrix(rotationVector: Array<number>): Promise<Array<number>>

根據(jù)旋轉(zhuǎn)矢量獲取旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	旋轉(zhuǎn)矢量。

返回值：

類型	說明
Promise<Array<number>>	Promise對象，返回旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877];
    const promise = sensor.getRotationMatrix(rotationVector);
    promise.then((data) => {
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    }, (err) => {
        console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.transformRotationMatrix9+

transformRotationMatrix(inRotationVector: Array<number>, coordinates: CoordinatesOptions,

callback: AsyncCallback<Array<number>>): void

根據(jù)指定坐標系映射旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inRotationVector	Array<number>	是	旋轉(zhuǎn)矩陣。
coordinates	CoordinatesOptions	是	指定坐標系方向。
callback	AsyncCallback<Array<number>>	是	回調(diào)函數(shù)，返回映射后的旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.transformRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    sensor.transformRotationMatrix(rotationMatrix, { x: 1, y: 3 }, function (err, data) {
        if (err) {
            console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + '] = ' + data[i]);
        }
    })
} catch (err) {
    console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.transformRotationMatrix9+

transformRotationMatrix(inRotationVector: Array<number>, coordinates: CoordinatesOptions): Promise<Array<number>>

根據(jù)指定坐標系映射旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inRotationVector	Array<number>	是	旋轉(zhuǎn)矩陣。
coordinates	CoordinatesOptions	是	指定坐標系方向。

返回值：

類型	說明
Promise<Array<number>>	Promise對象，返回轉(zhuǎn)換后的旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.transformRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    const promise = sensor.transformRotationMatrix(rotationMatrix, { x: 1, y: 3 });
    promise.then((data) => {
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    }, (err) => {
        console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getQuaternion9+

getQuaternion(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void

根據(jù)旋轉(zhuǎn)向量計算歸一化四元數(shù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	旋轉(zhuǎn)矢量。
callback	AsyncCallback<Array<number>>	是	回調(diào)函數(shù)，返回歸一化四元數(shù)。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getQuaternion錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877];
    sensor.getQuaternion(rotationVector, function (err, data) {
        if (err) {
            console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    })
} catch (err) {
    console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getQuaternion9+

getQuaternion(rotationVector: Array<number>): Promise<Array<number>>

根據(jù)旋轉(zhuǎn)向量計算歸一化四元數(shù)。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	旋轉(zhuǎn)矢量。

返回值：

類型	說明
Promise<Array<number>>	Promise，對象返歸一化回四元數(shù)。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getQuaternion錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877];
    const promise = sensor.getQuaternion(rotationVector);
    promise.then((data) => {
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    }, (err) => {
        console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getOrientation9+

getOrientation(rotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void

根據(jù)旋轉(zhuǎn)矩陣計算設備方向。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationMatrix	Array<number>	是	旋轉(zhuǎn)矩陣。
callback	AsyncCallback<Array<number>>	是	回調(diào)函數(shù)，返回圍繞z、x、y軸方向的旋轉(zhuǎn)角度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getOrientation錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let preRotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    sensor.getOrientation(preRotationMatrix, function (err, data) {
        if (err) {
            console.error('Get orientation failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        if (data.length < 3) {
            console.error("Get orientation failed, length" + data.length);
        }
        console.info("Z: " + data[0]);
        console.info("X: " + data[1]);
        console.info("Y  : " + data[2]);
    })
} catch (err) {
    console.error('Get orientation failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getOrientation9+

getOrientation(rotationMatrix: Array<number>): Promise<Array<number>>

根據(jù)旋轉(zhuǎn)矩陣計算設備的方向。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationMatrix	Array<number>	是	旋轉(zhuǎn)矩陣。

返回值：

類型	說明
Promise<Array<number>>	Promise對象，返回圍繞z、x、y軸方向的旋轉(zhuǎn)角度。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getOrientation錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let preRotationMatrix = [
        1, 0, 0,
        0, 0.87, -0.50,
        0, 0.50, 0.87
    ];
    const promise = sensor.getOrientation(preRotationMatrix);
    promise.then((data) => {
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + data[i]);
        }
    }, (err) => {
        console.error('getOrientation failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('getOrientation failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getRotationMatrix9+

getRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>, callback: AsyncCallback<RotationMatrixResponse>): void

根據(jù)重力矢量和地磁矢量計算旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
gravity	Array<number>	是	重力矢量。
geomagnetic	Array<number>	是	地磁矢量。
callback	AsyncCallback<RotationMatrixResponse>	是	回調(diào)函數(shù)，返回旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let gravity = [-0.27775216, 0.5351276, 9.788099];
    let geomagnetic = [210.87253, -78.6096, -111.44444];
    sensor.getRotationMatrix(gravity, geomagnetic, function (err, data) {
        if (err) {
            console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        console.info('RotationMatrix' + JSON.stringify(data));
    })
} catch (err) {
    console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getRotationMatrix9+

getRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>): Promise<RotationMatrixResponse>

根據(jù)重力矢量和地磁矢量計算旋轉(zhuǎn)矩陣。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
gravity	Array<number>	是	重力向量。
geomagnetic	Array<number>	是	地磁矢量。

返回值：

類型	說明
Promise<RotationMatrixResponse>	Promise對象，返回旋轉(zhuǎn)矩陣。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getRotationMatrix錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    let gravity = [-0.27775216, 0.5351276, 9.788099];
    let geomagnetic = [210.87253, -78.6096, -111.44444];
    const promise = sensor.getRotationMatrix(gravity, geomagnetic);
    promise.then((data) => {
        console.info('RotationMatrix' + JSON.stringify(data));
    }, (err) => {
        console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getSensorList9+

getSensorList(callback: AsyncCallback<Array<Sensor>>): void

獲取設備上的所有傳感器信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
callback	AsyncCallback<Array<Sensor>>	是	回調(diào)函數(shù)，返回傳感器屬性列表。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getSensorList錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.getSensorList((err, data) => {
        if (err) {
            console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + JSON.stringify(data[i]));
        }
    });
} catch (err) {
    console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getSensorList9+

getSensorList(): Promise<Array<Sensor>>

獲取設備上的所有傳感器信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

返回值：

參數(shù)名	類型	必填	說明
promise	Promise<Array<Sensor>>	是	Promise對象，返回傳感器屬性列表。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getSensorList錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.getSensorList().then((data) => {
        for (var i = 0; i < data.length; i++) {
            console.info('data[' + i + ']: ' + JSON.stringify(data[i]));
        }
    }, (err) => {
        console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getSingleSensor9+

getSingleSensor(type: SensorId, callback: AsyncCallback<Sensor>): void

獲取指定傳感器類型的屬性信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId	是	指定傳感器類型。
callback	AsyncCallback<Sensor>	是	回調(diào)函數(shù)，返回指定傳感器的屬性信息。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getSingleSensor錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.getSingleSensor(sensor.SensorId.ACCELEROMETER, (err, data) => {
        if (err) {
            console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message);
            return;
        }
        console.info('Sensor: ' + JSON.stringify(data));
    });
} catch (err) {
    console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message);
}

sensor.getSingleSensor9+

getSingleSensor(type: SensorId): Promise<Sensor>

獲取指定類型的傳感器信息。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorId	是	傳感器類型。

返回值：

參數(shù)名	類型	必填	說明
promise	Promise<Sensor>	是	返回傳感器信息。

錯誤碼：

以下錯誤碼的詳細介紹請參見 sensor.getSingleSensor錯誤碼。

錯誤碼ID	錯誤信息
14500101	Service exception.

示例：

try {
    sensor.getSingleSensor(sensor.SensorId.ACCELEROMETER).then((data) => {
        console.info('Sensor: ' + JSON.stringify(data));
    }, (err) => {
        console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message);
    });
} catch (err) {
    console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message);
}

SensorId9+

表示當前支持訂閱或取消訂閱的傳感器類型。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	值	說明
ACCELEROMETER	1	加速度傳感器。
GYROSCOPE	2	陀螺儀傳感器。
AMBIENT_LIGHT	5	環(huán)境光傳感器。
MAGNETIC_FIELD	6	磁場傳感器。
BAROMETER	8	氣壓計傳感器。
HALL	10	霍爾傳感器。
PROXIMITY	12	接近光傳感器。
HUMIDITY	13	濕度傳感器。
ORIENTATION	256	方向傳感器。
GRAVITY	257	重力傳感器。
LINEAR_ACCELEROMETER	258	線性加速度傳感器。
ROTATION_VECTOR	259	旋轉(zhuǎn)矢量傳感器。
AMBIENT_TEMPERATURE	260	環(huán)境溫度傳感器。
MAGNETIC_FIELD_UNCALIBRATED	261	未校準磁場傳感器。
GYROSCOPE_UNCALIBRATED	263	未校準陀螺儀傳感器。
SIGNIFICANT_MOTION	264	有效運動傳感器。
PEDOMETER_DETECTION	265	計步檢測傳感器。
PEDOMETER	266	計步傳感器。
HEART_RATE	278	心率傳感器。
WEAR_DETECTION	280	佩戴檢測傳感器。
ACCELEROMETER_UNCALIBRATED	281	未校準加速度計傳感器。

SensorType(deprecated)

表示要訂閱或取消訂閱的傳感器類型。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	值	說明
SENSOR_TYPE_ID_ACCELEROMETER	1	加速度傳感器。
SENSOR_TYPE_ID_GYROSCOPE	2	陀螺儀傳感器。
SENSOR_TYPE_ID_AMBIENT_LIGHT	5	環(huán)境光傳感器。
SENSOR_TYPE_ID_MAGNETIC_FIELD	6	磁場傳感器。
SENSOR_TYPE_ID_BAROMETER	8	氣壓計傳感器。
SENSOR_TYPE_ID_HALL	10	霍爾傳感器。
SENSOR_TYPE_ID_PROXIMITY	12	接近光傳感器。
SENSOR_TYPE_ID_HUMIDITY	13	濕度傳感器。
SENSOR_TYPE_ID_ORIENTATION	256	方向傳感器。
SENSOR_TYPE_ID_GRAVITY	257	重力傳感器。
SENSOR_TYPE_ID_LINEAR_ACCELERATION	258	線性加速度傳感器。
SENSOR_TYPE_ID_ROTATION_VECTOR	259	旋轉(zhuǎn)矢量傳感器。
SENSOR_TYPE_ID_AMBIENT_TEMPERATURE	260	環(huán)境溫度傳感器。
SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED	261	未校準磁場傳感器。
SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED	263	未校準陀螺儀傳感器。
SENSOR_TYPE_ID_SIGNIFICANT_MOTION	264	有效運動傳感器。
SENSOR_TYPE_ID_PEDOMETER_DETECTION	265	計步檢測傳感器。
SENSOR_TYPE_ID_PEDOMETER	266	計步傳感器。
SENSOR_TYPE_ID_HEART_RATE	278	心率傳感器。
SENSOR_TYPE_ID_WEAR_DETECTION	280	佩戴檢測傳感器。
SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED	281	未校準加速度計傳感器。

Response

傳感器數(shù)據(jù)的時間戳。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
timestamp	number	是	是	傳感器數(shù)據(jù)上報的時間戳。

Sensor9+

指示傳感器信息。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
sensorName	string	是	是	傳感器名稱。
vendorName	string	是	是	傳感器供應商。
firmwareVersion	string	是	是	傳感器固件版本。
hardwareVersion	string	是	是	傳感器硬件版本。
sensorId	number	是	是	傳感器類型id。
maxRange	number	是	是	傳感器測量范圍的最大值。
minSamplePeriod	number	是	是	允許的最小采樣周期。
maxSamplePeriod	number	是	是	允許的最大采樣周期。
precision	number	是	是	傳感器精度。
power	number	是	否	傳感器功率的估計值，單位：mA。

AccelerometerResponse

加速度傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	施加在設備x軸的加速度，單位 : m/s2。
y	number	是	是	施加在設備y軸的加速度，單位 : m/s2。
z	number	是	是	施加在設備z軸的加速度，單位 : m/s2。

LinearAccelerometerResponse

線性加速度傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	施加在設備x軸的線性加速度，單位 : m/s2。
y	number	是	是	施加在設備y軸的線性加速度，單位 : m/s2。
z	number	是	是	施加在設備z軸的線性加速度，單位 : m/s2。

AccelerometerUncalibratedResponse

未校準加速度計傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	施加在設備x軸未校準的加速度，單位 : m/s2。
y	number	是	是	施加在設備y軸未校準的加速度，單位 : m/s2。
z	number	是	是	施加在設備z軸未校準的加速度，單位 : m/s2。
biasX	number	是	是	施加在設備x軸未校準的加速度偏量，單位 : m/s2。
biasY	number	是	是	施加在設備上y軸未校準的加速度偏量，單位 : m/s2。
biasZ	number	是	是	施加在設備z軸未校準的加速度偏量，單位 : m/s2。

GravityResponse

重力傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	施加在設備x軸的重力加速度，單位 : m/s2。
y	number	是	是	施加在設備y軸的重力加速度，單位 : m/s2。
z	number	是	是	施加在設備z軸的重力加速度，單位 : m/s2。

OrientationResponse

方向傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
alpha	number	是	是	設備圍繞Z軸的旋轉(zhuǎn)角度，單位：度。
beta	number	是	是	設備圍繞X軸的旋轉(zhuǎn)角度，單位：度。
gamma	number	是	是	設備圍繞Y軸的旋轉(zhuǎn)角度，單位：度。

RotationVectorResponse

旋轉(zhuǎn)矢量傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	旋轉(zhuǎn)矢量x軸分量。
y	number	是	是	旋轉(zhuǎn)矢量y軸分量。
z	number	是	是	旋轉(zhuǎn)矢量z軸分量。
w	number	是	是	標量。

GyroscopeResponse

陀螺儀傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	設備x軸的旋轉(zhuǎn)角速度，單位rad/s。
y	number	是	是	設備y軸的旋轉(zhuǎn)角速度，單位rad/s。
z	number	是	是	設備z軸的旋轉(zhuǎn)角速度，單位rad/s。

GyroscopeUncalibratedResponse

未校準陀螺儀傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	設備x軸未校準的旋轉(zhuǎn)角速度，單位rad/s。
y	number	是	是	設備y軸未校準的旋轉(zhuǎn)角速度，單位rad/s。
z	number	是	是	設備z軸未校準的旋轉(zhuǎn)角速度，單位rad/s。
biasX	number	是	是	設備x軸未校準的旋轉(zhuǎn)角速度偏量，單位rad/s。
biasY	number	是	是	設備y軸未校準的旋轉(zhuǎn)角速度偏量，單位rad/s。
biasZ	number	是	是	設備z軸未校準的旋轉(zhuǎn)角速度偏量，單位rad/s。

SignificantMotionResponse

有效運動傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
scalar	number	是	是	表示劇烈運動程度。測量三個物理軸（x、y 和 z）上，設備是否存在大幅度運動；如果取值為1則代表存在大幅度運動，取值為0則代表沒有大幅度運動。

ProximityResponse

接近光傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
distance	number	是	是	可見物體與設備顯示器的接近程度。0表示接近，1表示遠離。

LightResponse

環(huán)境光傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
intensity	number	是	是	光強（單位：勒克斯）。

HallResponse

霍爾傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
status	number	是	是	顯示霍爾狀態(tài)。測量設備周圍是否存在磁力吸引，0表示沒有，大于0表示有。

MagneticFieldResponse

磁場傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	x軸環(huán)境磁場強度，單位 : μT。
y	number	是	是	y軸環(huán)境磁場強度，單位 : μT。
z	number	是	是	z軸環(huán)境磁場強度，單位 : μT。

MagneticFieldUncalibratedResponse

未校準磁場傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	x軸未校準環(huán)境磁場強度，單位 : μT。
y	number	是	是	y軸未校準環(huán)境磁場強度，單位 : μT。
z	number	是	是	z軸未校準環(huán)境磁場強度，單位 : μT。
biasX	number	是	是	x軸未校準環(huán)境磁場強度偏量，單位 : μT。
biasY	number	是	是	y軸未校準環(huán)境磁場強度偏量，單位 : μT。
biasZ	number	是	是	z軸未校準環(huán)境磁場強度偏量，單位 : μT。

PedometerResponse

計步傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
steps	number	是	是	用戶的行走步數(shù)。

HumidityResponse

濕度傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
humidity	number	是	是	濕度值。測量環(huán)境的相對濕度，以百分比 (%) 表示。

PedometerDetectionResponse

計步檢測傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
scalar	number	是	是	計步器檢測。檢測用戶的計步動作，如果取值為1則代表用戶產(chǎn)生了計步行走的動作，取值為0則代表用戶沒有發(fā)生運動。

AmbientTemperatureResponse

溫度傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
temperature	number	是	是	環(huán)境溫度（單位：攝氏度）。

BarometerResponse

氣壓計傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
pressure	number	是	是	壓力值（單位：帕斯卡）。

HeartRateResponse

心率傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
heartRate	number	是	是	心率值。測量用戶的心率數(shù)值，單位：bpm。

WearDetectionResponse

佩戴檢測傳感器數(shù)據(jù)，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
value	number	是	是	表示設備是否被穿戴（1表示已穿戴，0表示未穿戴）。

Options

設置傳感器上報頻率。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
interval	number	是	是	表示傳感器的上報頻率，默認值為200000000ns。

RotationMatrixResponse

設置旋轉(zhuǎn)矩陣響應對象。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
rotation	Array<number>	是	是	旋轉(zhuǎn)矩陣。
inclination	Array<number>	是	是	傾斜矩陣。

CoordinatesOptions

設置坐標選項對象。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	x坐標方向。
y	number	是	是	y坐標方向。

GeomagneticResponse

設置地磁響應對象，繼承于Response。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
x	number	是	是	地磁場的北分量。
y	number	是	是	地磁場的東分量。
z	number	是	是	地磁場的垂直分量。
geomagneticDip	number	是	是	地磁傾角，即地球磁場線與水平面的夾角。
deflectionAngle	number	是	是	地磁偏角，即地磁北方向與正北方向在水平面上的角度。
levelIntensity	number	是	是	地磁場的水平強度。
totalIntensity	number	是	是	地磁場的總強度。

LocationOptions

指示地理位置。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Sensors.Sensor

名稱	類型	可讀	可寫	說明
latitude	number	是	是	緯度。
longitude	number	是	是	經(jīng)度。
altitude	number	是	是	海拔高度。

sensor.on(deprecated)

ACCELEROMETER(deprecated)

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

監(jiān)聽加速度傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.ACCELEROMETER代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER	是	要訂閱的加速度傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<AccelerometerResponse>	是	注冊加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為AccelerometerResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽線性加速度傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.LINEAR_ACCELEROMETER代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION	是	要訂閱的線性加速度傳感器類型為SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<LinearAccelerometerResponse>	是	注冊線性加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LinearAccelerometerResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

ACCELEROMETER_UNCALIBRATED(deprecated)

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

監(jiān)聽未校準加速度計傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.ACCELEROMETER_UNCALIBRATED代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED	是	要訂閱的未校準加速度計傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	是	注冊未校準加速度計傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為AccelerometerUncalibratedResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽重力傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.GRAVITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GRAVITY	是	要訂閱的重力傳感器類型為SENSOR_TYPE_ID_GRAVITY。
callback	Callback<GravityResponse>	是	注冊重力傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為GravityResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽陀螺儀傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.GYROSCOPE代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE	是	要訂閱的陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<GyroscopeResponse>	是	注冊陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為GyroscopeResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽未校準陀螺儀傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.GYROSCOPE_UNCALIBRATED代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED	是	要訂閱的未校準陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	是	注冊未校準陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為GyroscopeUncalibratedResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率。

示例：

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(deprecated)

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

監(jiān)聽大幅動作傳感器數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.SIGNIFICANT_MOTION 代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION	是	要訂閱的大幅動作傳感器類型為SENSOR_TYPE_ID_SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	是	注冊有效運動傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為SignificantMotionResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

PEDOMETER_DETECTION(deprecated)

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

監(jiān)聽計步檢測傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.PEDOMETER_DETECTION代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION	是	要訂閱的計步檢測傳感器類型為SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	是	注冊計步檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerDetectionResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

PEDOMETER(deprecated)

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

監(jiān)聽計步傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.PEDOMETER代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER	是	要訂閱的計步傳感器類型為SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<PedometerResponse>	是	注冊計步傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

AMBIENT_TEMPERATURE(deprecated)

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

監(jiān)聽環(huán)境溫度傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.AMBIENT_TEMPERATURE代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE	是	要訂閱的環(huán)境溫度傳感器類型為SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	是	注冊環(huán)境溫度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為AmbientTemperatureResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

MAGNETIC_FIELD(deprecated)

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

監(jiān)聽磁場傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.MAGNETIC_FIELD代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD	是	要訂閱的磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD。
callback	Callback<MagneticFieldResponse>	是	注冊磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為MagneticFieldResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽未校準磁場傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.MAGNETIC_FIELD_UNCALIBRATED代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED	是	要訂閱的未校準磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	是	注冊未校準磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為MagneticFieldUncalibratedResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽接近光傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.PROXIMITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PROXIMITY	是	要訂閱的接近光傳感器類型為SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<ProximityResponse>	是	注冊接近光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為ProximityResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

HUMIDITY(deprecated)

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

監(jiān)聽濕度傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.HUMIDITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HUMIDITY	是	要訂閱的濕度傳感器類型為SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<HumidityResponse>	是	注冊濕度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HumidityResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

BAROMETER(deprecated)

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

監(jiān)聽氣壓計傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.BAROMETER代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_BAROMETER	是	要訂閱的氣壓計傳感器類型為SENSOR_TYPE_ID_BAROMETER。
callback	Callback<BarometerResponse>	是	注冊氣壓計傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為BarometerResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

HALL(deprecated)

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

監(jiān)聽霍爾傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.HALL代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HALL	是	要訂閱的霍爾傳感器類型為SENSOR_TYPE_ID_HALL。
callback	Callback<HallResponse>	是	注冊霍爾傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為 HallResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

AMBIENT_LIGHT(deprecated)

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

監(jiān)聽環(huán)境光傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.AMBIENT_LIGHT代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT	是	要訂閱的環(huán)境光傳感器類型為SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<LightResponse>	是	注冊環(huán)境光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LightResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

ORIENTATION(deprecated)

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

監(jiān)聽方向傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.ORIENTATION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ORIENTATION	是	要訂閱的方向傳感器類型為SENSOR_TYPE_ID_ORIENTATION
callback	Callback<OrientationResponse>	是	注冊方向傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為OrientationResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽心率傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.on.HEART_RATE代替。

需要權限：ohos.permission.HEALTH_DATA

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HEART_RATE	是	要訂閱的心率傳感器類型為SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<HeartRateResponse>	是	注冊一次心率傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HeartRateResponse。

ROTATION_VECTOR(deprecated)

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

監(jiān)聽旋轉(zhuǎn)矢量傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.ROTATION_VECTOR代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR	是	要訂閱的旋轉(zhuǎn)矢量傳感器類型為SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	是	注冊旋轉(zhuǎn)矢量傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為RotationVectorResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為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(deprecated)

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

監(jiān)聽佩戴檢測傳感器的數(shù)據(jù)變化。如果多次調(diào)用該接口，僅最后一次調(diào)用生效。

從API version 9 開始不再維護，建議使用sensor.on.WEAR_DETECTION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_WEAR_DETECTION	是	要訂閱的佩戴檢測傳感器類型為SENSOR_TYPE_ID_WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	是	注冊佩戴檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為WearDetectionResponse。
options	Options	否	可選參數(shù)列表，設置上報頻率，默認值為200000000ns。

示例：

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

sensor.once(deprecated)

ACCELEROMETER(deprecated)

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

監(jiān)聽加速度傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.ACCELEROMETER代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER	是	加速度傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<AccelerometerResponse>	是	注冊一次加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽線性加速度傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.LINEAR_ACCELEROMETER代替。

需要權限：ohos.permission.ACCELERATION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION	是	線性加速度傳感器類型為SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<LinearAccelerometerResponse>	是	注冊一次線性加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LinearAccelerometerResponse。

ACCELEROMETER_UNCALIBRATED(deprecated)

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

監(jiān)聽未校準加速度傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.ACCELEROMETER_UNCALIBRATED代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED	是	未校準加速度傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	是	注冊一次未校準加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽重力傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.GRAVITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GRAVITY	是	重力傳感器類型為SENSOR_TYPE_ID_GRAVITY。
callback	Callback<GravityResponse>	是	注冊一次重力傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽陀螺儀傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.GYROSCOPE代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE	是	陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<GyroscopeResponse>	是	注冊一次陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽未校準陀螺儀傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.GYROSCOPE_UNCALIBRATED代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED	是	未校準陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	是	注冊一次未校準陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽有效運動傳感器的數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.SIGNIFICANT_MOTION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION	是	有效運動傳感器類型為SENSOR_TYPE_ID_SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	是	注冊一次有效運動傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為SignificantMotionResponse。

示例：

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

PEDOMETER_DETECTION(deprecated)

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

監(jiān)聽計步檢測傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.PEDOMETER_DETECTION代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION	是	計步檢測傳感器類型為SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	是	注冊一次計步檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerDetectionResponse。

示例：

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

PEDOMETER(deprecated)

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

監(jiān)聽計步器傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.PEDOMETER代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER	是	計步傳感器類型為SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<PedometerResponse>	是	注冊一次計步傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerResponse。

示例：

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

AMBIENT_TEMPERATURE(deprecated)

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

監(jiān)聽環(huán)境溫度傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.AMBIENT_TEMPERATURE代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE	是	環(huán)境溫度傳感器類型為SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	是	注冊一次環(huán)境溫度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為AmbientTemperatureResponse。

示例：

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

MAGNETIC_FIELD(deprecated)

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

監(jiān)聽磁場傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.MAGNETIC_FIELD代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD	是	磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD。
callback	Callback<MagneticFieldResponse>	是	注冊一次磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽未校準磁場傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.MAGNETIC_FIELD_UNCALIBRATED代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED	是	未校準磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	是	注冊一次未校準磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽接近光傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.PROXIMITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PROXIMITY	是	接近光傳感器類型為SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<ProximityResponse>	是	注冊一次接近光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為ProximityResponse。

示例：

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

HUMIDITY(deprecated)

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

監(jiān)聽濕度傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.HUMIDITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HUMIDITY	是	濕度傳感器類型為SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<HumidityResponse>	是	注冊一次濕度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HumidityResponse。

示例：

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

BAROMETER(deprecated)

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

監(jiān)聽氣壓計傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.BAROMETER代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_BAROMETER	是	氣壓計傳感器類型為SENSOR_TYPE_ID_BAROMETER。
callback	Callback<BarometerResponse>	是	注冊一次氣壓計傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為BarometerResponse。

示例：

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

HALL(deprecated)

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

監(jiān)聽霍爾傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.HALL代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HALL	是	霍爾傳感器類型為SENSOR_TYPE_ID_HALL。
callback	Callback<HallResponse>	是	注冊一次霍爾傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HallResponse。

示例：

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

AMBIENT_LIGHT(deprecated)

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

監(jiān)聽環(huán)境光傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.AMBIENT_LIGHT代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT	是	環(huán)境光傳感器類型為SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<LightResponse>	是	注冊一次環(huán)境光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LightResponse。

示例：

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

ORIENTATION(deprecated)

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

監(jiān)聽方向傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.ORIENTATION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ORIENTATION	是	方向傳感器類型為SENSOR_TYPE_ID_ORIENTATION。
callback	Callback<OrientationResponse>	是	注冊一次方向傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽旋轉(zhuǎn)矢量傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.ROTATION_VECTOR代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR	是	旋轉(zhuǎn)矢量傳感器類型為SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	是	注冊一次旋轉(zhuǎn)矢量傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

監(jiān)聽心率傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.HEART_RATE代替。

需要權限：ohos.permission.HEART_RATE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HEART_RATE	是	心率傳感器類型為SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<HeartRateResponse>	是	注冊一次心率傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HeartRateResponse。

WEAR_DETECTION(deprecated)

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

監(jiān)聽佩戴檢測傳感器數(shù)據(jù)變化一次。

從API version 9 開始不再維護，建議使用sensor.once.WEAR_DETECTION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_WEAR_DETECTION	是	佩戴檢測傳感器類型為SENSOR_TYPE_ID_WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	是	注冊一次穿戴檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為WearDetectionResponse。

示例：

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

sensor.off(deprecated)

ACCELEROMETER(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.ACCELEROMETER代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER	是	要取消訂閱的加速度傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER。
callback	Callback<AccelerometerResponse>	否	取消注冊加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.ACCELEROMETER_UNCALIBRATED代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED	是	要取消訂閱的未校準加速度計傳感器類型為SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。
callback	Callback<AccelerometerUncalibratedResponse>	否	取消注冊未校準加速度計傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.AMBIENT_LIGHT代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT	是	要取消訂閱的環(huán)境光傳感器類型為SENSOR_TYPE_ID_AMBIENT_LIGHT。
callback	Callback<LightResponse>	否	取消注冊環(huán)境光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LightResponse。

示例：

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

AMBIENT_TEMPERATURE(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.AMBIENT_TEMPERATURE代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE	是	要取消訂閱的環(huán)境溫度傳感器類型為SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。
callback	Callback<AmbientTemperatureResponse>	否	取消注冊環(huán)境溫度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為AmbientTemperatureResponse。

示例：

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

BAROMETER(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.BAROMETER代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_BAROMETER	是	要取消訂閱的氣壓計傳感器類型為SENSOR_TYPE_ID_BAROMETER。
callback	Callback<BarometerResponse>	否	取消注冊氣壓計傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為BarometerResponse。

示例：

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

GRAVITY(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.GRAVITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GRAVITY	是	要取消訂閱的重力傳感器類型為SENSOR_TYPE_ID_GRAVITY。
callback	Callback<GravityResponse>	否	取消注冊注冊重力傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.GYROSCOPE代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE	是	要取消訂閱的陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE。
callback	Callback<GyroscopeResponse>	否	取消注冊陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.GYROSCOPE_UNCALIBRATED代替。

需要權限：ohos.permission.GYROSCOPE

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED	是	要取消訂閱的未校準陀螺儀傳感器類型為SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。
callback	Callback<GyroscopeUncalibratedResponse>	否	取消注冊未校準陀螺儀傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.HALL代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HALL	是	要取消訂閱的霍爾傳感器類型為SENSOR_TYPE_ID_HALL。
callback	Callback<HallResponse>	否	取消注冊霍爾傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為 HallResponse。

示例：

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

HEART_RATE(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.HEART_RATE代替。

需要權限：ohos.permission.HEALTH_DATA

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HEART_RATE	是	要取消訂閱的心率傳感器類型為SENSOR_TYPE_ID_HEART_RATE。
callback	Callback<HeartRateResponse>	否	取消注冊一次心率傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HeartRateResponse。

HUMIDITY(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.HUMIDITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_HUMIDITY	是	要取消訂閱的濕度傳感器類型為SENSOR_TYPE_ID_HUMIDITY。
callback	Callback<HumidityResponse>	否	取消注冊濕度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為HumidityResponse。

示例：

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

LINEAR_ACCELERATION(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.LINEAR_ACCELEROMETER代替。

需要權限：ohos.permission.ACCELEROMETER

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION	是	要取消訂閱的線性加速度傳感器類型為SENSOR_TYPE_ID_LINEAR_ACCELERATION。
callback	Callback<LinearAccelerometerResponse>	否	取消注冊性加速度傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為LinearAccelerometerResponse。

MAGNETIC_FIELD(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.MAGNETIC_FIELD代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD	是	要取消訂閱的磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD。
callbackcallback	Callback<MagneticFieldResponse>	否	取消注冊磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.MAGNETIC_FIELD_UNCALIBRATED代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED	是	要取消訂閱的未校準磁場傳感器類型為SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。
callback	Callback<MagneticFieldUncalibratedResponse>	否	取消注冊未校準磁場傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.ORIENTATION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ORIENTATION	是	要取消訂閱的方向傳感器類型為SENSOR_TYPE_ID_ORIENTATION
callback	Callback<OrientationResponse>	否	取消注冊方向傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.PEDOMETER代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER	是	要取消訂閱的計步傳感器類型為SENSOR_TYPE_ID_PEDOMETER。
callback	Callback<PedometerResponse>	否	取消注冊計步傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerResponse。

示例：

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

PEDOMETER_DETECTION(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.PEDOMETER_DETECTION代替。

需要權限：ohos.permission.ACTIVITY_MOTION

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION	是	要取消訂閱的計步檢測傳感器類型為SENSOR_TYPE_ID_PEDOMETER_DETECTION。
callback	Callback<PedometerDetectionResponse>	否	取消注冊計步檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為PedometerDetectionResponse。

示例：

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

PROXIMITY(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.PROXIMITY代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_PROXIMITY	是	要取消訂閱的接近光傳感器類型為SENSOR_TYPE_ID_PROXIMITY。
callback	Callback<ProximityResponse>	否	取消注冊接近光傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為ProximityResponse。

示例：

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

ROTATION_VECTOR(deprecated)

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

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.ROTATION_VECTOR代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR	是	要取消訂閱的旋轉(zhuǎn)矢量傳感器類型為SENSOR_TYPE_ID_ROTATION_VECTOR。
callback	Callback<RotationVectorResponse>	否	取消注冊旋轉(zhuǎn)矢量傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為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);

SIGNIFICANT_MOTION(deprecated)

off(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback?: Callback<SignificantMotionResponse>): void

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.SIGNIFICANT_MOTION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION	是	要取消訂閱的大幅動作傳感器類型為SENSOR_TYPE_ID_SIGNIFICANT_MOTION。
callback	Callback<SignificantMotionResponse>	否	取消注冊有效運動傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為SignificantMotionResponse。

示例：

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

WEAR_DETECTION(deprecated)

off(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback?: Callback<WearDetectionResponse>): void

取消訂閱傳感器數(shù)據(jù)。

從API version 9 開始不再維護，建議使用sensor.off.WEAR_DETECTION代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
type	SensorType.SENSOR_TYPE_ID_WEAR_DETECTION	是	要取消訂閱的佩戴檢測傳感器類型為SENSOR_TYPE_ID_WEAR_DETECTION。
callback	Callback<WearDetectionResponse>	否	取消注冊佩戴檢測傳感器的回調(diào)函數(shù)，上報的數(shù)據(jù)類型為WearDetectionResponse。

示例：

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

sensor.transformCoordinateSystem(deprecated)

transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions, callback: AsyncCallback<Array<number>>): void

旋轉(zhuǎn)提供的旋轉(zhuǎn)矩陣，使其可以以不同的方式表示坐標系。

從API version 9 開始不再維護，建議使用sensor.transformRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inRotationVector	Array<number>	是	表示旋轉(zhuǎn)矩陣。
coordinates	CoordinatesOptions	是	表示坐標系方向。
callback	AsyncCallback<Array<number>>	是	返回轉(zhuǎn)換后的旋轉(zhuǎn)矩陣。

示例：

sensor.transformCoordinateSystem([1, 0, 0, 0, 1, 0, 0, 0, 1], {x:2, y:3}, function(err, data) {
    if (err) {
        console.error("Operation failed. Error code: " + err.code + ", message: " + err.message);
        return;
    }
    console.info("Operation succeeded. Data obtained: " + data);
    for (var i=0; i < data.length; i++) {
        console.info("transformCoordinateSystem data[ " + i + "] = " + data[i]);
    }
 })

sensor.transformCoordinateSystem(deprecated)

transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions): Promise<Array<number>>

旋轉(zhuǎn)提供的旋轉(zhuǎn)矩陣，使其可以以不同的方式表示坐標系。

從API version 9 開始不再維護，建議使用sensor.transformRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inRotationVector	Array<number>	是	表示旋轉(zhuǎn)矩陣。
coordinates	CoordinatesOptions	是	表示坐標系方向。

返回值：

類型	說明
Promise<Array<number>>	返回轉(zhuǎn)換后的旋轉(zhuǎn)矩陣。

示例：

const promise = sensor.transformCoordinateSystem([1, 0, 0, 0, 1, 0, 0, 0, 1], {x:2, y:3});
    promise.then((data) => {
        console.info("Operation succeeded.");
        for (var i=0; i < data.length; i++) {
            console.info("transformCoordinateSystem data[ " + i + "] = " + data[i]);
        }
    }).catch((err) => {
           console.info("Operation failed");
})

sensor.getGeomagneticField(deprecated)

getGeomagneticField(locationOptions: LocationOptions, timeMillis: number, callback: AsyncCallback<GeomagneticResponse>): void

獲取地球上特定位置的地磁場。

從API version 9 開始不再維護，建議使用sensor.getGeomagneticInfo代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
locationOptions	LocationOptions	是	地理位置。
timeMillis	number	是	表示獲取磁偏角的時間，單位為毫秒。
callback	AsyncCallback<GeomagneticResponse>	是	返回磁場信息。

示例：

sensor.getGeomagneticField({latitude:80, longitude:0, altitude:0}, 1580486400000, function(err, data)  {
    if (err) {
        console.error('Operation failed. Error code: ' + err.code + '; message: ' + err.message);
        return;
    }
    console.info('sensor_getGeomagneticField_callback x: ' + data.x + ',y: ' + data.y + ',z: ' +
                 data.z + ',geomagneticDip: ' + data.geomagneticDip + ',deflectionAngle: ' + data.deflectionAngle +
             ',levelIntensity: ' + data.levelIntensity + ',totalIntensity: ' + data.totalIntensity);
});

sensor.getGeomagneticField(deprecated)

getGeomagneticField(locationOptions: LocationOptions, timeMillis: number): Promise<GeomagneticResponse>

獲取地球上特定位置的地磁場。

從API version 9 開始不再維護，建議使用sensor.getGeomagneticInfo代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
locationOptions	LocationOptions	是	地理位置。
timeMillis	number	是	表示獲取磁偏角的時間，單位為毫秒。

返回值：

類型	說明
Promise<GeomagneticResponse>	返回磁場信息。

示例：

const promise = sensor.getGeomagneticField({latitude:80, longitude:0, altitude:0}, 1580486400000);
    promise.then((data) => {
        console.info('sensor_getGeomagneticField_promise x: ' + data.x + ',y: ' + data.y + ',z: ' +
                 data.z + ',geomagneticDip: ' + data.geomagneticDip + ',deflectionAngle: ' + data.deflectionAngle +
             ',levelIntensity: ' + data.levelIntensity + ',totalIntensity: ' + data.totalIntensity);
    }).catch((reason) => {
        console.info('Operation failed.');
})

sensor.getAltitude(deprecated)

getAltitude(seaPressure: number, currentPressure: number, callback: AsyncCallback<number>): void

根據(jù)氣壓值獲取設備所在的海拔高度。

從API version 9 開始不再維護，建議使用sensor.getDeviceAltitude代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
seaPressure	number	是	表示海平面氣壓值，單位為hPa。
currentPressure	number	是	表示設備所在高度的氣壓值，單位為hPa。
callback	AsyncCallback<number>	是	返回設備所在的海拔高度，單位為米。

示例：

sensor.getAltitude(0, 200, function(err, data)  {
    if (err) {
        console.error(
"Operation failed. Error code: " + err.code + ", message: " + err.message);
        return;
    }
        console.info("Succeeded to get getAltitude interface get data: " + data);
});

sensor.getAltitude(deprecated)

getAltitude(seaPressure: number, currentPressure: number): Promise<number>

根據(jù)氣壓值獲取設備所在的海拔高度。

從API version 9 開始不再維護，建議使用sensor.getDeviceAltitude代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
seaPressure	number	是	表示海平面氣壓值，單位為hPa。
currentPressure	number	是	表示設備所在高度的氣壓值，單位為hPa。

返回值：

類型	說明
Promise<number>	返回設備所在的海拔高度（單位：米）。

示例：

const promise = sensor.getAltitude(0, 200);
    promise.then((data) => {
        console.info(' sensor_getAltitude_Promise success', data);
    }).catch((err) => {
        console.error("Operation failed");
})

sensor.getGeomagneticDip(deprecated)

getGeomagneticDip(inclinationMatrix: Array<number>, callback: AsyncCallback<number>): void

根據(jù)傾斜矩陣計算地磁傾斜角。

從API version 9 開始不再維護，建議使用sensor.getInclination代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inclinationMatrix	Array<number>	是	表示傾斜矩陣。
callback	AsyncCallback<number>	是	返回地磁傾斜角，單位為弧度。

示例：

sensor.getGeomagneticDip([1, 0, 0, 0, 1, 0, 0, 0, 1], function(err, data)  {
    if (err) {
        console.error('SensorJsAPI--->Failed to register data, error code is:' + err.code + ', message: ' + 
                      err.message);
        return;
    }
        console.info("Succeeded to get getGeomagneticDip interface get data: " + data);
})

sensor.getGeomagneticDip(deprecated)

getGeomagneticDip(inclinationMatrix: Array<number>): Promise<number>

根據(jù)傾斜矩陣計算地磁傾斜角。

從API version 9 開始不再維護，建議使用sensor.getInclination代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
inclinationMatrix	Array<number>	是	表示傾斜矩陣。

返回值：

類型	說明
Promise<number>	返回地磁傾斜角，單位為弧度。

示例：

const promise = sensor.getGeomagneticDip([1, 0, 0, 0, 1, 0, 0, 0, 1]);
    promise.then((data) => {
        console.info('getGeomagneticDip_promise succeeded', data);
    }).catch((err) => {
         console.error("Operation failed");
})

sensor. getAngleModify(deprecated)

getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void

獲取兩個旋轉(zhuǎn)矩陣之間的角度變化。

從API version 9 開始不再維護，建議使用sensor.getAngleVariation代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
currentRotationMatrix	Array<number>	是	表示當前旋轉(zhuǎn)矩陣。
preRotationMatrix	Array<number>	是	表示旋轉(zhuǎn)矩陣。
callback	AsyncCallback<Array<number>>	是	返回z、x、y軸方向的旋轉(zhuǎn)角度變化。

示例：

sensor. getAngleModify([1,0,0,0,1,0,0,0,1], [1, 0, 0, 0, 0.87, -0.50, 0, 0.50, 0.87], function(err, data)  {
    if (err) {
        console.error('Failed to register data, error code is: ' + err.code + ', message: ' + 
                      err.message);
        return;
    }
    for (var i=0; i < data.length; i++) {
        console.info("data[" + i + "]: " + data[i]);
    }
})

sensor. getAngleModify(deprecated)

getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>): Promise<Array<number>>

獲取兩個旋轉(zhuǎn)矩陣之間的角度變化。

從API version 9 開始不再維護，建議使用sensor.getAngleVariation代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
currentRotationMatrix	Array<number>	是	表示當前旋轉(zhuǎn)矩陣。
preRotationMatrix	Array<number>	是	表示旋轉(zhuǎn)矩陣。

返回值：

類型	說明
Promise<Array<number>>	返回z、x、y軸方向的旋轉(zhuǎn)角度變化。

示例：

const promise = sensor.getAngleModify([1,0,0,0,1,0,0,0,1], [1,0,0,0,0.87,-0.50,0,0.50,0.87]);
    promise.then((data) => {
        console.info('getAngleModify_promise success');
        for (var i=0; i < data.length; i++) {
            console.info("data[" + i + "]: " + data[i]);
        }
    }).catch((reason) => {
        console.info("promise::catch", reason);
})

sensor.createRotationMatrix(deprecated)

createRotationMatrix(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void

將旋轉(zhuǎn)矢量轉(zhuǎn)換為旋轉(zhuǎn)矩陣。

從API version 9 開始不再維護，建議使用sensor.getRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	表示旋轉(zhuǎn)矢量。
callback	AsyncCallback<Array<number>>	是	返回旋轉(zhuǎn)矩陣。

示例：

sensor.createRotationMatrix([0.20046076, 0.21907, 0.73978853, 0.60376877], function(err, data) {
    if (err) {
        console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' + 
                      err.message);
        return;
    }
    for (var i=0; i < data.length; i++) {
        console.info("data[" + i + "]: " + data[i]);
    }
})

sensor.createRotationMatrix(deprecated)

createRotationMatrix(rotationVector: Array<number>): Promise<Array<number>>

將旋轉(zhuǎn)矢量轉(zhuǎn)換為旋轉(zhuǎn)矩陣。

從API version 9 開始不再維護，建議使用sensor.getRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	表示旋轉(zhuǎn)矢量。

返回值：

類型	說明
Promise<Array<number>>	返回旋轉(zhuǎn)矩陣。

示例：

const promise = sensor.createRotationMatrix([0.20046076, 0.21907, 0.73978853, 0.60376877]);
    promise.then((data) => {
        console.info('createRotationMatrix_promise success');
        for (var i=0; i < data.length; i++) {
            console.info("data[" + i + "]: " + data[i]);
        }
    }).catch((reason) => {
        console.info("promise::catch", reason);
})    

sensor.createQuaternion(deprecated)

createQuaternion(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void

將旋轉(zhuǎn)矢量轉(zhuǎn)換為四元數(shù)。

從API version 9 開始不再維護，建議使用sensor.getQuaternion代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	表示旋轉(zhuǎn)矢量。
callback	AsyncCallback<Array<number>>	是	返回四元數(shù)。

示例：

sensor.createQuaternion([0.20046076, 0.21907, 0.73978853, 0.60376877], function(err, data)  {
    if (err) {
        console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' + 
                      err.message);
        return;
    }
    for (var i=0; i < data.length; i++) {
        console.info("data[" + i + "]: " + data[i]);
    }
})

sensor.createQuaternion(deprecated)

createQuaternion(rotationVector: Array<number>): Promise<Array<number>>

將旋轉(zhuǎn)矢量轉(zhuǎn)換為四元數(shù)。

從API version 9 開始不再維護，建議使用sensor.getQuaternion代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationVector	Array<number>	是	表示旋轉(zhuǎn)矢量。

返回值：

類型	說明
Promise<Array<number>>	返回四元數(shù)。

示例：

const promise = sensor.createQuaternion([0.20046076, 0.21907, 0.73978853, 0.60376877]);
    promise.then((data) => {
        console.info('createQuaternion_promise succeeded');
        for (var i=0; i < data.length; i++) {
            console.info("data[" + i + "]: " + data[i]);
        }
    }).catch((err) => {
        console.info('promise failed');
})

sensor.getDirection(deprecated)

getDirection(rotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void

根據(jù)旋轉(zhuǎn)矩陣計算設備的方向。

從API version 9 開始不再維護，建議使用sensor.getOrientation代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationMatrix	Array<number>	是	表示旋轉(zhuǎn)矩陣。
callback	AsyncCallback<Array<number>>	是	返回圍繞z、x、y軸方向的旋轉(zhuǎn)角度。

示例：

sensor.getDirection([1, 0, 0, 0, 1, 0, 0, 0, 1], function(err, data)  {
    if (err) {
        console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' +
                      err.message);
        return;
    }
    console.info("SensorJsAPI--->Succeeded to get getDirection interface get data: " + data);
    for (var i = 1; i < data.length; i++) {
        console.info("sensor_getDirection_callback" + data[i]);
    }
})

sensor.getDirection(deprecated)

getDirection(rotationMatrix: Array<number>): Promise<Array<number>>

根據(jù)旋轉(zhuǎn)矩陣計算設備的方向。

從API version 9 開始不再維護，建議使用sensor.getOrientation代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
rotationMatrix	Array<number>	是	表示旋轉(zhuǎn)矩陣。

返回值：

類型	說明
Promise<Array<number>>	返回圍繞z、x、y軸方向的旋轉(zhuǎn)角度。

示例：

const promise = sensor.getDirection([1, 0, 0, 0, 1, 0, 0, 0, 1]);
    promise.then((data) => {
        console.info('sensor_getAltitude_Promise success', data);
        for (var i = 1; i < data.length; i++) {
            console.info("sensor_getDirection_promise" + data[i]);
        }
    }).catch((err) => {
        console.info('promise failed');
})

sensor.createRotationMatrix(deprecated)

createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>, callback: AsyncCallback<RotationMatrixResponse>): void

根據(jù)重力矢量和地磁矢量計算旋轉(zhuǎn)矩陣。

從API version 9 開始不再維護，建議使用sensor.getRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
gravity	Array<number>	是	表示重力向量。
geomagnetic	Array<number>	是	表示地磁矢量。
callback	AsyncCallback<RotationMatrixResponse>	是	返回旋轉(zhuǎn)矩陣。

示例：

sensor.createRotationMatrix([-0.27775216, 0.5351276, 9.788099], [210.87253, -78.6096, -111.44444], function(err, data)  {
    if (err) {
        console.error('error code is: ' + err.code + ', message: ' + err.message);
        return;
    }
    console.info(JSON.stringify(data));
})

sensor.createRotationMatrix(deprecated)

createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>,): Promise<RotationMatrixResponse>

根據(jù)重力矢量和地磁矢量計算旋轉(zhuǎn)矩陣。

從API version 9 開始不再維護，建議使用sensor.getRotationMatrix代替。

系統(tǒng)能力：SystemCapability.Sensors.Sensor

參數(shù)：

參數(shù)名	類型	必填	說明
gravity	Array<number>	是	表示重力向量。
geomagnetic	Array<number>	是	表示地磁矢量。

返回值：

類型	說明
Promise<RotationMatrixResponse>	返回旋轉(zhuǎn)矩陣。

示例：

const promise = sensor.createRotationMatrix([-0.27775216, 0.5351276, 9.788099], [210.87253, -78.6096, -111.44444]);
    promise.then((data) => {
        console.info(JSON.stringify(data));
    }).catch((err) => {
        console.info('promise failed');
})