Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 539d0b30 编写于 作者: C cff-gite
浏览文件
操作

修改资料 

Signed-off-by: Ncff-gite <chenfeifei8@huawei.com>
上级 8974387a
隐藏空白更改
内联 并排
Showing with 512 addition and 271 deletion
zh-cn/application-dev/reference/apis/js-apis-sensor.md
浏览文件 @ 539d0b30
...@@ -44,13 +44,15 @@ on(type: SensorId.ACCELEROMETER, callback: Callback&lt;AccelerometerResponse&gt; ...@@ -44,13 +44,15 @@ on(type: SensorId.ACCELEROMETER, callback: Callback&lt;AccelerometerResponse&gt;
**示例：** **示例：**
```js ```js
sensor.on(sensor.SensorId.ACCELEROMETER,function(data){ try {
console.info('X-coordinate component: ' + data.x); sensor.on(sensor.SensorId.ACCELEROMETER,function(data){
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
}, console.info('Z-coordinate component: ' + data.z);
{interval: 10000000} }, {interval: 10000000} );
); } catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> ### ACCELEROMETER_UNCALIBRATED<sup>9+</sup>
...@@ -74,16 +76,18 @@ on(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback:Callback&lt;Accelerometer ...@@ -74,16 +76,18 @@ on(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback:Callback&lt;Accelerometer
**示例：** **示例：**
```js ```js
sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED,function(data){ try {
console.info('X-coordinate component: ' + data.x); sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED,function(data){
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('X-coordinate bias: ' + data.biasX); console.info('Z-coordinate component: ' + data.z);
console.info('Y-coordinate bias: ' + data.biasY); console.info('X-coordinate bias: ' + data.biasX);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Y-coordinate bias: ' + data.biasY);
}, console.info('Z-coordinate bias: ' + data.biasZ);
{interval: 10000000} }, {interval: 10000000} );
); } catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### AMBIENT_LIGHT<sup>9+</sup> ### AMBIENT_LIGHT<sup>9+</sup>
...@@ -105,11 +109,13 @@ on(type: SensorId.AMBIENT_LIGHT, callback: Callback&lt;LightResponse&gt;, option ...@@ -105,11 +109,13 @@ on(type: SensorId.AMBIENT_LIGHT, callback: Callback&lt;LightResponse&gt;, option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.AMBIENT_LIGHT,function(data){ sensor.on(sensor.SensorId.AMBIENT_LIGHT,function(data){
console.info('Illumination: ' + data.intensity); console.info('Illumination: ' + data.intensity);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### AMBIENT_TEMPERATURE<sup>9+</sup> ### AMBIENT_TEMPERATURE<sup>9+</sup>
...@@ -131,11 +137,13 @@ on(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback&lt;AmbientTemperatureR ...@@ -131,11 +137,13 @@ on(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback&lt;AmbientTemperatureR
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE,function(data){ sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE,function(data){
console.info('Temperature: ' + data.temperature); console.info('Temperature: ' + data.temperature);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### BAROMETER<sup>9+</sup> ### BAROMETER<sup>9+</sup>
...@@ -157,11 +165,13 @@ on(type: SensorId.BAROMETER, callback: Callback&lt;BarometerResponse&gt;, option ...@@ -157,11 +165,13 @@ on(type: SensorId.BAROMETER, callback: Callback&lt;BarometerResponse&gt;, option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.BAROMETER,function(data){ sensor.on(sensor.SensorId.BAROMETER,function(data){
console.info('Atmospheric pressure: ' + data.pressure); console.info('Atmospheric pressure: ' + data.pressure);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GRAVITY<sup>9+</sup> ### GRAVITY<sup>9+</sup>
...@@ -183,13 +193,15 @@ on(type: SensorId.GRAVITY, callback: Callback&lt;GravityResponse&gt;,options?: O ...@@ -183,13 +193,15 @@ on(type: SensorId.GRAVITY, callback: Callback&lt;GravityResponse&gt;,options?: O
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.GRAVITY,function(data){ sensor.on(sensor.SensorId.GRAVITY,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GYROSCOPE<sup>9+</sup> ### GYROSCOPE<sup>9+</sup>
...@@ -213,13 +225,15 @@ on(type: SensorId.GYROSCOPE, callback: Callback&lt;GyroscopeResponse&gt;,options ...@@ -213,13 +225,15 @@ on(type: SensorId.GYROSCOPE, callback: Callback&lt;GyroscopeResponse&gt;,options
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.GYROSCOPE,function(data){ sensor.on(sensor.SensorId.GYROSCOPE,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GYROSCOPE_UNCALIBRATED<sup>9+</sup> ### GYROSCOPE_UNCALIBRATED<sup>9+</sup>
...@@ -244,6 +258,7 @@ on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback&lt;GyroscopeUncalib ...@@ -244,6 +258,7 @@ on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback&lt;GyroscopeUncalib
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED,function(data){ sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
...@@ -251,9 +266,10 @@ on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback&lt;GyroscopeUncalib ...@@ -251,9 +266,10 @@ on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback&lt;GyroscopeUncalib
console.info('X-coordinate bias: ' + data.biasX); console.info('X-coordinate bias: ' + data.biasX);
console.info('Y-coordinate bias: ' + data.biasY); console.info('Y-coordinate bias: ' + data.biasY);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Z-coordinate bias: ' + data.biasZ);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HALL<sup>9+</sup> ### HALL<sup>9+</sup>
...@@ -275,11 +291,13 @@ on(type: SensorId.HALL, callback: Callback&lt;HallResponse&gt;, options?: Option ...@@ -275,11 +291,13 @@ on(type: SensorId.HALL, callback: Callback&lt;HallResponse&gt;, options?: Option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.HALL,function(data){ sensor.on(sensor.SensorId.HALL,function(data){
console.info('Status: ' + data.status); console.info('Status: ' + data.status);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HEART_RATE<sup>9+</sup> ### HEART_RATE<sup>9+</sup>
...@@ -303,11 +321,13 @@ on(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;,option ...@@ -303,11 +321,13 @@ on(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;,option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.HEART_RATE,function(data){ sensor.on(sensor.SensorId.HEART_RATE,function(data){
console.info('Heart rate: ' + data.heartRate); console.info('Heart rate: ' + data.heartRate);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HUMIDITY<sup>9+</sup> ### HUMIDITY<sup>9+</sup>
...@@ -329,11 +349,13 @@ on(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;,options?: ...@@ -329,11 +349,13 @@ on(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;,options?:
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.HUMIDITY,function(data){ sensor.on(sensor.SensorId.HUMIDITY,function(data){
console.info('Humidity: ' + data.humidity); console.info('Humidity: ' + data.humidity);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### LINEAR_ACCELERATION<sup>9+</sup> ### LINEAR_ACCELERATION<sup>9+</sup>
...@@ -358,12 +380,15 @@ on(type: SensorId.LINEAR_ACCELERATION, callback: Callback&lt;LinearAccelerometer ...@@ -358,12 +380,15 @@ on(type: SensorId.LINEAR_ACCELERATION, callback: Callback&lt;LinearAccelerometer
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, function(data) { sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, function(data) {
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
} }, {interval: 10000000} );
); } catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### MAGNETIC_FIELD<sup>9+</sup> ### MAGNETIC_FIELD<sup>9+</sup>
...@@ -385,13 +410,15 @@ on(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse&gt ...@@ -385,13 +410,15 @@ on(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse&gt
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.MAGNETIC_FIELD,function(data){ sensor.on(sensor.SensorId.MAGNETIC_FIELD,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> ### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup>
...@@ -414,6 +441,7 @@ on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticField ...@@ -414,6 +441,7 @@ on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticField
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED,function(data){ sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
...@@ -421,9 +449,10 @@ on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticField ...@@ -421,9 +449,10 @@ on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticField
console.info('X-coordinate bias: ' + data.biasX); console.info('X-coordinate bias: ' + data.biasX);
console.info('Y-coordinate bias: ' + data.biasY); console.info('Y-coordinate bias: ' + data.biasY);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Z-coordinate bias: ' + data.biasZ);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ORIENTATION<sup>9+</sup> ### ORIENTATION<sup>9+</sup>
...@@ -445,13 +474,15 @@ on(type: SensorId.ORIENTATION, callback: Callback&lt;OrientationResponse&gt;,opt ...@@ -445,13 +474,15 @@ on(type: SensorId.ORIENTATION, callback: Callback&lt;OrientationResponse&gt;,opt
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.ORIENTATION,function(data){ sensor.on(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 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 Y axis: ' + data.gamma);
console.info('The device rotates at an angle around the Z axis: ' + data.alpha); console.info('The device rotates at an angle around the Z axis: ' + data.alpha);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PEDOMETER<sup>9+</sup> ### PEDOMETER<sup>9+</sup>
...@@ -475,11 +506,13 @@ on(type: SensorId.PEDOMETER, callback: Callback&lt;PedometerResponse&gt;, option ...@@ -475,11 +506,13 @@ on(type: SensorId.PEDOMETER, callback: Callback&lt;PedometerResponse&gt;, option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.PEDOMETER,function(data){ sensor.on(sensor.SensorId.PEDOMETER,function(data){
console.info('Steps: ' + data.steps); console.info('Steps: ' + data.steps);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PEDOMETER_DETECTION<sup>9+</sup> ### PEDOMETER_DETECTION<sup>9+</sup>
...@@ -504,11 +537,13 @@ on(type: SensorId.PEDOMETER_DETECTION, callback: Callback&lt;PedometerDetectionR ...@@ -504,11 +537,13 @@ on(type: SensorId.PEDOMETER_DETECTION, callback: Callback&lt;PedometerDetectionR
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.PEDOMETER_DETECTION,function(data){ sensor.on(sensor.SensorId.PEDOMETER_DETECTION,function(data){
console.info('Scalar data: ' + data.scalar); console.info('Scalar data: ' + data.scalar);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PROXIMITY<sup>9+</sup> ### PROXIMITY<sup>9+</sup>
...@@ -530,11 +565,13 @@ on(type: SensorId.PROXIMITY, callback: Callback&lt;ProximityResponse&gt;, option ...@@ -530,11 +565,13 @@ on(type: SensorId.PROXIMITY, callback: Callback&lt;ProximityResponse&gt;, option
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.PROXIMITY,function(data){ sensor.on(sensor.SensorId.PROXIMITY,function(data){
console.info('Distance: ' + data.distance); console.info('Distance: ' + data.distance);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ROTATION_VECTOR<sup>9+</sup> ### ROTATION_VECTOR<sup>9+</sup>
...@@ -557,14 +594,16 @@ on(type: SensorId.ROTATION_VECTOR, callback: Callback&lt;RotationVectorResponse& ...@@ -557,14 +594,16 @@ on(type: SensorId.ROTATION_VECTOR, callback: Callback&lt;RotationVectorResponse&
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.ROTATION_VECTOR,function(data){ sensor.on(sensor.SensorId.ROTATION_VECTOR,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
console.info('Scalar quantity: ' + data.w); console.info('Scalar quantity: ' + data.w);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### SIGNIFICANT_MOTION<sup>9+</sup> ### SIGNIFICANT_MOTION<sup>9+</sup>
...@@ -587,11 +626,13 @@ on(type: SensorId.SIGNIFICANT_MOTION, callback: Callback&lt;SignificantMotionRes ...@@ -587,11 +626,13 @@ on(type: SensorId.SIGNIFICANT_MOTION, callback: Callback&lt;SignificantMotionRes
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.SIGNIFICANT_MOTION,function(data){ sensor.on(sensor.SensorId.SIGNIFICANT_MOTION,function(data){
console.info('Scalar data: ' + data.scalar); console.info('Scalar data: ' + data.scalar);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### WEAR_DETECTION<sup>9+</sup> ### WEAR_DETECTION<sup>9+</sup>
...@@ -614,11 +655,13 @@ on(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse&gt ...@@ -614,11 +655,13 @@ on(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse&gt
**示例：** **示例：**
```js ```js
try {
sensor.on(sensor.SensorId.WEAR_DETECTION,function(data){ sensor.on(sensor.SensorId.WEAR_DETECTION,function(data){
console.info('Wear status: ' + data.value); console.info('Wear status: ' + data.value);
}, }, {interval: 10000000} );
{interval: 10000000} } catch(err) {
); console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
## sensor.once ## sensor.once
...@@ -643,12 +686,16 @@ once(type: SensorId.ACCELEROMETER, callback: Callback&lt;AccelerometerResponse&g ...@@ -643,12 +686,16 @@ once(type: SensorId.ACCELEROMETER, callback: Callback&lt;AccelerometerResponse&g
**示例：** **示例：**
```js ```js
try {
sensor.once(sensor.SensorId.ACCELEROMETER,function(data){ sensor.once(sensor.SensorId.ACCELEROMETER,function(data){
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z); console.info('Z-coordinate component: ' + data.z);
} }
); );
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> ### ACCELEROMETER_UNCALIBRATED<sup>9+</sup>
...@@ -671,6 +718,7 @@ once(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback:Callback&lt;Acceleromete ...@@ -671,6 +718,7 @@ once(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback:Callback&lt;Acceleromete
**示例：** **示例：**
```js ```js
try {
sensor.once(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, function(data) { sensor.once(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, function(data) {
console.info('X-coordinate component: ' + data.x); console.info('X-coordinate component: ' + data.x);
console.info('Y-coordinate component: ' + data.y); console.info('Y-coordinate component: ' + data.y);
...@@ -680,6 +728,9 @@ once(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback:Callback&lt;Acceleromete ...@@ -680,6 +728,9 @@ once(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback:Callback&lt;Acceleromete
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Z-coordinate bias: ' + data.biasZ);
} }
); );
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### AMBIENT_LIGHT<sup>9+</sup> ### AMBIENT_LIGHT<sup>9+</sup>
...@@ -700,10 +751,14 @@ once(type: SensorId.AMBIENT_LIGHT, callback: Callback&lt;LightResponse&gt;): voi ...@@ -700,10 +751,14 @@ once(type: SensorId.AMBIENT_LIGHT, callback: Callback&lt;LightResponse&gt;): voi
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.AMBIENT_LIGHT, function(data) { try {
console.info('Illumination: ' + data.intensity); sensor.once(sensor.SensorId.AMBIENT_LIGHT, function(data) {
} console.info('Illumination: ' + data.intensity);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### AMBIENT_TEMPERATURE<sup>9+</sup> ### AMBIENT_TEMPERATURE<sup>9+</sup>
...@@ -723,10 +778,14 @@ once(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback&lt;AmbientTemperatur ...@@ -723,10 +778,14 @@ once(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback&lt;AmbientTemperatur
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.AMBIENT_TEMPERATURE, function(data) { try {
console.info('Temperature: ' + data.temperature); sensor.once(sensor.SensorId.AMBIENT_TEMPERATURE, function(data) {
} console.info('Temperature: ' + data.temperature);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### BAROMETER<sup>9+</sup> ### BAROMETER<sup>9+</sup>
...@@ -746,10 +805,14 @@ once(type: SensorId.BAROMETER, callback: Callback&lt;BarometerResponse&gt;): voi ...@@ -746,10 +805,14 @@ once(type: SensorId.BAROMETER, callback: Callback&lt;BarometerResponse&gt;): voi
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(data) { try {
console.info('Atmospheric pressure: ' + data.pressure); sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(data) {
} console.info('Atmospheric pressure: ' + data.pressure);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GRAVITY<sup>9+</sup> ### GRAVITY<sup>9+</sup>
...@@ -770,12 +833,16 @@ once(type: SensorId.GRAVITY, callback: Callback&lt;GravityResponse&gt;): void ...@@ -770,12 +833,16 @@ once(type: SensorId.GRAVITY, callback: Callback&lt;GravityResponse&gt;): void
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.GRAVITY, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.GRAVITY, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
} console.info('Z-coordinate component: ' + data.z);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GYROSCOPE<sup>9+</sup> ### GYROSCOPE<sup>9+</sup>
...@@ -798,12 +865,16 @@ once(type: SensorId.GYROSCOPE, callback: Callback&lt;GyroscopeResponse&gt;): voi ...@@ -798,12 +865,16 @@ once(type: SensorId.GYROSCOPE, callback: Callback&lt;GyroscopeResponse&gt;): voi
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.GYROSCOPE, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.GYROSCOPE, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
} console.info('Z-coordinate component: ' + data.z);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### GYROSCOPE_UNCALIBRATED<sup>9+</sup> ### GYROSCOPE_UNCALIBRATED<sup>9+</sup>
...@@ -828,15 +899,19 @@ SensorId.GYROSCOPE_UNCALIBRATED,callback:Callback&lt;GyroscopeUncalibratedRespon ...@@ -828,15 +899,19 @@ SensorId.GYROSCOPE_UNCALIBRATED,callback:Callback&lt;GyroscopeUncalibratedRespon
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.GYROSCOPE_UNCALIBRATED, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.GYROSCOPE_UNCALIBRATED, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('X-coordinate bias: ' + data.biasX); console.info('Z-coordinate component: ' + data.z);
console.info('Y-coordinate bias: ' + data.biasY); console.info('X-coordinate bias: ' + data.biasX);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Y-coordinate bias: ' + data.biasY);
} console.info('Z-coordinate bias: ' + data.biasZ);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HALL<sup>9+</sup> ### HALL<sup>9+</sup>
...@@ -857,10 +932,14 @@ once(type: SensorId.HALL, callback: Callback&lt;HallResponse&gt;): void ...@@ -857,10 +932,14 @@ once(type: SensorId.HALL, callback: Callback&lt;HallResponse&gt;): void
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.HALL, function(data) { try {
console.info('Status: ' + data.status); sensor.once(sensor.SensorId.HALL, function(data) {
} console.info('Status: ' + data.status);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HEART_RATE<sup>9+</sup> ### HEART_RATE<sup>9+</sup>
...@@ -883,10 +962,14 @@ once(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;): vo ...@@ -883,10 +962,14 @@ once(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;): vo
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.HEART_BEAT_RATE, function(data) { try {
console.info('Heart rate: ' + data.heartRate); sensor.once(sensor.SensorId.HEART_BEAT_RATE, function(data) {
} console.info('Heart rate: ' + data.heartRate);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### HUMIDITY<sup>9+</sup> ### HUMIDITY<sup>9+</sup>
...@@ -907,10 +990,14 @@ once(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;): void ...@@ -907,10 +990,14 @@ once(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;): void
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.HUMIDITY, function(data) { try {
console.info('Humidity: ' + data.humidity); sensor.once(sensor.SensorId.HUMIDITY, function(data) {
} console.info('Humidity: ' + data.humidity);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### LINEAR_ACCELERATION<sup>9+</sup> ### LINEAR_ACCELERATION<sup>9+</sup>
...@@ -933,12 +1020,16 @@ once(type: SensorId.LINEAR_ACCELERATION, callback: Callback&lt;LinearAcceleromet ...@@ -933,12 +1020,16 @@ once(type: SensorId.LINEAR_ACCELERATION, callback: Callback&lt;LinearAcceleromet
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.LINEAR_ACCELEROMETER, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.LINEAR_ACCELEROMETER, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
} console.info('Z-coordinate component: ' + data.z);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### MAGNETIC_FIELD<sup>9+</sup> ### MAGNETIC_FIELD<sup>9+</sup>
...@@ -959,12 +1050,16 @@ once(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse& ...@@ -959,12 +1050,16 @@ once(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse&
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.MAGNETIC_FIELD, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.MAGNETIC_FIELD, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
} console.info('Z-coordinate component: ' + data.z);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> ### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup>
...@@ -985,15 +1080,19 @@ once(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticFie ...@@ -985,15 +1080,19 @@ once(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback:Callback&lt;MagneticFie
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('X-coordinate bias: ' + data.biasX); console.info('Z-coordinate component: ' + data.z);
console.info('Y-coordinate bias: ' + data.biasY); console.info('X-coordinate bias: ' + data.biasX);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Y-coordinate bias: ' + data.biasY);
} console.info('Z-coordinate bias: ' + data.biasZ);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ORIENTATION<sup>9+</sup> ### ORIENTATION<sup>9+</sup>
...@@ -1014,12 +1113,16 @@ once(type: SensorId.ORIENTATION, callback: Callback&lt;OrientationResponse&gt;): ...@@ -1014,12 +1113,16 @@ once(type: SensorId.ORIENTATION, callback: Callback&lt;OrientationResponse&gt;):
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.ORIENTATION, function(data) { try {
console.info('The device rotates at an angle around the X axis: ' + data.beta); sensor.once(sensor.SensorId.ORIENTATION, function(data) {
console.info('The device rotates at an angle around the Y axis: ' + data.gamma); console.info('The device rotates at an angle around the X axis: ' + data.beta);
console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 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.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PEDOMETER<sup>9+</sup> ### PEDOMETER<sup>9+</sup>
...@@ -1042,10 +1145,14 @@ once(type: SensorId.PEDOMETER, callback: Callback&lt;PedometerResponse&gt;): voi ...@@ -1042,10 +1145,14 @@ once(type: SensorId.PEDOMETER, callback: Callback&lt;PedometerResponse&gt;): voi
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.PEDOMETER, function(data) { try {
console.info('Steps: ' + data.steps); sensor.once(sensor.SensorId.PEDOMETER, function(data) {
} console.info('Steps: ' + data.steps);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PEDOMETER_DETECTION<sup>9+</sup> ### PEDOMETER_DETECTION<sup>9+</sup>
...@@ -1068,10 +1175,14 @@ once(type: SensorId.PEDOMETER_DETECTION, callback: Callback&lt;PedometerDetectio ...@@ -1068,10 +1175,14 @@ once(type: SensorId.PEDOMETER_DETECTION, callback: Callback&lt;PedometerDetectio
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.PEDOMETER_DETECTION, function(data) { try {
console.info('Scalar data: ' + data.scalar); sensor.once(sensor.SensorId.PEDOMETER_DETECTION, function(data) {
} console.info('Scalar data: ' + data.scalar);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### PROXIMITY<sup>9+</sup> ### PROXIMITY<sup>9+</sup>
...@@ -1092,10 +1203,14 @@ once(type: SensorId.PROXIMITY, callback: Callback&lt;ProximityResponse&gt;): voi ...@@ -1092,10 +1203,14 @@ once(type: SensorId.PROXIMITY, callback: Callback&lt;ProximityResponse&gt;): voi
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.PROXIMITY, function(data) { try {
console.info('Distance: ' + data.distance); sensor.once(sensor.SensorId.PROXIMITY, function(data) {
} console.info('Distance: ' + data.distance);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### ROTATION_VECTOR<sup>9+</sup> ### ROTATION_VECTOR<sup>9+</sup>
...@@ -1116,13 +1231,17 @@ once(type: SensorId.ROTATION_VECTOR, callback: Callback&lt;RotationVectorRespons ...@@ -1116,13 +1231,17 @@ once(type: SensorId.ROTATION_VECTOR, callback: Callback&lt;RotationVectorRespons
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.ROTATION_VECTOR, function(data) { try {
console.info('X-coordinate component: ' + data.x); sensor.once(sensor.SensorId.ROTATION_VECTOR, function(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Scalar quantity: ' + data.w); console.info('Z-coordinate component: ' + data.z);
} console.info('Scalar quantity: ' + data.w);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### SIGNIFICANT_MOTION<sup>9+</sup> ### SIGNIFICANT_MOTION<sup>9+</sup>
...@@ -1143,10 +1262,14 @@ once(type: SensorId.SIGNIFICANT_MOTION, callback: Callback&lt;SignificantMotionR ...@@ -1143,10 +1262,14 @@ once(type: SensorId.SIGNIFICANT_MOTION, callback: Callback&lt;SignificantMotionR
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.SIGNIFICANT_MOTION, function(data) { try {
console.info('Scalar data: ' + data.scalar); sensor.once(sensor.SensorId.SIGNIFICANT_MOTION, function(data) {
} console.info('Scalar data: ' + data.scalar);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
### WEAR_DETECTION<sup>9+</sup> ### WEAR_DETECTION<sup>9+</sup>
...@@ -1167,10 +1290,14 @@ once(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse& ...@@ -1167,10 +1290,14 @@ once(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse&
**示例：** **示例：**
```js ```js
sensor.once(sensor.SensorId.WEAR_DETECTION, function(data) { try {
console.info("Wear status: "+ data.value); sensor.once(sensor.SensorId.WEAR_DETECTION, function(data) {
} console.info("Wear status: "+ data.value);
); }
);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
``` ```
## sensor.off ## sensor.off
...@@ -1195,12 +1322,16 @@ off(type: SensorId.ACCELEROMETER, callback?: Callback&lt;AccelerometerResponse&g ...@@ -1195,12 +1322,16 @@ off(type: SensorId.ACCELEROMETER, callback?: Callback&lt;AccelerometerResponse&g
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('x-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('x-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorId.ACCELEROMETER, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.ACCELEROMETER, callback);
``` ```
### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> ### ACCELEROMETER_UNCALIBRATED<sup>9+</sup>
...@@ -1223,15 +1354,19 @@ off(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback?:Callback&lt;Acceleromete ...@@ -1223,15 +1354,19 @@ off(type: SensorId.ACCELEROMETER_UNCALIBRATED,callback?:Callback&lt;Acceleromete
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('X-coordinate bias: ' + data.biasX); console.info('Z-coordinate component: ' + data.z);
console.info('Y-coordinate bias: ' + data.biasY); console.info('X-coordinate bias: ' + data.biasX);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Y-coordinate bias: ' + data.biasY);
console.info('Z-coordinate bias: ' + data.biasZ);
}
sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback);
``` ```
### AMBIENT_LIGHT<sup>9+</sup> ### AMBIENT_LIGHT<sup>9+</sup>
...@@ -1252,10 +1387,14 @@ off(type: SensorId.AMBIENT_LIGHT, callback?: Callback&lt;LightResponse&gt;): voi ...@@ -1252,10 +1387,14 @@ off(type: SensorId.AMBIENT_LIGHT, callback?: Callback&lt;LightResponse&gt;): voi
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Illumination: ' + data.intensity); function callback(data) {
console.info('Illumination: ' + data.intensity);
}
sensor.off(sensor.SensorId.AMBIENT_LIGHT, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.AMBIENT_LIGHT, callback);
``` ```
### AMBIENT_TEMPERATURE<sup>9+</sup> ### AMBIENT_TEMPERATURE<sup>9+</sup>
...@@ -1276,10 +1415,14 @@ off(type: SensorId.AMBIENT_TEMPERATURE, callback?: Callback&lt;AmbientTemperatur ...@@ -1276,10 +1415,14 @@ off(type: SensorId.AMBIENT_TEMPERATURE, callback?: Callback&lt;AmbientTemperatur
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Temperature: ' + data.temperature); function callback(data) {
console.info('Temperature: ' + data.temperature);
}
sensor.off( sensor.SensorId.AMBIENT_TEMPERATURE, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off( sensor.SensorId.AMBIENT_TEMPERATURE, callback);
``` ```
### BAROMETER<sup>9+</sup> ### BAROMETER<sup>9+</sup>
...@@ -1300,10 +1443,14 @@ off(type: SensorId.BAROMETER, callback?: Callback&lt;BarometerResponse&gt;): voi ...@@ -1300,10 +1443,14 @@ off(type: SensorId.BAROMETER, callback?: Callback&lt;BarometerResponse&gt;): voi
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Atmospheric pressure: ' + data.pressure); function callback(data) {
console.info('Atmospheric pressure: ' + data.pressure);
}
sensor.off(sensor.SensorId.BAROMETER, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.BAROMETER, callback);
``` ```
### GRAVITY<sup>9+</sup> ### GRAVITY<sup>9+</sup>
...@@ -1324,12 +1471,16 @@ off(type: SensorId.GRAVITY, callback?: Callback&lt;GravityResponse&gt;): void ...@@ -1324,12 +1471,16 @@ off(type: SensorId.GRAVITY, callback?: Callback&lt;GravityResponse&gt;): void
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off( sensor.SensorId.GRAVITY, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off( sensor.SensorId.GRAVITY, callback);
``` ```
### GYROSCOPE<sup>9+</sup> ### GYROSCOPE<sup>9+</sup>
...@@ -1352,12 +1503,16 @@ off(type: SensorId.GYROSCOPE, callback?: Callback&lt;GyroscopeResponse&gt;): voi ...@@ -1352,12 +1503,16 @@ off(type: SensorId.GYROSCOPE, callback?: Callback&lt;GyroscopeResponse&gt;): voi
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorId.GYROSCOPE, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.GYROSCOPE, callback);
``` ```
### GYROSCOPE_UNCALIBRATED<sup>9+</sup> ### GYROSCOPE_UNCALIBRATED<sup>9+</sup>
...@@ -1380,12 +1535,16 @@ off(type: SensorId.GYROSCOPE_UNCALIBRATED, callback?:Callback&lt;GyroscopeUncali ...@@ -1380,12 +1535,16 @@ off(type: SensorId.GYROSCOPE_UNCALIBRATED, callback?:Callback&lt;GyroscopeUncali
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback);
``` ```
### HALL<sup>9+</sup> ### HALL<sup>9+</sup>
...@@ -1406,10 +1565,14 @@ off(type: SensorId.HALL, callback?: Callback&lt;HallResponse&gt;): void ...@@ -1406,10 +1565,14 @@ off(type: SensorId.HALL, callback?: Callback&lt;HallResponse&gt;): void
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Status: ' + data.status); function callback(data) {
console.info('Status: ' + data.status);
}
sensor.off(sensor.SensorId.HALL, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.HALL, callback);
``` ```
### HEART_RATE<sup>9+</sup> ### HEART_RATE<sup>9+</sup>
...@@ -1432,10 +1595,14 @@ off(type: SensorId.HEART_RATE, callback?: Callback&lt;HeartRateResponse&gt;): vo ...@@ -1432,10 +1595,14 @@ off(type: SensorId.HEART_RATE, callback?: Callback&lt;HeartRateResponse&gt;): vo
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info("Heart rate: " + data.heartRate); function callback(data) {
console.info("Heart rate: " + data.heartRate);
}
sensor.off(sensor.SensorId.HEART_RATE, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.HEART_RATE, callback);
``` ```
### HUMIDITY<sup>9+</sup> ### HUMIDITY<sup>9+</sup>
...@@ -1456,10 +1623,14 @@ off(type: SensorId.HUMIDITY, callback?: Callback&lt;HumidityResponse&gt;): void ...@@ -1456,10 +1623,14 @@ off(type: SensorId.HUMIDITY, callback?: Callback&lt;HumidityResponse&gt;): void
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Humidity: ' + data.humidity); function callback(data) {
console.info('Humidity: ' + data.humidity);
}
sensor.off(sensor.SensorId.HUMIDITY, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.HUMIDITY, callback);
``` ```
### LINEAR_ACCELEROMETER<sup>9+</sup> ### LINEAR_ACCELEROMETER<sup>9+</sup>
...@@ -1482,12 +1653,16 @@ off(type: SensorId.LINEAR_ACCELEROMETER, callback?: Callback&lt;LinearAccelerome ...@@ -1482,12 +1653,16 @@ off(type: SensorId.LINEAR_ACCELEROMETER, callback?: Callback&lt;LinearAccelerome
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER, callback);
``` ```
### MAGNETIC_FIELD<sup>9+</sup> ### MAGNETIC_FIELD<sup>9+</sup>
...@@ -1508,12 +1683,16 @@ off(type: SensorId.MAGNETIC_FIELD, callback?: Callback&lt;MagneticFieldResponse& ...@@ -1508,12 +1683,16 @@ off(type: SensorId.MAGNETIC_FIELD, callback?: Callback&lt;MagneticFieldResponse&
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Z-coordinate component: ' + data.z);
}
sensor.off(sensor.SensorId.MAGNETIC_FIELD, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.MAGNETIC_FIELD, callback);
``` ```
### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> ### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup>
...@@ -1534,15 +1713,19 @@ off(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback?:Callback&lt;MagneticFie ...@@ -1534,15 +1713,19 @@ off(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED,callback?:Callback&lt;MagneticFie
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('X-coordinate bias: ' + data.biasX); console.info('Z-coordinate component: ' + data.z);
console.info('Y-coordinate bias: ' + data.biasY); console.info('X-coordinate bias: ' + data.biasX);
console.info('Z-coordinate bias: ' + data.biasZ); console.info('Y-coordinate bias: ' + data.biasY);
console.info('Z-coordinate bias: ' + data.biasZ);
}
sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback);
``` ```
### ORIENTATION<sup>9+</sup> ### ORIENTATION<sup>9+</sup>
...@@ -1563,12 +1746,16 @@ off(type: SensorId.ORIENTATION, callback?: Callback&lt;OrientationResponse&gt;): ...@@ -1563,12 +1746,16 @@ off(type: SensorId.ORIENTATION, callback?: Callback&lt;OrientationResponse&gt;):
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('The device rotates at an angle around the X axis: ' + data.beta); function callback(data) {
console.info('The device rotates at an angle around the Y axis: ' + data.gamma); console.info('The device rotates at an angle around the X axis: ' + data.beta);
console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 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.SensorId.ORIENTATION, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.ORIENTATION, callback);
``` ```
### PEDOMETER<sup>9+</sup> ### PEDOMETER<sup>9+</sup>
...@@ -1591,10 +1778,14 @@ off(type: SensorId.PEDOMETER, callback?: Callback&lt;PedometerResponse&gt;): voi ...@@ -1591,10 +1778,14 @@ off(type: SensorId.PEDOMETER, callback?: Callback&lt;PedometerResponse&gt;): voi
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Steps: ' + data.steps); function callback(data) {
console.info('Steps: ' + data.steps);
}
sensor.off(sensor.SensorId.PEDOMETER, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.PEDOMETER, callback);
``` ```
### PEDOMETER_DETECTION<sup>9+</sup> ### PEDOMETER_DETECTION<sup>9+</sup>
...@@ -1617,10 +1808,14 @@ off(type: SensorId.PEDOMETER_DETECTION, callback?: Callback&lt;PedometerDetectio ...@@ -1617,10 +1808,14 @@ off(type: SensorId.PEDOMETER_DETECTION, callback?: Callback&lt;PedometerDetectio
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Scalar data: ' + data.scalar); function callback(data) {
console.info('Scalar data: ' + data.scalar);
}
sensor.off(sensor.SensorId.PEDOMETER_DETECTION, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.PEDOMETER_DETECTION, callback);
``` ```
### PROXIMITY<sup>9+</sup> ### PROXIMITY<sup>9+</sup>
...@@ -1641,10 +1836,14 @@ off(type: SensorId.PROXIMITY, callback?: Callback&lt;ProximityResponse&gt;): voi ...@@ -1641,10 +1836,14 @@ off(type: SensorId.PROXIMITY, callback?: Callback&lt;ProximityResponse&gt;): voi
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Distance: ' + data.distance); function callback(data) {
console.info('Distance: ' + data.distance);
}
sensor.off(sensor.SensorId.PROXIMITY, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.PROXIMITY, callback);
``` ```
### ROTATION_VECTOR<sup>9+</sup> ### ROTATION_VECTOR<sup>9+</sup>
...@@ -1665,13 +1864,17 @@ off(type: SensorId.ROTATION_VECTOR, callback?: Callback&lt;RotationVectorRespons ...@@ -1665,13 +1864,17 @@ off(type: SensorId.ROTATION_VECTOR, callback?: Callback&lt;RotationVectorRespons
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('X-coordinate component: ' + data.x); function callback(data) {
console.info('Y-coordinate component: ' + data.y); console.info('X-coordinate component: ' + data.x);
console.info('Z-coordinate component: ' + data.z); console.info('Y-coordinate component: ' + data.y);
console.info('Scalar quantity: ' + data.w); console.info('Z-coordinate component: ' + data.z);
console.info('Scalar quantity: ' + data.w);
}
sensor.off(sensor.SensorId.ROTATION_VECTOR, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.ROTATION_VECTOR, callback);
``` ```
### SIGNIFICANT_MOTION<sup>9+</sup> ### SIGNIFICANT_MOTION<sup>9+</sup>
...@@ -1692,10 +1895,14 @@ off(type: SensorId.SIGNIFICANT_MOTION, callback?: Callback&lt;SignificantMotionR ...@@ -1692,10 +1895,14 @@ off(type: SensorId.SIGNIFICANT_MOTION, callback?: Callback&lt;SignificantMotionR
**示例：** **示例：**
```js ```js
function callback(data) { try {
console.info('Scalar data: ' + data.scalar); function callback(data) {
console.info('Scalar data: ' + data.scalar);
}
sensor.off(sensor.SensorId.SIGNIFICANT_MOTION, callback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.SIGNIFICANT_MOTION, callback);
``` ```
### WEAR_DETECTION<sup>9+</sup> ### WEAR_DETECTION<sup>9+</sup>
...@@ -1716,13 +1923,47 @@ off(type: SensorId.WEAR_DETECTION, callback?: Callback&lt;WearDetectionResponse& ...@@ -1716,13 +1923,47 @@ off(type: SensorId.WEAR_DETECTION, callback?: Callback&lt;WearDetectionResponse&
**示例：** **示例：**
```js ```js
function accCallback(data) { try {
console.info('Wear status: ' + data.value); function accCallback(data) {
console.info('Wear status: ' + data.value);
}
sensor.off(sensor.SensorId.WEAR_DETECTION, accCallback);
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
} }
sensor.off(sensor.SensorId.WEAR_DETECTION, accCallback);
``` ```
## sensor.on ## SensorId
表示要订阅或取消订阅的传感器类型。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor
| 名称 | 默认值 | 说明 |
| --------------------------- | ------ | ---------------------- |
| ACCELEROMETER | 1 | 加速度传感器。 |
| GYROSCOPE | 2 | 陀螺仪传感器。 |
| AMBIENT_LIGHT | 5 | 环境光传感器。 |
| MAGNETIC_FIELD | 6 | 磁场传感器。 |
| BAROMETER | 8 | 气压计传感器。 |
| HALL | 10 | 霍尔传感器。 |
| PROXIMITY | 12 | 接近光传感器。 |
| HUMIDITY | 13 | 湿度传感器。 |
| ORIENTATION | 256 | 方向传感器。 |
| GRAVITY | 257 | 重力传感器。 |
| LINEAR_ACCELEROMETER | 258 | 线性加速度传感器。 |
| ROTATION_VECTOR | 259 | 旋转矢量传感器。 |
| AMBIENT_TEMPERATURE | 260 | 环境温度传感器。 |
| MAGNETIC_FIELD_UNCALIBRATED | 261 | 未校准磁场传感器。 |
| GYROSCOPE_UNCALIBRATED | 263 | 未校准陀螺仪传感器。 |
| SIGNIFICANT_MOTION | 264 | 有效运动传感器。 |
| PEDOMETER_DETECTION | 265 | 计步检测传感器。 |
| PEDOMETER | 266 | 计步传感器。 |
| HEART_RATE | 278 | 心率传感器。 |
| WEAR_DETECTION | 280 | 佩戴检测传感器。 |
| ACCELEROMETER_UNCALIBRATED | 281 | 未校准加速度计传感器。 |
## sensor.on<sup>(deprecated)</sup>
### ACCELEROMETER<sup>(deprecated)</sup> ### ACCELEROMETER<sup>(deprecated)</sup>
...@@ -1730,7 +1971,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback&lt;Acceler ...@@ -1730,7 +1971,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback&lt;Acceler
监听加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 监听加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#accelerometer9) 从API Version9开始该接口不再维护，请使用[sensor.on.ACCELEROMETER](#accelerometer9)
**需要权限**：ohos.permission.ACCELEROMETER **需要权限**：ohos.permission.ACCELEROMETER
...@@ -1809,7 +2050,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback ...@@ -1809,7 +2050,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback
监听未校准加速度计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 监听未校准加速度计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#accelerometer_uncalibrated9) 从API Version9开始该接口不再维护，请使用 [sensor.on.ACCELEROMETER_UNCALIBRATED](#accelerometer_uncalibrated9)
**需要权限**：ohos.permission.ACCELEROMETER **需要权限**：ohos.permission.ACCELEROMETER
...@@ -1843,7 +2084,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback&lt;GravityRespons ...@@ -1843,7 +2084,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback&lt;GravityRespons
监听重力传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 监听重力传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#gravity9) 从API Version9开始该接口不再维护，请使用[sensor.on.GRAVITY](#gravity9)
**系统能力**：SystemCapability.Sensors.Sensor **系统能力**：SystemCapability.Sensors.Sensor
...@@ -1872,7 +2113,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback&lt;GyroscopeRes ...@@ -1872,7 +2113,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback&lt;GyroscopeRes
监听陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 监听陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#gyroscope9) 从API Version9开始该接口不再维护，请使用[sensor.on.GYROSCOPE](#gyroscope9)
**需要权限**：ohos.permission.GYROSCOPE **需要权限**：ohos.permission.GYROSCOPE
...@@ -1902,7 +2143,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:Callback&lt;G ...@@ -1902,7 +2143,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:Callback&lt;G
监听未校准陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 监听未校准陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#gyroscope_uncalibrated9) 从API Version9开始该接口不再维护，请使用[sensor.on.GYROSCOPE_UNCALIBRATED](#gyroscope_uncalibrated9)
**需要权限**：ohos.permission.GYROSCOPE **需要权限**：ohos.permission.GYROSCOPE
...@@ -1935,7 +2176,7 @@ on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback&lt;Sig ...@@ -1935,7 +2176,7 @@ on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback&lt;Sig
监听大幅动作传感器数据变化。如果多次调用该接口，仅最后一次调用生效。 监听大幅动作传感器数据变化。如果多次调用该接口，仅最后一次调用生效。
从API Version9开始该接口不再维护，请使用 [zh-cn/application-dev/reference/apis/js-apis-sensor.md · OpenHarmony/docs - Gitee.com](https://gitee.com/openharmony/docs/blob/e6186d7257de339c5ae79e5e1dd23d56139f7ddc/zh-cn/application-dev/reference/apis/js-apis-sensor.md#significant_motion9) 从API Version9开始该接口不再维护，请使用[sensor.on.SIGNIFICANT_MOTION](#significant_motion9)
**系统能力**：SystemCapability.Sensors.Sensor **系统能力**：SystemCapability.Sensors.Sensor
...@@ -2364,7 +2605,7 @@ on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback&lt;WearDet ...@@ -2364,7 +2605,7 @@ on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback&lt;WearDet
); );
``` ```
## sensor.once ## sensor.once<sup>(deprecated)</sup>
### ACCELEROMETER<sup>(deprecated)</sup> ### ACCELEROMETER<sup>(deprecated)</sup>
...@@ -2955,7 +3196,7 @@ once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback&lt;WearD ...@@ -2955,7 +3196,7 @@ once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback&lt;WearD
); );
``` ```
## sensor.off ## sensor.off<sup>(deprecated)</sup>
### ACCELEROMETER<sup>(deprecated)</sup> ### ACCELEROMETER<sup>(deprecated)</sup>
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或