Skip to content

D
Docs

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

通知 159
Star 292
Fork 28
D
Docs
提交 45ac3cd9 编写于 作者: C cff-gite
浏览文件
操作

修改资料 

Signed-off-by: Ncff-gite <chenfeifei8@huawei.com>
上级 2c45dba5
隐藏空白更改
内联 并排
Showing with 4 addition and 223 deletion
zh-cn/application-dev/reference/apis/js-apis-sensor.md
浏览文件 @ 45ac3cd9
......@@ -340,7 +340,7 @@ try {
on(type: SensorId.HALL, callback: Callback&lt;HallResponse&gt;, options?: Options): void
订阅心率传感器数据。
订阅霍尔传感器数据。
**系统能力**：SystemCapability.Sensors.Sensor
......@@ -372,44 +372,6 @@ try {
}
```
### HEART_RATE<sup>9+</sup>
on(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;,options?: Options): void
订阅心率传感器数据。
**需要权限**：ohos.permission.READ_HEALTH_DATA
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 要订阅的心率传感器类型为HEART_RATE。 |
| callback | Callback&lt;[HeartRateResponse](#heartrateresponse)&gt; | 是 | 注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 |
| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 |
**错误码**：
以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 14500101 | Service exception. |
**示例：**
```js
try {
sensor.on(sensor.SensorId.HEART_RATE,function(data){
console.info('Heart rate: ' + data.heartRate);
}, {interval: 10000000} );
} catch(err) {
console.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### HUMIDITY<sup>9+</sup>
on(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;,options?: Options): void
......@@ -446,47 +408,6 @@ try {
}
```
### LINEAR_ACCELERATION<sup>9+</sup>
on(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback&lt;LinearAccelerometerResponse&gt;,
options?: Options): void
订阅线性加速度传感器数据。
**需要权限**：ohos.permission.ACCELEROMETER
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 要订阅的线性加速度传感器类型为LINEAR_ACCELEROMETER。 |
| callback | Callback&lt;[LinearAccelerometerResponse](#linearaccelerometerresponse)&gt; | 是 | 注册线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 |
| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 |
**错误码**：
以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 14500101 | Service exception. |
**示例：**
```js
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.info('on fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### MAGNETIC_FIELD<sup>9+</sup>
on(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse&gt;,options?: Options): void
......@@ -799,7 +720,7 @@ try {
on(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse&gt;,
options?: Options): void
订阅磨损检测传感器数据。
订阅佩戴检测传感器数据。
**系统能力**：SystemCapability.Sensors.Sensor
......@@ -1181,44 +1102,6 @@ try {
}
```
### HEART_RATE<sup>9+</sup>
once(type: SensorId.HEART_RATE, callback: Callback&lt;HeartRateResponse&gt;): void
订阅一次心率传感器数据。
**需要权限**：ohos.permission.READ_HEALTH_DATA
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 心率传感器类型为HEART_RATE。 |
| callback | Callback&lt;[HeartRateResponse](#heartrateresponse)&gt; | 是 | 注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 |
**错误码**：
以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 14500101 | Service exception. |
**示例：**
```js
try {
sensor.once(sensor.SensorId.HEART_BEAT_RATE, function(data) {
console.info('Heart rate: ' + data.heartRate);
}
);
} catch(err) {
console.info('once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### HUMIDITY<sup>9+</sup>
once(type: SensorId.HUMIDITY, callback: Callback&lt;HumidityResponse&gt;): void
......@@ -1255,46 +1138,6 @@ try {
}
```
### LINEAR_ACCELERATION<sup>9+</sup>
once(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback&lt;LinearAccelerometerResponse&gt;): void
订阅一次线性加速度传感器数据。
**需要权限**：ohos.permission.ACCELEROMETER
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 线性加速度传感器类型为LINEAR_ACCELEROMETER。 |
| callback | Callback&lt;[LinearAccelerometerResponse](#linearaccelerometerresponse)&gt; | 是 | 注册一次线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 |
**错误码**：
以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 14500101 | Service exception. |
**示例：**
```js
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.info('once fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### MAGNETIC_FIELD<sup>9+</sup>
once(type: SensorId.MAGNETIC_FIELD, callback: Callback&lt;MagneticFieldResponse&gt;): void
......@@ -1603,7 +1446,7 @@ try {
once(type: SensorId.WEAR_DETECTION, callback: Callback&lt;WearDetectionResponse&gt;): void
订阅一次磨损检测传感器数据。
订阅一次佩戴检测传感器数据。
**系统能力**：SystemCapability.Sensors.Sensor
......@@ -1910,36 +1753,6 @@ try {
}
```
### HEART_RATE<sup>9+</sup>
off(type: SensorId.HEART_RATE, callback?: Callback&lt;HeartRateResponse&gt;): void
取消订阅心率传感器数据。
**需要权限**：ohos.permission.READ_HEALTH_DATA
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 要取消订阅的心率传感器类型为HEART_RATE。 |
| callback | Callback&lt;[HeartRateResponse](#heartrateresponse)&gt; | 是 | 取消注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 |
**示例：**
```js
try {
function callback(data) {
console.info("Heart rate: " + data.heartRate);
}
sensor.off(sensor.SensorId.HEART_RATE, callback);
} catch(err) {
console.info('off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### HUMIDITY<sup>9+</sup>
off(type: SensorId.HUMIDITY, callback?: Callback&lt;HumidityResponse&gt;): void
......@@ -1968,38 +1781,6 @@ try {
}
```
### LINEAR_ACCELEROMETER<sup>9+</sup>
off(type: SensorId.LINEAR_ACCELEROMETER, callback?: Callback&lt;LinearAccelerometerResponse&gt;): void
取消订阅线性加速度传感器数据。
**需要权限**：ohos.permission.ACCELEROMETER
**系统能力**：SystemCapability.Sensors.Sensor
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | [SensorId](#sensorid9) | 是 | 要取消订阅的线性加速度传感器类型为LINEAR_ACCELERATION。 |
| callback | Callback&lt;[LinearAccelerometerResponse](#linearaccelerometerresponse)&gt; | 是 | 取消注册性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 |
**示例：**
```js
try {
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.SensorId.LINEAR_ACCELEROMETER, callback);
} catch(err) {
console.info('off fail, errCode: ' + err.code + ' ,msg: ' + err.message);
}
```
### MAGNETIC_FIELD<sup>9+</sup>
off(type: SensorId.MAGNETIC_FIELD, callback?: Callback&lt;MagneticFieldResponse&gt;): void
......@@ -2244,7 +2025,7 @@ try {
off(type: SensorId.WEAR_DETECTION, callback?: Callback&lt;WearDetectionResponse&gt;): void
取消订阅磨损检测传感器数据。
取消订阅佩戴检测传感器数据。
**系统能力**：SystemCapability.Sensors.Sensor
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或