1# @ohos.sensor (传感器) 2 3sensor模块提供了获取传感器数据的能力，包括获取传感器属性列表，订阅传感器数据，以及一些通用的传感器算法。 4 5> **说明：** 6> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 7 8 9## 导入模块 10 11```js 12import sensor from '@ohos.sensor'; 13``` 14 15## sensor.on<sup>9+</sup> 16 17### ACCELEROMETER<sup>9+</sup> 18 19on(type: SensorId.ACCELEROMETER, callback: Callback<AccelerometerResponse>,options?: Options): void 20 21订阅加速度传感器数据。 22 23**需要权限**：ohos.permission.ACCELEROMETER 24 25**系统能力**：SystemCapability.Sensors.Sensor 26 27**参数：** 28 29| 参数名 | 类型 | 必填 | 说明 | 30| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 31| type | [SensorId](#sensorid9).ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER。 | 32| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AccelerometerResponse。 | 33| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 34 35**错误码**： 36 37以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 38 39| 错误码ID | 错误信息 | 40| -------- | ------------------ | 41| 14500101 | Service exception. | 42 43**示例：** 44 45```js 46try { 47 sensor.on(sensor.SensorId.ACCELEROMETER, function (data) { 48 console.info('X-coordinate component: ' + data.x); 49 console.info('Y-coordinate component: ' + data.y); 50 console.info('Z-coordinate component: ' + data.z); 51 }, { interval: 10000000 }); 52} catch (err) { 53 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 54} 55``` 56 57### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> 58 59on(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>,options?: Options): void 60 61订阅未校准加速度传感器数据。 62 63**需要权限**：ohos.permission.ACCELEROMETER 64 65**系统能力**：SystemCapability.Sensors.Sensor 66 67**参数：** 68 69| 参数名 | 类型 | 必填 | 说明 | 70| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 71| type | [SensorId](#sensorid9).ACCELEROMETER_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER_UNCALIBRATED。 | 72| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AccelerometerUncalibratedResponse。 | 73| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 74 75**错误码**： 76 77以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 78 79| 错误码ID | 错误信息 | 80| -------- | ------------------ | 81| 14500101 | Service exception. | 82 83**示例：** 84 85```js 86try { 87 sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, function (data) { 88 console.info('X-coordinate component: ' + data.x); 89 console.info('Y-coordinate component: ' + data.y); 90 console.info('Z-coordinate component: ' + data.z); 91 console.info('X-coordinate bias: ' + data.biasX); 92 console.info('Y-coordinate bias: ' + data.biasY); 93 console.info('Z-coordinate bias: ' + data.biasZ); 94 }, { interval: 10000000 }); 95} catch (err) { 96 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 97} 98``` 99 100### AMBIENT_LIGHT<sup>9+</sup> 101 102on(type: SensorId.AMBIENT_LIGHT, callback: Callback<LightResponse>, options?: Options): void 103 104订阅环境光传感器数据。 105 106**系统能力**：SystemCapability.Sensors.Sensor 107 108**参数：** 109 110| 参数名 | 类型 | 必填 | 说明 | 111| -------- | ----------------------------------------------- | ---- | --------------------------------------------------- | 112| type | [SensorId](#sensorid9).AMBIENT_LIGHT | 是 | 传感器类型，该值固定为SensorId.AMBIENT_LIGHT。 | 113| callback | Callback<[LightResponse](#lightresponse)> | 是 | 回调函数，异步上报的传感器数据固定为LightResponse。 | 114| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 115 116**错误码**： 117 118以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 119 120| 错误码ID | 错误信息 | 121| -------- | ------------------ | 122| 14500101 | Service exception. | 123 124**示例：** 125 126```js 127try { 128 sensor.on(sensor.SensorId.AMBIENT_LIGHT, function (data) { 129 console.info('The ambient light intensity: ' + data.intensity); 130 }, { interval: 10000000 }); 131} catch (err) { 132 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 133} 134``` 135 136### AMBIENT_TEMPERATURE<sup>9+</sup> 137 138on(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>,options?: Options): void 139 140订阅温度传感器数据。 141 142**系统能力**：SystemCapability.Sensors.Sensor 143 144**参数：** 145 146| 参数名 | 类型 | 必填 | 说明 | 147| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 148| type | [SensorId](#sensorid9).AMBIENT_TEMPERATURE | 是 | 传感器类型，该值固定为SensorId.AMBIENT_TEMPERATURE。 | 149| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AmbientTemperatureResponse。 | 150| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 151 152**错误码**： 153 154以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 155 156| 错误码ID | 错误信息 | 157| -------- | ------------------ | 158| 14500101 | Service exception. | 159 160**示例：** 161 162```js 163try { 164 sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, function (data) { 165 console.info('Temperature: ' + data.temperature); 166 }, { interval: 10000000 }); 167} catch (err) { 168 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 169} 170``` 171 172### BAROMETER<sup>9+</sup> 173 174on(type: SensorId.BAROMETER, callback: Callback<BarometerResponse>, options?: Options): void 175 176订阅气压计传感器数据。 177 178**系统能力**：SystemCapability.Sensors.Sensor 179 180**参数：** 181 182| 参数名 | 类型 | 必填 | 说明 | 183| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 184| type | [SensorId](#sensorid9).BAROMETER | 是 | 传感器类型，该值固定为SensorId.BAROMETER。 | 185| callback | Callback<[BarometerResponse](#barometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为BarometerResponse。 | 186| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 187 188**错误码**： 189 190以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 191 192| 错误码ID | 错误信息 | 193| -------- | ------------------ | 194| 14500101 | Service exception. | 195 196**示例：** 197 198```js 199try { 200 sensor.on(sensor.SensorId.BAROMETER, function (data) { 201 console.info('Atmospheric pressure: ' + data.pressure); 202 }, { interval: 10000000 }); 203} catch (err) { 204 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 205} 206``` 207 208### GRAVITY<sup>9+</sup> 209 210on(type: SensorId.GRAVITY, callback: Callback<GravityResponse>,options?: Options): void 211 212订阅重力传感器数据。 213 214**系统能力**：SystemCapability.Sensors.Sensor 215 216**参数：** 217 218| 参数名 | 类型 | 必填 | 说明 | 219| -------- | --------------------------------------------------- | ---- | ----------------------------------------------------- | 220| type | [SensorId](#sensorid9).GRAVITY | 是 | 传感器类型，该值固定为SensorId.GRAVITY。 | 221| callback | Callback<[GravityResponse](#gravityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为GravityResponse。 | 222| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 223 224**错误码**： 225 226以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 227 228| 错误码ID | 错误信息 | 229| -------- | ------------------ | 230| 14500101 | Service exception. | 231 232**示例：** 233 234```js 235try { 236 sensor.on(sensor.SensorId.GRAVITY, function (data) { 237 console.info('X-coordinate component: ' + data.x); 238 console.info('Y-coordinate component: ' + data.y); 239 console.info('Z-coordinate component: ' + data.z); 240 }, { interval: 10000000 }); 241} catch (err) { 242 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 243} 244``` 245 246### GYROSCOPE<sup>9+</sup> 247 248on(type: SensorId.GYROSCOPE, callback: Callback<GyroscopeResponse>,options?: Options): void 249 250订阅校准的陀螺仪传感器数据。 251 252**需要权限**：ohos.permission.GYROSCOPE 253 254**系统能力**：SystemCapability.Sensors.Sensor 255 256**参数：** 257 258| 参数名 | 类型 | 必填 | 说明 | 259| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 260| type | [SensorId](#sensorid9).GYROSCOPE | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE。 | 261| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 是 | 回调函数，异步上报的传感器数据固定为GyroscopeResponse。 | 262| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 263 264**错误码**： 265 266以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 267 268| 错误码ID | 错误信息 | 269| -------- | ------------------ | 270| 14500101 | Service exception. | 271 272**示例：** 273 274```js 275try { 276 sensor.on(sensor.SensorId.GYROSCOPE, function (data) { 277 console.info('X-coordinate component: ' + data.x); 278 console.info('Y-coordinate component: ' + data.y); 279 console.info('Z-coordinate component: ' + data.z); 280 }, { interval: 10000000 }); 281} catch (err) { 282 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 283} 284``` 285 286### GYROSCOPE_UNCALIBRATED<sup>9+</sup> 287 288on(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>, 289 options?: Options): void 290 291订阅未校准陀螺仪传感器数据 292 293**需要权限**：ohos.permission.GYROSCOPE 294 295**系统能力**：SystemCapability.Sensors.Sensor 296 297**参数：** 298 299| 参数名 | 类型 | 必填 | 说明 | 300| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 301| type | [SensorId](#sensorid9).GYROSCOPE_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE_UNCALIBRATED。 | 302| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为GyroscopeUncalibratedResponse。 | 303| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 304 305**错误码**： 306 307以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 308 309| 错误码ID | 错误信息 | 310| -------- | ------------------ | 311| 14500101 | Service exception. | 312 313**示例：** 314 315```js 316try { 317 sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED, function (data) { 318 console.info('X-coordinate component: ' + data.x); 319 console.info('Y-coordinate component: ' + data.y); 320 console.info('Z-coordinate component: ' + data.z); 321 console.info('X-coordinate bias: ' + data.biasX); 322 console.info('Y-coordinate bias: ' + data.biasY); 323 console.info('Z-coordinate bias: ' + data.biasZ); 324 }, { interval: 10000000 }); 325} catch (err) { 326 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 327} 328``` 329 330### HALL<sup>9+</sup> 331 332on(type: SensorId.HALL, callback: Callback<HallResponse>, options?: Options): void 333 334订阅霍尔传感器数据。 335 336**系统能力**：SystemCapability.Sensors.Sensor 337 338**参数：** 339 340| 参数名 | 类型 | 必填 | 说明 | 341| -------- | --------------------------------------------- | ---- | -------------------------------------------------- | 342| type | [SensorId](#sensorid9).HALL | 是 | 传感器类型，该值固定为SensorId.HALL。 | 343| callback | Callback<[HallResponse](#hallresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HallResponse。 | 344| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 345 346**错误码**： 347 348以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 349 350| 错误码ID | 错误信息 | 351| -------- | ------------------ | 352| 14500101 | Service exception. | 353 354**示例：** 355 356```js 357try { 358 sensor.on(sensor.SensorId.HALL, function (data) { 359 console.info('Hall status: ' + data.status); 360 }, { interval: 10000000 }); 361} catch (err) { 362 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 363} 364``` 365 366### HEART_RATE<sup>9+</sup> 367 368on(type: SensorId.HEART_RATE, callback: Callback<HeartRateResponse>,options?: Options): void 369 370订阅心率传感器数据。 371 372**需要权限**：ohos.permission.READ_HEALTH_DATA 373 374**系统能力**：SystemCapability.Sensors.Sensor 375 376**参数：** 377 378| 参数名 | 类型 | 必填 | 说明 | 379| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 380| type | [SensorId](#sensorid9).HEART_RATE | 是 | 传感器类型，该值固定为SensorId.HEART_RATE。 | 381| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HeartRateResponse。 | 382| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 383 384**错误码**： 385 386以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 387 388| 错误码ID | 错误信息 | 389| -------- | ------------------ | 390| 14500101 | Service exception. | 391 392**示例：** 393 394```js 395try { 396 sensor.on(sensor.SensorId.HEART_RATE, function (data) { 397 console.info('Heart rate: ' + data.heartRate); 398 }, { interval: 10000000 }); 399} catch (err) { 400 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 401} 402``` 403 404### HUMIDITY<sup>9+</sup> 405 406on(type: SensorId.HUMIDITY, callback: Callback<HumidityResponse>,options?: Options): void 407 408订阅湿度传感器数据。 409 410**系统能力**：SystemCapability.Sensors.Sensor 411 412**参数：** 413 414| 参数名 | 类型 | 必填 | 说明 | 415| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------ | 416| type | [SensorId](#sensorid9).HUMIDITY | 是 | 传感器类型，该值固定为SensorId.HUMIDITY。 | 417| callback | Callback<[HumidityResponse](#humidityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HumidityResponse。 | 418| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 419 420**错误码**： 421 422以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 423 424| 错误码ID | 错误信息 | 425| -------- | ------------------ | 426| 14500101 | Service exception. | 427 428**示例：** 429 430```js 431try { 432 sensor.on(sensor.SensorId.HUMIDITY, function (data) { 433 console.info('Humidity: ' + data.humidity); 434 }, { interval: 10000000 }); 435} catch (err) { 436 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 437} 438``` 439 440### LINEAR_ACCELEROMETER<sup>9+</sup> 441 442on(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback<LinearAccelerometerResponse>, 443 options?: Options): void 444 445订阅线性加速度传感器数据。 446 447**需要权限**：ohos.permission.ACCELEROMETER 448 449**系统能力**：SystemCapability.Sensors.Sensor 450 451**参数：** 452 453| 参数名 | 类型 | 必填 | 说明 | 454| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 455| type | [SensorId](#sensorid9).LINEAR_ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.LINEAR_ACCELEROMETER。 | 456| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为LinearAccelerometerResponse。 | 457| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 458 459**错误码**： 460 461以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 462 463| 错误码ID | 错误信息 | 464| -------- | ------------------ | 465| 14500101 | Service exception. | 466 467**示例：** 468 469```js 470try { 471 sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, function (data) { 472 console.info('X-coordinate component: ' + data.x); 473 console.info('Y-coordinate component: ' + data.y); 474 console.info('Z-coordinate component: ' + data.z); 475 }, { interval: 10000000 }); 476} catch (err) { 477 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 478} 479``` 480 481### MAGNETIC_FIELD<sup>9+</sup> 482 483on(type: SensorId.MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>,options?: Options): void 484 485订阅地磁传感器数据。 486 487**系统能力**：SystemCapability.Sensors.Sensor 488 489**参数：** 490 491| 参数名 | 类型 | 必填 | 说明 | 492| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 493| type | [SensorId](#sensorid9).MAGNETIC_FIELD | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD。 | 494| callback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 是 | 回调函数，异步上报的传感器数据固定为MagneticFieldResponse。 | 495| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 496 497**错误码**： 498 499以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 500 501| 错误码ID | 错误信息 | 502| -------- | ------------------ | 503| 14500101 | Service exception. | 504 505**示例：** 506 507```js 508try { 509 sensor.on(sensor.SensorId.MAGNETIC_FIELD, function (data) { 510 console.info('X-coordinate component: ' + data.x); 511 console.info('Y-coordinate component: ' + data.y); 512 console.info('Z-coordinate component: ' + data.z); 513 }, { interval: 10000000 }); 514} catch (err) { 515 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 516} 517``` 518 519### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> 520 521on(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>, options?: Options): void 522 523订阅未校准地磁传感器数据 524 525**系统能力**：SystemCapability.Sensors.Sensor 526 527**参数：** 528 529| 参数名 | 类型 | 必填 | 说明 | 530| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 531| type | [SensorId](#sensorid9).MAGNETIC_FIELD_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD_UNCALIBRATED。 | 532| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为MagneticFieldUncalibratedResponse。 | 533| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 534 535**错误码**： 536 537以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 538 539| 错误码ID | 错误信息 | 540| -------- | ------------------ | 541| 14500101 | Service exception. | 542 543**示例：** 544 545```js 546try { 547 sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, function (data) { 548 console.info('X-coordinate component: ' + data.x); 549 console.info('Y-coordinate component: ' + data.y); 550 console.info('Z-coordinate component: ' + data.z); 551 console.info('X-coordinate bias: ' + data.biasX); 552 console.info('Y-coordinate bias: ' + data.biasY); 553 console.info('Z-coordinate bias: ' + data.biasZ); 554 }, { interval: 10000000 }); 555} catch (err) { 556 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 557} 558``` 559 560### ORIENTATION<sup>9+</sup> 561 562on(type: SensorId.ORIENTATION, callback: Callback<OrientationResponse>,options?: Options): void 563 564订阅方向传感器数据。 565 566**系统能力**：SystemCapability.Sensors.Sensor 567 568**错误码**： 569 570以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 571 572| 错误码ID | 错误信息 | 573| -------- | ------------------ | 574| 14500101 | Service exception. | 575 576**参数：** 577 578| 参数名 | 类型 | 必填 | 说明 | 579| -------- | ----------------------------------------------------------- | ---- | --------------------------------------------------------- | 580| type | [SensorId](#sensorid9).ORIENTATION | 是 | 传感器类型，该值固定为SensorId.ORIENTATION。 | 581| callback | Callback<[OrientationResponse](#orientationresponse)> | 是 | 回调函数，异步上报的传感器数据固定为OrientationResponse。 | 582| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 583 584**示例：** 585 586```js 587try { 588 sensor.on(sensor.SensorId.ORIENTATION, function (data) { 589 console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 590 console.info('The device rotates at an angle around the X axis: ' + data.beta); 591 console.info('The device rotates at an angle around the Y axis: ' + data.gamma); 592 }, { interval: 10000000 }); 593} catch (err) { 594 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 595} 596``` 597 598### PEDOMETER<sup>9+</sup> 599 600on(type: SensorId.PEDOMETER, callback: Callback<PedometerResponse>, options?: Options): void 601 602订阅计步器传感器数据。 603 604**需要权限**：ohos.permission.ACTIVITY_MOTION 605 606**系统能力**：SystemCapability.Sensors.Sensor 607 608**错误码**： 609 610以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 611 612| 错误码ID | 错误信息 | 613| -------- | ------------------ | 614| 14500101 | Service exception. | 615 616**参数：** 617 618| 参数名 | 类型 | 必填 | 说明 | 619| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 620| type | [SensorId](#sensorid9).PEDOMETER | 是 | 传感器类型，该值固定为SensorId.PEDOMETER。 | 621| callback | Callback<[PedometerResponse](#pedometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为PedometerResponse。 | 622| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 623 624**示例：** 625 626```js 627try { 628 sensor.on(sensor.SensorId.PEDOMETER, function (data) { 629 console.info('Step count: ' + data.steps); 630 }, { interval: 10000000 }); 631} catch (err) { 632 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 633} 634``` 635 636### PEDOMETER_DETECTION<sup>9+</sup> 637 638on(type: SensorId.PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>, 639 options?: Options): void 640 641订阅计步检测器传感器数据。 642 643**需要权限**：ohos.permission.ACTIVITY_MOTION 644 645**系统能力**：SystemCapability.Sensors.Sensor 646 647**参数：** 648 649| 参数名 | 类型 | 必填 | 说明 | 650| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 651| type | [SensorId](#sensorid9).PEDOMETER_DETECTION | 是 | 传感器类型，该值固定为SensorId.PEDOMETER_DETECTION。 | 652| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为PedometerDetectionResponse。 | 653| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 654 655**错误码**： 656 657以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 658 659| 错误码ID | 错误信息 | 660| -------- | ------------------ | 661| 14500101 | Service exception. | 662 663**示例：** 664 665```js 666try { 667 sensor.on(sensor.SensorId.PEDOMETER_DETECTION, function (data) { 668 console.info('Pedometer scalar: ' + data.scalar); 669 }, { interval: 10000000 }); 670} catch (err) { 671 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 672} 673``` 674 675### PROXIMITY<sup>9+</sup> 676 677on(type: SensorId.PROXIMITY, callback: Callback<ProximityResponse>, options?: Options): void 678 679订阅接近光传感器数据。 680 681**系统能力**：SystemCapability.Sensors.Sensor 682 683**参数：** 684 685| 参数名 | 类型 | 必填 | 说明 | 686| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 687| type | [SensorId](#sensorid9).PROXIMITY | 是 | 传感器类型，该值固定为SensorId.PROXIMITY。 | 688| callback | Callback<[ProximityResponse](#proximityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为ProximityResponse。 | 689| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 690 691**错误码**： 692 693以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 694 695| 错误码ID | 错误信息 | 696| -------- | ------------------ | 697| 14500101 | Service exception. | 698 699**示例：** 700 701```js 702try { 703 sensor.on(sensor.SensorId.PROXIMITY, function (data) { 704 console.info('Distance: ' + data.distance); 705 }, { interval: 10000000 }); 706} catch (err) { 707 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 708} 709``` 710 711### ROTATION_VECTOR<sup>9+</sup> 712 713on(type: SensorId.ROTATION_VECTOR, callback: Callback<RotationVectorResponse>, 714 options?: Options): void 715 716订阅旋转矢量传感器数据。 717 718**系统能力**：SystemCapability.Sensors.Sensor 719 720**参数：** 721 722| 参数名 | 类型 | 必填 | 说明 | 723| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 724| type | [SensorId](#sensorid9).ROTATION_VECTOR | 是 | 传感器类型，该值固定为SensorId.ROTATION_VECTOR。 | 725| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 是 | 回调函数，异步上报的传感器数据固定为RotationVectorResponse。 | 726| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 727 728**错误码**： 729 730以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 731 732| 错误码ID | 错误信息 | 733| -------- | ------------------ | 734| 14500101 | Service exception. | 735 736**示例：** 737 738```js 739try { 740 sensor.on(sensor.SensorId.ROTATION_VECTOR, function (data) { 741 console.info('X-coordinate component: ' + data.x); 742 console.info('Y-coordinate component: ' + data.y); 743 console.info('Z-coordinate component: ' + data.z); 744 console.info('Scalar quantity: ' + data.w); 745 }, { interval: 10000000 }); 746} catch (err) { 747 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 748} 749``` 750 751### SIGNIFICANT_MOTION<sup>9+</sup> 752 753on(type: SensorId.SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>, 754 options?: Options): void 755 756订阅大幅动作检测传感器数据。 757 758**系统能力**：SystemCapability.Sensors.Sensor 759 760**参数：** 761 762| 参数名 | 类型 | 必填 | 说明 | 763| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 764| type | [SensorId](#sensorid9).SIGNIFICANT_MOTION | 是 | 传感器类型，该值固定为SensorId.SIGNIFICANT_MOTION。 | 765| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为SignificantMotionResponse。 | 766| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 767 768**错误码**： 769 770以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 771 772| 错误码ID | 错误信息 | 773| -------- | ------------------ | 774| 14500101 | Service exception. | 775 776**示例：** 777 778```js 779try { 780 sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, function (data) { 781 console.info('Scalar data: ' + data.scalar); 782 }, { interval: 10000000 }); 783} catch (err) { 784 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 785} 786``` 787 788### WEAR_DETECTION<sup>9+</sup> 789 790on(type: SensorId.WEAR_DETECTION, callback: Callback<WearDetectionResponse>, 791 options?: Options): void 792 793订阅佩戴检测传感器数据。 794 795**系统能力**：SystemCapability.Sensors.Sensor 796 797**参数：** 798 799| 参数名 | 类型 | 必填 | 说明 | 800| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 801| type | [SensorId](#sensorid9).WEAR_DETECTION | 是 | 传感器类型，该值固定为SensorId.WEAR_DETECTION。 | 802| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为WearDetectionResponse。 | 803| options | [Options](#options) | 否 | 设置上报频率，默认值为200000000ns。 | 804 805**错误码**： 806 807以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 808 809| 错误码ID | 错误信息 | 810| -------- | ------------------ | 811| 14500101 | Service exception. | 812 813**示例：** 814 815```js 816try { 817 sensor.on(sensor.SensorId.WEAR_DETECTION, function (data) { 818 console.info('Wear status: ' + data.value); 819 }, { interval: 10000000 }); 820} catch (err) { 821 console.error('On fail, errCode: ' + err.code + ' ,msg: ' + err.message); 822} 823``` 824 825## sensor.once<sup>9+</sup> 826 827### ACCELEROMETER<sup>9+</sup> 828 829once(type: SensorId.ACCELEROMETER, callback: Callback<AccelerometerResponse>): void 830 831获取一次加速度传感器数据。 832 833**需要权限**：ohos.permission.ACCELEROMETER 834 835**系统能力**：SystemCapability.Sensors.Sensor 836 837**参数：** 838 839| 参数名 | 类型 | 必填 | 说明 | 840| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 841| type | [SensorId](#sensorid9).ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER。 | 842| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AccelerometerResponse。 | 843 844**错误码**： 845 846以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 847 848| 错误码ID | 错误信息 | 849| -------- | ------------------ | 850| 14500101 | Service exception. | 851 852**示例：** 853 854```js 855try { 856 sensor.once(sensor.SensorId.ACCELEROMETER, function (data) { 857 console.info('X-coordinate component: ' + data.x); 858 console.info('Y-coordinate component: ' + data.y); 859 console.info('Z-coordinate component: ' + data.z); 860 }); 861} catch (err) { 862 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 863} 864``` 865 866### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> 867 868once(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback: Callback<AccelerometerUncalibratedResponse>): void 869 870获取一次未校准加速度传感器数据。 871 872**需要权限**：ohos.permission.ACCELEROMETER 873 874**系统能力**：SystemCapability.Sensors.Sensor 875 876**参数：** 877 878| 参数名 | 类型 | 必填 | 说明 | 879| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 880| type | [SensorId](#sensorid9).ACCELEROMETER_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER_UNCALIBRATED。 | 881| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AccelerometerUncalibratedResponse。 | 882 883**错误码**： 884 885以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 886 887| 错误码ID | 错误信息 | 888| -------- | ------------------ | 889| 14500101 | Service exception. | 890 891**示例：** 892 893```js 894try { 895 sensor.once(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, function (data) { 896 console.info('X-coordinate component: ' + data.x); 897 console.info('Y-coordinate component: ' + data.y); 898 console.info('Z-coordinate component: ' + data.z); 899 console.info('X-coordinate bias: ' + data.biasX); 900 console.info('Y-coordinate bias: ' + data.biasY); 901 console.info('Z-coordinate bias: ' + data.biasZ); 902 }); 903} catch (err) { 904 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 905} 906``` 907 908### AMBIENT_LIGHT<sup>9+</sup> 909 910once(type: SensorId.AMBIENT_LIGHT, callback: Callback<LightResponse>): void 911 912获取一次环境光传感器数据。 913 914**系统能力**：SystemCapability.Sensors.Sensor 915 916**参数：** 917 918| 参数名 | 类型 | 必填 | 说明 | 919| -------- | ----------------------------------------------- | ---- | --------------------------------------------------- | 920| type | [SensorId](#sensorid9).AMBIENT_LIGHT | 是 | 传感器类型，该值固定为SensorId.AMBIENT_LIGHT。 | 921| callback | Callback<[LightResponse](#lightresponse)> | 是 | 回调函数，异步上报的传感器数据固定为LightResponse。 | 922 923**错误码**： 924 925以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 926 927| 错误码ID | 错误信息 | 928| -------- | ------------------ | 929| 14500101 | Service exception. | 930 931**示例：** 932 933```js 934try { 935 sensor.once(sensor.SensorId.AMBIENT_LIGHT, function (data) { 936 console.info('The ambient light intensity: ' + data.intensity); 937 }); 938} catch (err) { 939 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 940} 941``` 942 943### AMBIENT_TEMPERATURE<sup>9+</sup> 944 945once(type: SensorId.AMBIENT_TEMPERATURE, callback: Callback<AmbientTemperatureResponse>): void 946 947获取一次温度传感器数据。 948 949**系统能力**：SystemCapability.Sensors.Sensor 950 951**参数：** 952 953| 参数名 | 类型 | 必填 | 说明 | 954| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 955| type | [SensorId](#sensorid9).AMBIENT_TEMPERATURE | 是 | 传感器类型，该值固定为SensorId.AMBIENT_TEMPERATURE。 | 956| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 是 | 回调函数，异步上报的传感器数据固定为AmbientTemperatureResponse。 | 957 958**错误码**： 959 960以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 961 962| 错误码ID | 错误信息 | 963| -------- | ------------------ | 964| 14500101 | Service exception. | 965 966**示例：** 967 968```js 969try { 970 sensor.once(sensor.SensorId.AMBIENT_TEMPERATURE, function (data) { 971 console.info('Temperature: ' + data.temperature); 972 }); 973} catch (err) { 974 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 975} 976``` 977 978### BAROMETER<sup>9+</sup> 979 980once(type: SensorId.BAROMETER, callback: Callback<BarometerResponse>): void 981 982获取一次气压计传感器数据。 983 984**系统能力**：SystemCapability.Sensors.Sensor 985 986**参数：** 987 988| 参数名 | 类型 | 必填 | 说明 | 989| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 990| type | [SensorId](#sensorid9).BAROMETER | 是 | 传感器类型，该值固定为SensorId.BAROMETER。 | 991| callback | Callback<[BarometerResponse](#barometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为BarometerResponse。 | 992 993**错误码**： 994 995以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 996 997| 错误码ID | 错误信息 | 998| -------- | ------------------ | 999| 14500101 | Service exception. | 1000 1001**示例：** 1002 1003```js 1004try { 1005 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function (data) { 1006 console.info('Atmospheric pressure: ' + data.pressure); 1007 }); 1008} catch (err) { 1009 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1010} 1011``` 1012 1013### GRAVITY<sup>9+</sup> 1014 1015once(type: SensorId.GRAVITY, callback: Callback<GravityResponse>): void 1016 1017获取一次重力传感器数据。 1018 1019**系统能力**：SystemCapability.Sensors.Sensor 1020 1021**参数：** 1022 1023| 参数名 | 类型 | 必填 | 说明 | 1024| -------- | --------------------------------------------------- | ---- | ----------------------------------------------------- | 1025| type | [SensorId](#sensorid9).GRAVITY | 是 | 传感器类型，该值固定为SensorId.GRAVITY。 | 1026| callback | Callback<[GravityResponse](#gravityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为GravityResponse。 | 1027 1028**错误码**： 1029 1030以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1031 1032| 错误码ID | 错误信息 | 1033| -------- | ------------------ | 1034| 14500101 | Service exception. | 1035 1036**示例：** 1037 1038```js 1039try { 1040 sensor.once(sensor.SensorId.GRAVITY, function (data) { 1041 console.info('X-coordinate component: ' + data.x); 1042 console.info('Y-coordinate component: ' + data.y); 1043 console.info('Z-coordinate component: ' + data.z); 1044 }); 1045} catch (err) { 1046 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1047} 1048``` 1049 1050### GYROSCOPE<sup>9+</sup> 1051 1052once(type: SensorId.GYROSCOPE, callback: Callback<GyroscopeResponse>): void 1053 1054获取一次陀螺仪传感器数据。 1055 1056**需要权限**：ohos.permission.GYROSCOPE 1057 1058**系统能力**：SystemCapability.Sensors.Sensor 1059 1060**参数：** 1061 1062| 参数名 | 类型 | 必填 | 说明 | 1063| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 1064| type | [SensorId](#sensorid9).GYROSCOPE | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE。 | 1065| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 是 | 回调函数，异步上报的传感器数据固定为GyroscopeResponse。 | 1066 1067**错误码**： 1068 1069以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1070 1071| 错误码ID | 错误信息 | 1072| -------- | ------------------ | 1073| 14500101 | Service exception. | 1074 1075**示例：** 1076 1077```js 1078try { 1079 sensor.once(sensor.SensorId.GYROSCOPE, function (data) { 1080 console.info('X-coordinate component: ' + data.x); 1081 console.info('Y-coordinate component: ' + data.y); 1082 console.info('Z-coordinate component: ' + data.z); 1083 }); 1084} catch (err) { 1085 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1086} 1087``` 1088 1089### GYROSCOPE_UNCALIBRATED<sup>9+</sup> 1090 1091once(type: SensorId.GYROSCOPE_UNCALIBRATED, callback: Callback<GyroscopeUncalibratedResponse>): void 1092 1093获取一次未校准陀螺仪传感器数据。 1094 1095**需要权限**：ohos.permission.GYROSCOPE 1096 1097**系统能力**：SystemCapability.Sensors.Sensor 1098 1099**参数：** 1100 1101| 参数名 | 类型 | 必填 | 说明 | 1102| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1103| type | [SensorId](#sensorid9).GYROSCOPE_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE_UNCALIBRATED。 | 1104| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为GyroscopeUncalibratedResponse。 | 1105 1106**错误码**： 1107 1108以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1109 1110| 错误码ID | 错误信息 | 1111| -------- | ------------------ | 1112| 14500101 | Service exception. | 1113 1114**示例：** 1115 1116```js 1117try { 1118 sensor.once(sensor.SensorId.GYROSCOPE_UNCALIBRATED, function (data) { 1119 console.info('X-coordinate component: ' + data.x); 1120 console.info('Y-coordinate component: ' + data.y); 1121 console.info('Z-coordinate component: ' + data.z); 1122 console.info('X-coordinate bias: ' + data.biasX); 1123 console.info('Y-coordinate bias: ' + data.biasY); 1124 console.info('Z-coordinate bias: ' + data.biasZ); 1125 }); 1126} catch (err) { 1127 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1128} 1129``` 1130 1131### HALL<sup>9+</sup> 1132 1133once(type: SensorId.HALL, callback: Callback<HallResponse>): void 1134 1135获取霍尔传感器数据。 1136 1137**系统能力**：SystemCapability.Sensors.Sensor 1138 1139**参数：** 1140 1141| 参数名 | 类型 | 必填 | 说明 | 1142| -------- | --------------------------------------------- | ---- | -------------------------------------------------- | 1143| type | [SensorId](#sensorid9).HALL | 是 | 传感器类型，该值固定为SensorId.HALL。 | 1144| callback | Callback<[HallResponse](#hallresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HallResponse。 | 1145 1146**错误码**： 1147 1148以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1149 1150| 错误码ID | 错误信息 | 1151| -------- | ------------------ | 1152| 14500101 | Service exception. | 1153 1154**示例：** 1155 1156```js 1157try { 1158 sensor.once(sensor.SensorId.HALL, function (data) { 1159 console.info('Status: ' + data.status); 1160 }); 1161} catch (err) { 1162 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1163} 1164``` 1165 1166### HEART_RATE<sup>9+</sup> 1167 1168once(type: SensorId.HEART_RATE, callback: Callback<HeartRateResponse>): void 1169 1170获取一次心率传感器数据。 1171 1172**需要权限**：ohos.permission.READ_HEALTH_DATA 1173 1174**系统能力**：SystemCapability.Sensors.Sensor 1175 1176**参数：** 1177 1178| 参数名 | 类型 | 必填 | 说明 | 1179| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 1180| type | [SensorId](#sensorid9).HEART_RATE | 是 | 传感器类型，该值固定为SensorId.HEART_RATE。 | 1181| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HeartRateResponse。 | 1182 1183**错误码**： 1184 1185以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1186 1187| 错误码ID | 错误信息 | 1188| -------- | ------------------ | 1189| 14500101 | Service exception. | 1190 1191**示例：** 1192 1193```js 1194try { 1195 sensor.once(sensor.SensorId.HEART_RATE, function (data) { 1196 console.info('Heart rate: ' + data.heartRate); 1197 }); 1198} catch (err) { 1199 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1200} 1201``` 1202 1203### HUMIDITY<sup>9+</sup> 1204 1205once(type: SensorId.HUMIDITY, callback: Callback<HumidityResponse>): void 1206 1207获取一次湿度传感器数据。 1208 1209**系统能力**：SystemCapability.Sensors.Sensor 1210 1211**参数：** 1212 1213| 参数名 | 类型 | 必填 | 说明 | 1214| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------ | 1215| type | [SensorId](#sensorid9).HUMIDITY | 是 | 传感器类型，该值固定为SensorId.HUMIDITY。 | 1216| callback | Callback<[HumidityResponse](#humidityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为HumidityResponse。 | 1217 1218**错误码**： 1219 1220以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1221 1222| 错误码ID | 错误信息 | 1223| -------- | ------------------ | 1224| 14500101 | Service exception. | 1225 1226**示例：** 1227 1228```js 1229try { 1230 sensor.once(sensor.SensorId.HUMIDITY, function (data) { 1231 console.info('Humidity: ' + data.humidity); 1232 }); 1233} catch (err) { 1234 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1235} 1236``` 1237 1238### LINEAR_ACCELEROMETER<sup>9+</sup> 1239 1240once(type: SensorId.LINEAR_ACCELEROMETER, callback: Callback<LinearAccelerometerResponse>): void 1241 1242获取一次线性加速度传感器数据。 1243 1244**需要权限**：ohos.permission.ACCELEROMETER 1245 1246**系统能力**：SystemCapability.Sensors.Sensor 1247 1248**参数：** 1249 1250| 参数名 | 类型 | 必填 | 说明 | 1251| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1252| type | [SensorId](#sensorid9).LINEAR_ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.LINEAR_ACCELEROMETER。 | 1253| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为LinearAccelerometerResponse。 | 1254 1255**错误码**： 1256 1257以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1258 1259| 错误码ID | 错误信息 | 1260| -------- | ------------------ | 1261| 14500101 | Service exception. | 1262 1263**示例：** 1264 1265```js 1266try { 1267 sensor.once(sensor.SensorId.LINEAR_ACCELEROMETER, function (data) { 1268 console.info('X-coordinate component: ' + data.x); 1269 console.info('Y-coordinate component: ' + data.y); 1270 console.info('Z-coordinate component: ' + data.z); 1271 }); 1272} catch (err) { 1273 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1274} 1275``` 1276 1277### MAGNETIC_FIELD<sup>9+</sup> 1278 1279once(type: SensorId.MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>): void 1280 1281获取一次磁场传感器数据。 1282 1283**系统能力**：SystemCapability.Sensors.Sensor 1284 1285**参数：** 1286 1287| 参数名 | 类型 | 必填 | 说明 | 1288| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 1289| type | [SensorId](#sensorid9).MAGNETIC_FIELD | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD。 | 1290| callback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 是 | 回调函数，异步上报的传感器数据固定为MagneticFieldResponse。 | 1291 1292**错误码**： 1293 1294以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1295 1296| 错误码ID | 错误信息 | 1297| -------- | ------------------ | 1298| 14500101 | Service exception. | 1299 1300**示例：** 1301 1302```js 1303try { 1304 sensor.once(sensor.SensorId.MAGNETIC_FIELD, function (data) { 1305 console.info('X-coordinate component: ' + data.x); 1306 console.info('Y-coordinate component: ' + data.y); 1307 console.info('Z-coordinate component: ' + data.z); 1308 }); 1309} catch (err) { 1310 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1311} 1312``` 1313 1314### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> 1315 1316once(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback: Callback<MagneticFieldUncalibratedResponse>): void 1317 1318获取一次未经校准的磁场传感器数据。 1319 1320**系统能力**：SystemCapability.Sensors.Sensor 1321 1322**参数：** 1323 1324| 参数名 | 类型 | 必填 | 说明 | 1325| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1326| type | [SensorId](#sensorid9).MAGNETIC_FIELD_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD_UNCALIBRATED。 | 1327| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 是 | 回调函数，异步上报的传感器数据固定为MagneticFieldUncalibratedResponse。 | 1328 1329**错误码**： 1330 1331以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1332 1333| 错误码ID | 错误信息 | 1334| -------- | ------------------ | 1335| 14500101 | Service exception. | 1336 1337**示例：** 1338 1339```js 1340try { 1341 sensor.once(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, function (data) { 1342 console.info('X-coordinate component: ' + data.x); 1343 console.info('Y-coordinate component: ' + data.y); 1344 console.info('Z-coordinate component: ' + data.z); 1345 console.info('X-coordinate bias: ' + data.biasX); 1346 console.info('Y-coordinate bias: ' + data.biasY); 1347 console.info('Z-coordinate bias: ' + data.biasZ); 1348 }); 1349} catch (err) { 1350 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1351} 1352``` 1353 1354### ORIENTATION<sup>9+</sup> 1355 1356once(type: SensorId.ORIENTATION, callback: Callback<OrientationResponse>): void 1357 1358获取一次方向传感器数据。 1359 1360**系统能力**：SystemCapability.Sensors.Sensor 1361 1362**参数：** 1363 1364| 参数名 | 类型 | 必填 | 说明 | 1365| -------- | ----------------------------------------------------------- | ---- | --------------------------------------------------------- | 1366| type | [SensorId](#sensorid9).ORIENTATION | 是 | 传感器类型，该值固定为SensorId.ORIENTATION。 | 1367| callback | Callback<[OrientationResponse](#orientationresponse)> | 是 | 回调函数，异步上报的传感器数据固定为OrientationResponse。 | 1368 1369**错误码**： 1370 1371以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1372 1373| 错误码ID | 错误信息 | 1374| -------- | ------------------ | 1375| 14500101 | Service exception. | 1376 1377**示例：** 1378 1379```js 1380try { 1381 sensor.once(sensor.SensorId.ORIENTATION, function (data) { 1382 console.info('The device rotates at an angle around the X axis: ' + data.beta); 1383 console.info('The device rotates at an angle around the Y axis: ' + data.gamma); 1384 console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 1385 }); 1386} catch (err) { 1387 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1388} 1389``` 1390 1391### PEDOMETER<sup>9+</sup> 1392 1393once(type: SensorId.PEDOMETER, callback: Callback<PedometerResponse>): void 1394 1395获取一次计步器传感器数据。 1396 1397**需要权限**：ohos.permission.ACTIVITY_MOTION 1398 1399**系统能力**：SystemCapability.Sensors.Sensor 1400 1401**参数：** 1402 1403| 参数名 | 类型 | 必填 | 说明 | 1404| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 1405| type | [SensorId](#sensorid9).PEDOMETER | 是 | 传感器类型，该值固定为SensorId.PEDOMETER。 | 1406| callback | Callback<[PedometerResponse](#pedometerresponse)> | 是 | 回调函数，异步上报的传感器数据固定为PedometerResponse。 | 1407 1408**错误码**： 1409 1410以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1411 1412| 错误码ID | 错误信息 | 1413| -------- | ------------------ | 1414| 14500101 | Service exception. | 1415 1416**示例：** 1417 1418```js 1419try { 1420 sensor.once(sensor.SensorId.PEDOMETER, function (data) { 1421 console.info('Step count: ' + data.steps); 1422 }); 1423} catch (err) { 1424 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1425} 1426``` 1427 1428### PEDOMETER_DETECTION<sup>9+</sup> 1429 1430once(type: SensorId.PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>): void 1431 1432获取一次计步检测器传感器数据。 1433 1434**需要权限**：ohos.permission.ACTIVITY_MOTION 1435 1436**系统能力**：SystemCapability.Sensors.Sensor 1437 1438**参数：** 1439 1440| 参数名 | 类型 | 必填 | 说明 | 1441| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1442| type | [SensorId](#sensorid9).PEDOMETER_DETECTION | 是 | 传感器类型，该值固定为SensorId.PEDOMETER_DETECTION。 | 1443| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为PedometerDetectionResponse。 | 1444 1445**错误码**： 1446 1447以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1448 1449| 错误码ID | 错误信息 | 1450| -------- | ------------------ | 1451| 14500101 | Service exception. | 1452 1453**示例：** 1454 1455```js 1456try { 1457 sensor.once(sensor.SensorId.PEDOMETER_DETECTION, function (data) { 1458 console.info('Scalar data: ' + data.scalar); 1459 }); 1460} catch (err) { 1461 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1462} 1463``` 1464 1465### PROXIMITY<sup>9+</sup> 1466 1467once(type: SensorId.PROXIMITY, callback: Callback<ProximityResponse>): void 1468 1469获取一次接近光传感器数据。 1470 1471**系统能力**：SystemCapability.Sensors.Sensor 1472 1473**参数：** 1474 1475| 参数名 | 类型 | 必填 | 说明 | 1476| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------- | 1477| type | [SensorId](#sensorid9).PROXIMITY | 是 | 传感器类型，该值固定为SensorId.PROXIMITY。 | 1478| callback | Callback<[ProximityResponse](#proximityresponse)> | 是 | 回调函数，异步上报的传感器数据固定为ProximityResponse。 | 1479 1480**错误码**： 1481 1482以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1483 1484| 错误码ID | 错误信息 | 1485| -------- | ------------------ | 1486| 14500101 | Service exception. | 1487 1488**示例：** 1489 1490```js 1491try { 1492 sensor.once(sensor.SensorId.PROXIMITY, function (data) { 1493 console.info('Distance: ' + data.distance); 1494 }); 1495} catch (err) { 1496 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1497} 1498``` 1499 1500### ROTATION_VECTOR<sup>9+</sup> 1501 1502once(type: SensorId.ROTATION_VECTOR, callback: Callback<RotationVectorResponse>): void 1503 1504获取一次旋转矢量传感器数据。 1505 1506**系统能力**：SystemCapability.Sensors.Sensor 1507 1508**参数：** 1509 1510| 参数名 | 类型 | 必填 | 说明 | 1511| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1512| type | [SensorId](#sensorid9).ROTATION_VECTOR | 是 | 传感器类型，该值固定为SensorId.ROTATION_VECTOR。 | 1513| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 是 | 回调函数，异步上报的传感器数据固定为RotationVectorResponse。 | 1514 1515**错误码**： 1516 1517以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1518 1519| 错误码ID | 错误信息 | 1520| -------- | ------------------ | 1521| 14500101 | Service exception. | 1522 1523**示例：** 1524 1525```js 1526try { 1527 sensor.once(sensor.SensorId.ROTATION_VECTOR, function (data) { 1528 console.info('X-coordinate component: ' + data.x); 1529 console.info('Y-coordinate component: ' + data.y); 1530 console.info('Z-coordinate component: ' + data.z); 1531 console.info('Scalar quantity: ' + data.w); 1532 }); 1533} catch (err) { 1534 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1535} 1536``` 1537 1538### SIGNIFICANT_MOTION<sup>9+</sup> 1539 1540once(type: SensorId.SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>): void 1541 1542获取一次大幅动作检测传感器数据。 1543 1544**系统能力**：SystemCapability.Sensors.Sensor 1545 1546**参数：** 1547 1548| 参数名 | 类型 | 必填 | 说明 | 1549| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1550| type | [SensorId](#sensorid9).SIGNIFICANT_MOTION | 是 | 传感器类型，该值固定为SensorId.SIGNIFICANT_MOTION。 | 1551| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为SignificantMotionResponse。 | 1552 1553**错误码**： 1554 1555以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1556 1557| 错误码ID | 错误信息 | 1558| -------- | ------------------ | 1559| 14500101 | Service exception. | 1560 1561**示例：** 1562 1563```js 1564try { 1565 sensor.once(sensor.SensorId.SIGNIFICANT_MOTION, function (data) { 1566 console.info('Scalar data: ' + data.scalar); 1567 }); 1568} catch (err) { 1569 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1570} 1571``` 1572 1573### WEAR_DETECTION<sup>9+</sup> 1574 1575once(type: SensorId.WEAR_DETECTION, callback: Callback<WearDetectionResponse>): void 1576 1577获取一次佩戴检测传感器数据。 1578 1579**系统能力**：SystemCapability.Sensors.Sensor 1580 1581**参数：** 1582 1583| 参数名 | 类型 | 必填 | 说明 | 1584| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- | 1585| type | [SensorId](#sensorid9).WEAR_DETECTION | 是 | 传感器类型，该值固定为SensorId.WEAR_DETECTION。 | 1586| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 是 | 回调函数，异步上报的传感器数据固定为WearDetectionResponse。 | 1587 1588**错误码**： 1589 1590以下错误码的详细介绍请参见 [ohos.sensor(传感器)错误码](../errorcodes/errorcode-sensor.md)。 1591 1592| 错误码ID | 错误信息 | 1593| -------- | ------------------ | 1594| 14500101 | Service exception. | 1595 1596**示例：** 1597 1598```js 1599try { 1600 sensor.once(sensor.SensorId.WEAR_DETECTION, function (data) { 1601 console.info("Wear status: " + data.value); 1602 }); 1603} catch (err) { 1604 console.error('Once fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1605} 1606``` 1607 1608## sensor.off<sup>9+</sup> 1609 1610### ACCELEROMETER<sup>9+</sup> 1611 1612off(type: SensorId.ACCELEROMETER, callback?: Callback<AccelerometerResponse>): void 1613 1614取消订阅加速度传感器数据。 1615 1616**需要权限**：ohos.permission.ACCELEROMETER 1617 1618**系统能力**：SystemCapability.Sensors.Sensor 1619 1620**参数：** 1621 1622| 参数名 | 类型 | 必填 | 说明 | 1623| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1624| type | [SensorId](#sensorid9).ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER。 | 1625| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1626 1627**示例：** 1628 1629```js 1630function callback1(data) { 1631 console.info('Callback1 data: ' + JSON.stringify(data)); 1632} 1633function callback2(data) { 1634 console.info('Callback2 data: ' + JSON.stringify(data)); 1635} 1636try { 1637 sensor.on(sensor.SensorId.ACCELEROMETER, callback1); 1638 sensor.on(sensor.SensorId.ACCELEROMETER, callback2); 1639 // 仅取消callback1的注册 1640 sensor.off(sensor.SensorId.ACCELEROMETER, callback1); 1641 // 取消SensorId.ACCELEROMETER类型的所有回调 1642 sensor.off(sensor.SensorId.ACCELEROMETER); 1643} catch (err) { 1644 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1645} 1646``` 1647 1648### ACCELEROMETER_UNCALIBRATED<sup>9+</sup> 1649 1650off(type: SensorId.ACCELEROMETER_UNCALIBRATED, callback?: Callback<AccelerometerUncalibratedResponse>): void 1651 1652取消订阅未校准加速度传感器数据。 1653 1654**需要权限**：ohos.permission.ACCELEROMETER 1655 1656**系统能力**：SystemCapability.Sensors.Sensor 1657 1658**参数：** 1659 1660| 参数名 | 类型 | 必填 | 说明 | 1661| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1662| type | [SensorId](#sensorid9).ACCELEROMETER_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.ACCELEROMETER_UNCALIBRATED。 | 1663| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1664 1665**示例：** 1666 1667```js 1668function callback1(data) { 1669 console.info('Callback1 data: ' + JSON.stringify(data)); 1670} 1671function callback2(data) { 1672 console.info('Callback2 data: ' + JSON.stringify(data)); 1673} 1674try { 1675 sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback1); 1676 sensor.on(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback2); 1677 // 仅取消callback1的注册 1678 sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED, callback1); 1679 // 取消注册SensorId.ACCELEROMETER_UNCALIBRATED类型的所有回调 1680 sensor.off(sensor.SensorId.ACCELEROMETER_UNCALIBRATED); 1681} catch (err) { 1682 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1683} 1684``` 1685 1686### AMBIENT_LIGHT<sup>9+</sup> 1687 1688off(type: SensorId.AMBIENT_LIGHT, callback?: Callback<LightResponse>): void 1689 1690取消订阅环境光传感器数据。 1691 1692**系统能力**：SystemCapability.Sensors.Sensor 1693 1694**参数：** 1695 1696| 参数名 | 类型 | 必填 | 说明 | 1697| -------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ | 1698| type | [SensorId](#sensorid9).AMBIENT_LIGHT | 是 | 传感器类型，该值固定为SensorId.AMBIENT_LIGHT。 | 1699| callback | Callback<[LightResponse](#lightresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1700 1701**示例：** 1702 1703```js 1704function callback1(data) { 1705 console.info('Callback1 data: ' + JSON.stringify(data)); 1706} 1707function callback2(data) { 1708 console.info('Callback2 data: ' + JSON.stringify(data)); 1709} 1710try { 1711 sensor.on(sensor.SensorId.AMBIENT_LIGHT, callback1); 1712 sensor.on(sensor.SensorId.AMBIENT_LIGHT, callback2); 1713 // 仅取消callback1的注册 1714 sensor.off(sensor.SensorId.AMBIENT_LIGHT, callback1); 1715 // 取消注册SensorId.AMBIENT_LIGHT的所有回调 1716 sensor.off(sensor.SensorId.AMBIENT_LIGHT); 1717} catch (err) { 1718 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1719} 1720``` 1721 1722### AMBIENT_TEMPERATURE<sup>9+</sup> 1723 1724off(type: SensorId.AMBIENT_TEMPERATURE, callback?: Callback<AmbientTemperatureResponse>): void 1725 1726取消订阅温度传感器数据。 1727 1728**系统能力**：SystemCapability.Sensors.Sensor 1729 1730**参数：** 1731 1732| 参数名 | 类型 | 必填 | 说明 | 1733| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1734| type | [SensorId](#sensorid9).AMBIENT_TEMPERATURE | 是 | 传感器类型，该值固定为SensorId.AMBIENT_TEMPERATURE。 | 1735| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1736 1737**示例：** 1738 1739```js 1740function callback1(data) { 1741 console.info('Callback1 data: ' + JSON.stringify(data)); 1742} 1743function callback2(data) { 1744 console.info('Callback2 data: ' + JSON.stringify(data)); 1745} 1746try { 1747 sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, callback1); 1748 sensor.on(sensor.SensorId.AMBIENT_TEMPERATURE, callback2); 1749 // 仅取消callback1的注册 1750 sensor.off(sensor.SensorId.AMBIENT_TEMPERATURE, callback1); 1751 // 取消注册SensorId.AMBIENT_TEMPERATURE的所有回调 1752 sensor.off(sensor.SensorId.AMBIENT_TEMPERATURE); 1753} catch (err) { 1754 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1755} 1756``` 1757 1758### BAROMETER<sup>9+</sup> 1759 1760off(type: SensorId.BAROMETER, callback?: Callback<BarometerResponse>): void 1761 1762取消订阅气压计传感器数据。 1763 1764**系统能力**：SystemCapability.Sensors.Sensor 1765 1766**参数：** 1767 1768| 参数名 | 类型 | 必填 | 说明 | 1769| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 1770| type | [SensorId](#sensorid9).BAROMETER | 是 | 传感器类型，该值固定为SensorId.BAROMETER。 | 1771| callback | Callback<[BarometerResponse](#barometerresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1772 1773**示例：** 1774 1775```js 1776function callback1(data) { 1777 console.info('Callback1 data: ' + JSON.stringify(data)); 1778} 1779function callback2(data) { 1780 console.info('Callback2 data: ' + JSON.stringify(data)); 1781} 1782try { 1783 sensor.on(sensor.SensorId.BAROMETER, callback1); 1784 sensor.on(sensor.SensorId.BAROMETER, callback2); 1785 // 仅取消callback1的注册 1786 sensor.off(sensor.SensorId.BAROMETER, callback1); 1787 // 取消注册SensorId.BAROMETER的所有回调 1788 sensor.off(sensor.SensorId.BAROMETER); 1789} catch (err) { 1790 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1791} 1792``` 1793 1794### GRAVITY<sup>9+</sup> 1795 1796off(type: SensorId.GRAVITY, callback?: Callback<GravityResponse>): void 1797 1798取消订阅重力传感器数据。 1799 1800**系统能力**：SystemCapability.Sensors.Sensor 1801 1802**参数：** 1803 1804| 参数名 | 类型 | 必填 | 说明 | 1805| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ | 1806| type | [SensorId](#sensorid9).GRAVITY | 是 | 传感器类型，该值固定为SensorId.GRAVITY。 | 1807| callback | Callback<[GravityResponse](#gravityresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1808 1809**示例：** 1810 1811```js 1812function callback1(data) { 1813 console.info('Callback1 data: ' + JSON.stringify(data)); 1814} 1815function callback2(data) { 1816 console.info('Callback2 data: ' + JSON.stringify(data)); 1817} 1818try { 1819 sensor.on(sensor.SensorId.GRAVITY, callback1); 1820 sensor.on(sensor.SensorId.GRAVITY, callback2); 1821 // 仅取消callback1的注册 1822 sensor.off(sensor.SensorId.GRAVITY, callback1); 1823 // 取消注册SensorId.GRAVITY的所有回调 1824 sensor.off(sensor.SensorId.GRAVITY); 1825} catch (err) { 1826 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1827} 1828``` 1829 1830### GYROSCOPE<sup>9+</sup> 1831 1832off(type: SensorId.GYROSCOPE, callback?: Callback<GyroscopeResponse>): void 1833 1834取消订阅陀螺仪传感器数据。 1835 1836**需要权限**：ohos.permission.GYROSCOPE 1837 1838**系统能力**：SystemCapability.Sensors.Sensor 1839 1840**参数：** 1841 1842| 参数名 | 类型 | 必填 | 说明 | 1843| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 1844| type | [SensorId](#sensorid9).GYROSCOPE | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE。 | 1845| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1846 1847**示例：** 1848 1849```js 1850function callback1(data) { 1851 console.info('Callback1 data: ' + JSON.stringify(data)); 1852} 1853function callback2(data) { 1854 console.info('Callback2 data: ' + JSON.stringify(data)); 1855} 1856try { 1857 sensor.on(sensor.SensorId.GYROSCOPE, callback1); 1858 sensor.on(sensor.SensorId.GYROSCOPE, callback2); 1859 // 仅取消callback1的注册 1860 sensor.off(sensor.SensorId.GYROSCOPE, callback1); 1861 // 取消注册SensorId.GYROSCOPE的所有回调 1862 sensor.off(sensor.SensorId.GYROSCOPE); 1863} catch (err) { 1864 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1865} 1866``` 1867 1868### GYROSCOPE_UNCALIBRATED<sup>9+</sup> 1869 1870off(type: SensorId.GYROSCOPE_UNCALIBRATED, callback?: Callback<GyroscopeUncalibratedResponse>): void 1871 1872 取消订阅未校准陀螺仪传感器数据。 1873 1874**需要权限**：ohos.permission.GYROSCOPE 1875 1876**系统能力**：SystemCapability.Sensors.Sensor 1877 1878**参数：** 1879 1880| 参数名 | 类型 | 必填 | 说明 | 1881| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1882| type | [SensorId](#sensorid9).GYROSCOPE_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.GYROSCOPE_UNCALIBRATED。 | 1883| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1884 1885**示例：** 1886 1887```js 1888function callback1(data) { 1889 console.info('Callback1 data: ' + JSON.stringify(data)); 1890} 1891function callback2(data) { 1892 console.info('Callback2 data: ' + JSON.stringify(data)); 1893} 1894try { 1895 sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback1); 1896 sensor.on(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback2); 1897 // 仅取消callback1的注册 1898 sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED, callback1); 1899 // 取消注册SensorId.GYROSCOPE_UNCALIBRATED的所有回调 1900 sensor.off(sensor.SensorId.GYROSCOPE_UNCALIBRATED); 1901} catch (err) { 1902 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1903} 1904``` 1905 1906### HALL<sup>9+</sup> 1907 1908off(type: SensorId.HALL, callback?: Callback<HallResponse>): void 1909 1910取消订阅霍尔传感器数据。 1911 1912**系统能力**：SystemCapability.Sensors.Sensor 1913 1914**参数：** 1915 1916| 参数名 | 类型 | 必填 | 说明 | 1917| -------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | 1918| type | [SensorId](#sensorid9).HALL | 是 | 传感器类型，该值固定为SensorId.HALL。 | 1919| callback | Callback<[HallResponse](#hallresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1920 1921**示例：** 1922 1923```js 1924function callback1(data) { 1925 console.info('Callback1 data: ' + JSON.stringify(data)); 1926} 1927function callback2(data) { 1928 console.info('Callback2 data: ' + JSON.stringify(data)); 1929} 1930try { 1931 sensor.on(sensor.SensorId.HALL, callback1); 1932 sensor.on(sensor.SensorId.HALL, callback2); 1933 // 仅取消callback1的注册 1934 sensor.off(sensor.SensorId.HALL, callback1); 1935 // 取消注册SensorId.HALL的所有回调 1936 sensor.off(sensor.SensorId.HALL); 1937} catch (err) { 1938 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1939} 1940``` 1941 1942### HEART_RATE<sup>9+</sup> 1943 1944off(type: SensorId.HEART_RATE, callback?: Callback<HeartRateResponse>): void 1945 1946取消订阅心率传感器数据。 1947 1948**需要权限**：ohos.permission.READ_HEALTH_DATA 1949 1950**系统能力**：SystemCapability.Sensors.Sensor 1951 1952**参数：** 1953 1954| 参数名 | 类型 | 必填 | 说明 | 1955| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 1956| type | [SensorId](#sensorid9).HEART_RATE | 是 | 传感器类型，该值固定为SensorId.HEART_RATE。 | 1957| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1958 1959**示例：** 1960 1961```js 1962function callback1(data) { 1963 console.info('Callback1 data: ' + JSON.stringify(data)); 1964} 1965function callback2(data) { 1966 console.info('Callback2 data: ' + JSON.stringify(data)); 1967} 1968try { 1969 sensor.on(sensor.SensorId.HEART_RATE, callback1); 1970 sensor.on(sensor.SensorId.HEART_RATE, callback2); 1971 // 仅取消callback1的注册 1972 sensor.off(sensor.SensorId.HEART_RATE, callback1); 1973 // 取消注册SensorId.HEART_RATE的所有回调 1974 sensor.off(sensor.SensorId.HEART_RATE); 1975} catch (err) { 1976 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 1977} 1978``` 1979 1980### HUMIDITY<sup>9+</sup> 1981 1982off(type: SensorId.HUMIDITY, callback?: Callback<HumidityResponse>): void 1983 1984取消订阅湿度传感器数据。 1985 1986**系统能力**：SystemCapability.Sensors.Sensor 1987 1988**参数：** 1989 1990| 参数名 | 类型 | 必填 | 说明 | 1991| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | 1992| type | [SensorId](#sensorid9).HUMIDITY | 是 | 传感器类型，该值固定为SensorId.HUMIDITY。 | 1993| callback | Callback<[HumidityResponse](#humidityresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 1994 1995**示例：** 1996 1997```js 1998function callback1(data) { 1999 console.info('Callback1 data: ' + JSON.stringify(data)); 2000} 2001function callback2(data) { 2002 console.info('Callback2 data: ' + JSON.stringify(data)); 2003} 2004try { 2005 sensor.on(sensor.SensorId.HUMIDITY, callback1); 2006 sensor.on(sensor.SensorId.HUMIDITY, callback2); 2007 // 仅取消callback1的注册 2008 sensor.off(sensor.SensorId.HUMIDITY, callback1); 2009 // 取消注册SensorId.HUMIDITY的所有回调 2010 sensor.off(sensor.SensorId.HUMIDITY); 2011} catch (err) { 2012 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2013} 2014``` 2015 2016### LINEAR_ACCELEROMETER<sup>9+</sup> 2017 2018off(type: SensorId.LINEAR_ACCELEROMETER, callback?: Callback<LinearAccelerometerResponse>): void 2019 2020取消订阅线性加速度传感器数据。 2021 2022**需要权限**：ohos.permission.ACCELEROMETER 2023 2024**系统能力**：SystemCapability.Sensors.Sensor 2025 2026**参数：** 2027 2028| 参数名 | 类型 | 必填 | 说明 | 2029| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2030| type | [SensorId](#sensorid9).LINEAR_ACCELEROMETER | 是 | 传感器类型，该值固定为SensorId.LINEAR_ACCELERATION。 | 2031| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2032 2033**示例：** 2034 2035```js 2036function callback1(data) { 2037 console.info('Callback1 data: ' + JSON.stringify(data)); 2038} 2039function callback2(data) { 2040 console.info('Callback2 data: ' + JSON.stringify(data)); 2041} 2042try { 2043 sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, callback1); 2044 sensor.on(sensor.SensorId.LINEAR_ACCELEROMETER, callback2); 2045 // 仅取消callback1的注册 2046 sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER, callback1); 2047 // 取消注册SensorId.LINEAR_ACCELEROMETER的所有回调 2048 sensor.off(sensor.SensorId.LINEAR_ACCELEROMETER); 2049} catch (err) { 2050 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2051} 2052``` 2053 2054### MAGNETIC_FIELD<sup>9+</sup> 2055 2056off(type: SensorId.MAGNETIC_FIELD, callback?: Callback<MagneticFieldResponse>): void 2057 2058取消订阅磁场传感器数据。 2059 2060**系统能力**：SystemCapability.Sensors.Sensor 2061 2062**参数：** 2063 2064| 参数名 | 类型 | 必填 | 说明 | 2065| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2066| type | [SensorId](#sensorid9).MAGNETIC_FIELD | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD。 | 2067| callback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2068 2069**示例：** 2070 2071```js 2072function callback1(data) { 2073 console.info('Callback1 data: ' + JSON.stringify(data)); 2074} 2075function callback2(data) { 2076 console.info('Callback2 data: ' + JSON.stringify(data)); 2077} 2078try { 2079 sensor.on(sensor.SensorId.MAGNETIC_FIELD, callback1); 2080 sensor.on(sensor.SensorId.MAGNETIC_FIELD, callback2); 2081 // 仅取消callback1的注册 2082 sensor.off(sensor.SensorId.MAGNETIC_FIELD, callback1); 2083 // 取消注册SensorId.MAGNETIC_FIELD的所有回调 2084 sensor.off(sensor.SensorId.MAGNETIC_FIELD); 2085} catch (err) { 2086 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2087} 2088``` 2089 2090### MAGNETIC_FIELD_UNCALIBRATED<sup>9+</sup> 2091 2092off(type: SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback?: Callback<MagneticFieldUncalibratedResponse>): void 2093 2094取消订阅未校准的磁场传感器数据。 2095 2096**系统能力**：SystemCapability.Sensors.Sensor 2097 2098**参数：** 2099 2100| 参数名 | 类型 | 必填 | 说明 | 2101| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2102| type | [SensorId](#sensorid9).MAGNETIC_FIELD_UNCALIBRATED | 是 | 传感器类型，该值固定为SensorId.MAGNETIC_FIELD_UNCALIBRATED。 | 2103| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2104 2105**示例：** 2106 2107```js 2108function callback1(data) { 2109 console.info('Callback1 data: ' + JSON.stringify(data)); 2110} 2111function callback2(data) { 2112 console.info('Callback2 data: ' + JSON.stringify(data)); 2113} 2114try { 2115 sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback1); 2116 sensor.on(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback2); 2117 // 仅取消callback1的注册 2118 sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED, callback1); 2119 // 取消注册SensorId.MAGNETIC_FIELD_UNCALIBRATED的所有回调 2120 sensor.off(sensor.SensorId.MAGNETIC_FIELD_UNCALIBRATED); 2121} catch (err) { 2122 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2123} 2124``` 2125 2126### ORIENTATION<sup>9+</sup> 2127 2128off(type: SensorId.ORIENTATION, callback?: Callback<OrientationResponse>): void 2129 2130取消订阅方向传感器数据。 2131 2132**系统能力**：SystemCapability.Sensors.Sensor 2133 2134**参数：** 2135 2136| 参数名 | 类型 | 必填 | 说明 | 2137| -------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | 2138| type | [SensorId](#sensorid9).ORIENTATION | 是 | 传感器类型，该值固定为SensorId.ORIENTATION。 | 2139| callback | Callback<[OrientationResponse](#orientationresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2140 2141**示例：** 2142 2143```js 2144function callback1(data) { 2145 console.info('Callback1 data: ' + JSON.stringify(data)); 2146} 2147function callback2(data) { 2148 console.info('Callback2 data: ' + JSON.stringify(data)); 2149} 2150try { 2151 sensor.on(sensor.SensorId.ORIENTATION, callback1); 2152 sensor.on(sensor.SensorId.ORIENTATION, callback2); 2153 // 仅取消callback1的注册 2154 sensor.off(sensor.SensorId.ORIENTATION, callback1); 2155 // 取消注册SensorId.ORIENTATION的所有回调 2156 sensor.off(sensor.SensorId.ORIENTATION); 2157} catch (err) { 2158 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2159} 2160``` 2161 2162### PEDOMETER<sup>9+</sup> 2163 2164off(type: SensorId.PEDOMETER, callback?: Callback<PedometerResponse>): void 2165 2166取消订阅计步器传感器数据。 2167 2168**需要权限**：ohos.permission.ACTIVITY_MOTION 2169 2170**系统能力**：SystemCapability.Sensors.Sensor 2171 2172**参数：** 2173 2174| 参数名 | 类型 | 必填 | 说明 | 2175| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 2176| type | [SensorId](#sensorid9).PEDOMETER | 是 | 传感器类型，该值固定为SensorId.PEDOMETER。 | 2177| callback | Callback<[PedometerResponse](#pedometerresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2178 2179**示例：** 2180 2181```js 2182function callback1(data) { 2183 console.info('Callback1 data: ' + JSON.stringify(data)); 2184} 2185function callback2(data) { 2186 console.info('Callback2 data: ' + JSON.stringify(data)); 2187} 2188try { 2189 sensor.on(sensor.SensorId.PEDOMETER, callback1); 2190 sensor.on(sensor.SensorId.PEDOMETER, callback2); 2191 // 仅取消callback1的注册 2192 sensor.off(sensor.SensorId.PEDOMETER, callback1); 2193 // 取消注册SensorId.PEDOMETER的所有回调 2194 sensor.off(sensor.SensorId.PEDOMETER); 2195} catch (err) { 2196 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2197} 2198``` 2199 2200### PEDOMETER_DETECTION<sup>9+</sup> 2201 2202off(type: SensorId.PEDOMETER_DETECTION, callback?: Callback<PedometerDetectionResponse>): void 2203 2204取消订阅计步检测器传感器数据。 2205 2206**需要权限**：ohos.permission.ACTIVITY_MOTION 2207 2208**系统能力**：SystemCapability.Sensors.Sensor 2209 2210**参数：** 2211 2212| 参数名 | 类型 | 必填 | 说明 | 2213| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2214| type | [SensorId](#sensorid9).PEDOMETER_DETECTION | 是 | 传感器类型，该值固定为SensorId.PEDOMETER_DETECTION。 | 2215| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2216 2217**示例：** 2218 2219```js 2220function callback1(data) { 2221 console.info('Callback1 data: ' + JSON.stringify(data)); 2222} 2223function callback2(data) { 2224 console.info('Callback2 data: ' + JSON.stringify(data)); 2225} 2226try { 2227 sensor.on(sensor.SensorId.PEDOMETER_DETECTION, callback1); 2228 sensor.on(sensor.SensorId.PEDOMETER_DETECTION, callback2); 2229 // 仅取消callback1的注册 2230 sensor.off(sensor.SensorId.PEDOMETER_DETECTION, callback1); 2231 // 取消注册SensorId.PEDOMETER_DETECTION的所有回调 2232 sensor.off(sensor.SensorId.PEDOMETER_DETECTION); 2233} catch (err) { 2234 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2235} 2236``` 2237 2238### PROXIMITY<sup>9+</sup> 2239 2240off(type: SensorId.PROXIMITY, callback?: Callback<ProximityResponse>): void 2241 2242取消订阅接近光传感器数据。 2243 2244**系统能力**：SystemCapability.Sensors.Sensor 2245 2246**参数：** 2247 2248| 参数名 | 类型 | 必填 | 说明 | 2249| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 2250| type | [SensorId](#sensorid9).PROXIMITY | 是 | 传感器类型，该值固定为SensorId.PROXIMITY。 | 2251| callback | Callback<[ProximityResponse](#proximityresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2252 2253**示例：** 2254 2255```js 2256function callback1(data) { 2257 console.info('Callback1 data: ' + JSON.stringify(data)); 2258} 2259function callback2(data) { 2260 console.info('Callback2 data: ' + JSON.stringify(data)); 2261} 2262try { 2263 sensor.on(sensor.SensorId.PROXIMITY, callback1); 2264 sensor.on(sensor.SensorId.PROXIMITY, callback2); 2265 // 仅取消callback1的注册 2266 sensor.off(sensor.SensorId.PROXIMITY, callback1); 2267 // 取消注册SensorId.PROXIMITY的所有回调 2268 sensor.off(sensor.SensorId.PROXIMITY); 2269} catch (err) { 2270 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2271} 2272``` 2273 2274### ROTATION_VECTOR<sup>9+</sup> 2275 2276off(type: SensorId.ROTATION_VECTOR, callback?: Callback<RotationVectorResponse>): void 2277 2278取消订阅旋转矢量传感器数据。 2279 2280**系统能力**：SystemCapability.Sensors.Sensor 2281 2282**参数：** 2283 2284| 参数名 | 类型 | 必填 | 说明 | 2285| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2286| type | [SensorId](#sensorid9).ROTATION_VECTOR | 是 | 传感器类型，该值固定为SensorId.ROTATION_VECTOR。 | 2287| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2288 2289**示例：** 2290 2291```js 2292function callback1(data) { 2293 console.info('Callback1 data: ' + JSON.stringify(data)); 2294} 2295function callback2(data) { 2296 console.info('Callback2 data: ' + JSON.stringify(data)); 2297} 2298try { 2299 sensor.on(sensor.SensorId.ROTATION_VECTOR, callback1); 2300 sensor.on(sensor.SensorId.ROTATION_VECTOR, callback2); 2301 // 仅取消callback1的注册 2302 sensor.off(sensor.SensorId.ROTATION_VECTOR, callback1); 2303 // 取消注册SensorId.ROTATION_VECTOR的所有回调 2304 sensor.off(sensor.SensorId.ROTATION_VECTOR); 2305} catch (err) { 2306 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2307} 2308``` 2309 2310### SIGNIFICANT_MOTION<sup>9+</sup> 2311 2312off(type: SensorId.SIGNIFICANT_MOTION, callback?: Callback<SignificantMotionResponse>): void 2313 2314取消大幅动作检测传感器数据。 2315 2316**系统能力**：SystemCapability.Sensors.Sensor 2317 2318**参数：** 2319 2320| 参数名 | 类型 | 必填 | 说明 | 2321| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2322| type | [SensorId](#sensorid9).SIGNIFICANT_MOTION | 是 | 传感器类型，该值固定为SensorId.SIGNIFICANT_MOTION。 | 2323| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2324 2325**示例：** 2326 2327```js 2328function callback1(data) { 2329 console.info('Callback1 data: ' + JSON.stringify(data)); 2330} 2331function callback2(data) { 2332 console.info('Callback2 data: ' + JSON.stringify(data)); 2333} 2334try { 2335 sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, callback1); 2336 sensor.on(sensor.SensorId.SIGNIFICANT_MOTION, callback2); 2337 // 仅取消callback1的注册 2338 sensor.off(sensor.SensorId.SIGNIFICANT_MOTION, callback1); 2339 // 取消注册SensorId.SIGNIFICANT_MOTION的所有回调 2340 sensor.off(sensor.SensorId.SIGNIFICANT_MOTION); 2341} catch (err) { 2342 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2343} 2344``` 2345 2346### WEAR_DETECTION<sup>9+</sup> 2347 2348off(type: SensorId.WEAR_DETECTION, callback?: Callback<WearDetectionResponse>): void 2349 2350取消订阅佩戴检测传感器数据。 2351 2352**系统能力**：SystemCapability.Sensors.Sensor 2353 2354**参数：** 2355 2356| 参数名 | 类型 | 必填 | 说明 | 2357| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 2358| type | [SensorId](#sensorid9).WEAR_DETECTION | 是 | 传感器类型，该值固定为SensorId.WEAR_DETECTION。 | 2359| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 否 | 需要取消订阅的回调函数，若无此参数，则取消订阅当前类型的所有回调函数。 | 2360 2361**示例：** 2362 2363```js 2364function callback1(data) { 2365 console.info('Callback1 data: ' + JSON.stringify(data)); 2366} 2367function callback2(data) { 2368 console.info('Callback2 data: ' + JSON.stringify(data)); 2369} 2370try { 2371 sensor.on(sensor.SensorId.WEAR_DETECTION, callback1); 2372 sensor.on(sensor.SensorId.WEAR_DETECTION, callback2); 2373 // 仅取消callback1的注册 2374 sensor.off(sensor.SensorId.WEAR_DETECTION, callback1); 2375 // 取消注册SensorId.WEAR_DETECTION的所有回调 2376 sensor.off(sensor.SensorId.WEAR_DETECTION); 2377} catch (err) { 2378 console.error('Off fail, errCode: ' + err.code + ' ,msg: ' + err.message); 2379} 2380``` 2381 2382## sensor.getGeomagneticInfo<sup>9+</sup> 2383 2384getGeomagneticInfo(locationOptions: LocationOptions, timeMillis: number, callback: AsyncCallback<GeomagneticResponse>): void 2385 2386获取某时刻地球上特定位置的地磁场信息。 2387 2388**系统能力**：SystemCapability.Sensors.Sensor 2389 2390**参数：** 2391 2392| 参数名 | 类型 | 必填 | 说明 | 2393| --------------- | ------------------------------------------------------------ | ---- | ---------------------------------- | 2394| locationOptions | [LocationOptions](#locationoptions) | 是 | 地理位置，包括经度、纬度和海拔高度。 | 2395| timeMillis | number | 是 | 获取磁偏角的时间，unix时间戳，单位毫秒。 | 2396| callback | AsyncCallback<[GeomagneticResponse](#geomagneticresponse)> | 是 | 回调函数，返回地磁场信息。 | 2397 2398**错误码**： 2399 2400以下错误码的详细介绍请参见 [sensor.getGeomagneticInfo错误码](../errorcodes/errorcode-sensor.md)。 2401 2402| 错误码ID | 错误信息 | 2403| -------- | ------------------ | 2404| 14500101 | Service exception. | 2405 2406**示例：** 2407 2408```js 2409try { 2410 sensor.getGeomagneticInfo({ latitude: 80, longitude: 0, altitude: 0 }, 1580486400000, function (err, data) { 2411 if (err) { 2412 console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message); 2413 return; 2414 } 2415 console.info("GeomagneticInfo x" + data.x); 2416 console.info("GeomagneticInfo y" + data.y); 2417 console.info("GeomagneticInfo z" + data.z); 2418 console.info("GeomagneticInfo geomagneticDip" + data.geomagneticDip); 2419 console.info("GeomagneticInfo deflectionAngle" + data.deflectionAngle); 2420 console.info("GeomagneticInfo levelIntensity" + data.levelIntensity); 2421 console.info("GeomagneticInfo totalIntensity" + data.totalIntensity); 2422 }); 2423} catch (err) { 2424 console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message); 2425} 2426``` 2427 2428## sensor.getGeomagneticInfo<sup>9+</sup> 2429 2430getGeomagneticInfo(locationOptions: LocationOptions, timeMillis: number): Promise<GeomagneticResponse> 2431 2432获取某时刻地球上特定位置的地磁场信息。 2433 2434**系统能力**：SystemCapability.Sensors.Sensor 2435 2436**参数：** 2437 2438| 参数名 | 类型 | 必填 | 说明 | 2439| --------------- | ----------------------------------- | ---- | ---------------------------------- | 2440| locationOptions | [LocationOptions](#locationoptions) | 是 | 地理位置，包括经度、纬度和海拔高度。 | 2441| timeMillis | number | 是 | 获取磁偏角的时间，unix时间戳，单位毫秒。 | 2442 2443**返回值：** 2444 2445| 类型 | 说明 | 2446| ---------------------------------------------------------- | -------------- | 2447| Promise<[GeomagneticResponse](#geomagneticresponse)> | Promise对象，返回地磁场信息。 | 2448 2449**错误码**： 2450 2451以下错误码的详细介绍请参见 [sensor.getGeomagneticInfo错误码](../errorcodes/errorcode-sensor.md)。 2452 2453| 错误码ID | 错误信息 | 2454| -------- | ------------------ | 2455| 14500101 | Service exception. | 2456 2457**示例：** 2458 2459```js 2460try { 2461 const promise = sensor.getGeomagneticInfo({ latitude: 80, longitude: 0, altitude: 0 }, 1580486400000); 2462 promise.then((data) => { 2463 console.info("GeomagneticInfo x" + data.x); 2464 console.info("GeomagneticInfo y" + data.y); 2465 console.info("GeomagneticInfo z" + data.z); 2466 console.info("GeomagneticInfo geomagneticDip" + data.geomagneticDip); 2467 console.info("GeomagneticInfo deflectionAngle" + data.deflectionAngle); 2468 console.info("GeomagneticInfo levelIntensity" + data.levelIntensity); 2469 console.info("GeomagneticInfo totalIntensity" + data.totalIntensity); 2470 }, (err)=>{ 2471 console.error('Get geomagneticInfo failed. Error code: ' + err.code + '; message: ' + err.message); 2472 }); 2473} catch (err) { 2474 console.error('Get geomagneticInfo. Error code: ' + err.code + '; message: ' + err.message); 2475} 2476``` 2477 2478## sensor.getDeviceAltitude<sup>9+</sup> 2479 2480getDeviceAltitude(seaPressure: number, currentPressure: number, callback: AsyncCallback<number>): void 2481 2482根据气压值获取海拔高度。 2483 2484**系统能力**：SystemCapability.Sensors.Sensor 2485 2486**参数：** 2487 2488| 参数名 | 类型 | 必填 | 说明 | 2489| --------------- | --------------------------- | ---- | ------------------------------------- | 2490| seaPressure | number | 是 | 海平面气压值，单位为hPa。 | 2491| currentPressure | number | 是 | 指定的气压值，单位为hPa。 | 2492| callback | AsyncCallback<number> | 是 | 回调函数，返回指定的气压值对应的海拔高度，单位为米。 | 2493 2494**错误码**： 2495 2496以下错误码的详细介绍请参见 [sensor.getDeviceAltitude错误码](../errorcodes/errorcode-sensor.md)。 2497 2498| 错误码ID | 错误信息 | 2499| -------- | ------------------ | 2500| 14500101 | Service exception. | 2501 2502**示例：** 2503 2504```js 2505try { 2506 let seaPressure = 1013.2; 2507 let currentPressure = 1500.0; 2508 sensor.getDeviceAltitude(seaPressure, currentPressure, function (err, data) { 2509 if (err) { 2510 console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message); 2511 return; 2512 } 2513 console.info('altitude: ' + data); 2514 }); 2515} catch (err) { 2516 console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message); 2517} 2518``` 2519 2520## sensor.getDeviceAltitude<sup>9+</sup> 2521 2522getDeviceAltitude(seaPressure: number, currentPressure: number): Promise<number> 2523 2524根据气压值获取海拔高度。 2525 2526**系统能力**：SystemCapability.Sensors.Sensor 2527 2528**参数：** 2529 2530| 参数名 | 类型 | 必填 | 说明 | 2531| --------------- | ------ | ---- | ------------------------------------- | 2532| seaPressure | number | 是 | 海平面气压值，单位为hPa。 | 2533| currentPressure | number | 是 | 指定的气压值，单位为hPa。 | 2534 2535**返回值：** 2536 2537| 类型 | 说明 | 2538| --------------------- | ------------------------------------ | 2539| Promise<number> | Promise对象，返回指定的气压值对应的海拔高度，单位为米。 | 2540 2541**错误码**： 2542 2543以下错误码的详细介绍请参见 [sensor.getDeviceAltitude错误码](../errorcodes/errorcode-sensor.md)。 2544 2545| 错误码ID | 错误信息 | 2546| -------- | ------------------ | 2547| 14500101 | Service exception. | 2548 2549**示例：** 2550 2551```js 2552try { 2553 let seaPressure = 1013.2; 2554 let currentPressure = 1500.0; 2555 const promise = sensor.getDeviceAltitude(seaPressure, currentPressure); 2556 promise.then((data) => { 2557 console.info('sensor_getDeviceAltitude_Promise success', data); 2558 }, (err) => { 2559 console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message); 2560 }); 2561} catch (err) { 2562 console.error('Get altitude failed. Error code: ' + err.code + '; message: ' + err.message); 2563} 2564``` 2565 2566## sensor.getInclination<sup>9+</sup> 2567 2568getInclination(inclinationMatrix: Array<number>, callback: AsyncCallback<number>): void 2569 2570根据倾斜矩阵计算地磁倾角。 2571 2572**系统能力**：SystemCapability.Sensors.Sensor 2573 2574**参数：** 2575 2576| 参数名 | 类型 | 必填 | 说明 | 2577| ----------------- | --------------------------- | ---- | ---------------------------- | 2578| inclinationMatrix | Array<number> | 是 | 倾斜矩阵。 | 2579| callback | AsyncCallback<number> | 是 | 回调函数，返回地磁倾角，单位为弧度。 | 2580 2581**错误码**： 2582 2583以下错误码的详细介绍请参见 [sensor.getInclination错误码](../errorcodes/errorcode-sensor.md)。 2584 2585| 错误码ID | 错误信息 | 2586| -------- | ------------------ | 2587| 14500101 | Service exception. | 2588 2589**示例：** 2590 2591```js 2592try { 2593 // inclinationMatrix可以为3*3，或者4*4 2594 let inclinationMatrix = [ 2595 1, 0, 0, 2596 0, 1, 0, 2597 0, 0, 1 2598 ] 2599 sensor.getInclination(inclinationMatrix, function (err, data) { 2600 if (err) { 2601 console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message); 2602 return; 2603 } 2604 console.info('Inclination: ' + data); 2605 }) 2606} catch (err) { 2607 console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message); 2608} 2609``` 2610 2611## sensor.getInclination<sup>9+</sup> 2612 2613 getInclination(inclinationMatrix: Array<number>): Promise<number> 2614 2615根据倾斜矩阵计算地磁倾角。 2616 2617**系统能力**：SystemCapability.Sensors.Sensor 2618 2619**参数：** 2620 2621| 参数名 | 类型 | 必填 | 说明 | 2622| ----------------- | ------------------- | ---- | -------------- | 2623| inclinationMatrix | Array<number> | 是 | 倾斜矩阵。 | 2624 2625**返回值：** 2626 2627| 类型 | 说明 | 2628| --------------------- | ---------------------------- | 2629| Promise<number> | Promise对象，返回地磁倾斜角，单位为弧度。 | 2630 2631**错误码**： 2632 2633以下错误码的详细介绍请参见 [sensor.getInclination错误码](../errorcodes/errorcode-sensor.md)。 2634 2635| 错误码ID | 错误信息 | 2636| -------- | ------------------ | 2637| 14500101 | Service exception. | 2638 2639**示例：** 2640 2641```js 2642try { 2643 // inclinationMatrix可以为3*3，或者4*4 2644 let inclinationMatrix = [ 2645 1, 0, 0, 2646 0, 1, 0, 2647 0, 0, 1 2648 ] 2649 const promise = sensor.getInclination(inclinationMatrix); 2650 promise.then((data) => { 2651 console.info('Inclination: ' + data); 2652 }, (err) => { 2653 console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message); 2654 }); 2655} catch (err) { 2656 console.error('Get inclination failed. Error code: ' + err.code + '; message: ' + err.message); 2657} 2658``` 2659 2660## sensor.getAngleVariation<sup>9+</sup> 2661 2662 getAngleVariation(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>, 2663 callback: AsyncCallback<Array<number>>): void 2664 2665计算两个旋转矩阵之间的角度变化。 2666 2667**系统能力**：SystemCapability.Sensors.Sensor 2668 2669**参数：** 2670 2671| 参数名 | 类型 | 必填 | 说明 | 2672| --------------------- | ---------------------------------------- | ---- | --------------------------------- | 2673| currentRotationMatrix | Array<number> | 是 | 当前旋转矩阵。 | 2674| preRotationMatrix | Array<number> | 是 | 相对旋转矩阵。 | 2675| callback | AsyncCallback<Array<number>> | 是 | 回调函数，返回绕z、x、y轴方向的旋转角度。 | 2676 2677**错误码**： 2678 2679以下错误码的详细介绍请参见 [sensor.getAngleVariation错误码](../errorcodes/errorcode-sensor.md)。 2680 2681| 错误码ID | 错误信息 | 2682| -------- | ------------------ | 2683| 14500101 | Service exception. | 2684 2685**示例：** 2686 2687```js 2688try { 2689 // 旋转矩阵可以为3*3，或者4*4 2690 let currentRotationMatrix = [ 2691 1, 0, 0, 2692 0, 1, 0, 2693 0, 0, 1 2694 ]; 2695 let preRotationMatrix = [ 2696 1, 0, 0, 2697 0, 0.87, -0.50, 2698 0, 0.50, 0.87 2699 ]; 2700 sensor.getAngleVariation(currentRotationMatrix, preRotationMatrix, function (err, data) { 2701 if (err) { 2702 console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message); 2703 return; 2704 } 2705 if (data.length < 3) { 2706 console.error("Get angle variation failed, length" + data.length); 2707 } 2708 console.info("Z: " + data[0]); 2709 console.info("X: " + data[1]); 2710 console.info("Y : " + data[2]); 2711 }) 2712} catch (err) { 2713 console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message); 2714} 2715``` 2716 2717## sensor.getAngleVariation<sup>9+</sup> 2718 2719getAngleVariation(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>): Promise<Array<number>> 2720 2721得到两个旋转矩阵之间的角度变化。 2722 2723**系统能力**：SystemCapability.Sensors.Sensor 2724 2725**参数：** 2726 2727| 参数名 | 类型 | 必填 | 说明 | 2728| --------------------- | ------------------- | ---- | ------------------ | 2729| currentRotationMatrix | Array<number> | 是 | 当前旋转矩阵。 | 2730| preRotationMatrix | Array<number> | 是 | 相对旋转矩阵 | 2731 2732**返回值：** 2733 2734| 类型 | 说明 | 2735| ---------------------------------- | --------------------------------- | 2736| Promise<Array<number>> | Promise对象，返回绕z、x、y轴方向的旋转角度。 | 2737 2738**错误码**： 2739 2740以下错误码的详细介绍请参见 [sensor.getAngleVariation错误码](../errorcodes/errorcode-sensor.md)。 2741 2742| 错误码ID | 错误信息 | 2743| -------- | ------------------ | 2744| 14500101 | Service exception. | 2745 2746**示例：** 2747 2748```js 2749try { 2750 // 旋转矩阵可以为3*3，或者4*4 2751 let currentRotationMatrix = [ 2752 1, 0, 0, 2753 0, 1, 0, 2754 0, 0, 1 2755 ]; 2756 let preRotationMatrix = [ 2757 1, 0, 0, 2758 0, 0.87, -0.50, 2759 0, 0.50, 0.87 2760 ]; 2761 const promise = sensor.getAngleVariation(currentRotationMatrix, preRotationMatrix); 2762 promise.then((data) => { 2763 if (data.length < 3) { 2764 console.error("Get angle variation failed, length" + data.length); 2765 } 2766 console.info("Z: " + data[0]); 2767 console.info("X: " + data[1]); 2768 console.info("Y : " + data[2]); 2769 }, (err) => { 2770 console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message); 2771 }); 2772} catch (err) { 2773 console.error('Get angle variation failed. Error code: ' + err.code + '; message: ' + err.message); 2774} 2775``` 2776 2777## sensor.getRotationMatrix<sup>9+</sup> 2778 2779getRotationMatrix(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void 2780 2781根据旋转矢量获取旋转矩阵。 2782 2783**系统能力**：SystemCapability.Sensors.Sensor 2784 2785**参数：** 2786 2787| 参数名 | 类型 | 必填 | 说明 | 2788| -------------- | ---------------------------------------- | ---- | -------------- | 2789| rotationVector | Array<number> | 是 | 旋转矢量。 | 2790| callback | AsyncCallback<Array<number>> | 是 | 回调函数，返回3*3旋转矩阵。 | 2791 2792**错误码**： 2793 2794以下错误码的详细介绍请参见 [sensor.getRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 2795 2796| 错误码ID | 错误信息 | 2797| -------- | ------------------ | 2798| 14500101 | Service exception. | 2799 2800**示例：** 2801 2802```js 2803try { 2804 let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877]; 2805 sensor.getRotationMatrix(rotationVector, function (err, data) { 2806 if (err) { 2807 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2808 return; 2809 } 2810 for (var i = 0; i < data.length; i++) { 2811 console.info('data[' + i + ']: ' + data[i]); 2812 } 2813 }) 2814} catch (err) { 2815 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2816} 2817``` 2818 2819## sensor.getRotationMatrix<sup>9+</sup> 2820 2821getRotationMatrix(rotationVector: Array<number>): Promise<Array<number>> 2822 2823根据旋转矢量获取旋转矩阵。 2824 2825**系统能力**：SystemCapability.Sensors.Sensor 2826 2827**参数：** 2828 2829| 参数名 | 类型 | 必填 | 说明 | 2830| -------------- | ------------------- | ---- | -------------- | 2831| rotationVector | Array<number> | 是 | 旋转矢量。 | 2832 2833**返回值：** 2834 2835| 类型 | 说明 | 2836| ---------------------------------- | -------------- | 2837| Promise<Array<number>> | Promise对象，返回旋转矩阵。 | 2838 2839**错误码**： 2840 2841以下错误码的详细介绍请参见 [sensor.getRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 2842 2843| 错误码ID | 错误信息 | 2844| -------- | ------------------ | 2845| 14500101 | Service exception. | 2846 2847**示例：** 2848 2849```js 2850try { 2851 let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877]; 2852 const promise = sensor.getRotationMatrix(rotationVector); 2853 promise.then((data) => { 2854 for (var i = 0; i < data.length; i++) { 2855 console.info('data[' + i + ']: ' + data[i]); 2856 } 2857 }, (err) => { 2858 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2859 }); 2860} catch (err) { 2861 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2862} 2863``` 2864 2865## sensor.transformRotationMatrix<sup>9+</sup> 2866 2867transformRotationMatrix(inRotationVector: Array<number>, coordinates: CoordinatesOptions, 2868 callback: AsyncCallback<Array<number>>): void 2869 2870根据指定坐标系映射旋转矩阵。 2871 2872**系统能力**：SystemCapability.Sensors.Sensor 2873 2874**参数：** 2875 2876| 参数名 | 类型 | 必填 | 说明 | 2877| ---------------- | ----------------------------------------- | ---- | ---------------------- | 2878| inRotationVector | Array<number> | 是 | 旋转矩阵。 | 2879| coordinates | [CoordinatesOptions](#coordinatesoptions) | 是 | 指定坐标系方向。 | 2880| callback | AsyncCallback<Array<number>> | 是 | 回调函数，返回映射后的旋转矩阵。 | 2881 2882**错误码**： 2883 2884以下错误码的详细介绍请参见 [sensor.transformRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 2885 2886| 错误码ID | 错误信息 | 2887| -------- | ------------------ | 2888| 14500101 | Service exception. | 2889 2890**示例：** 2891 2892```js 2893try { 2894 let rotationMatrix = [ 2895 1, 0, 0, 2896 0, 0.87, -0.50, 2897 0, 0.50, 0.87 2898 ]; 2899 sensor.transformRotationMatrix(rotationMatrix, { x: 1, y: 3 }, function (err, data) { 2900 if (err) { 2901 console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2902 return; 2903 } 2904 for (var i = 0; i < data.length; i++) { 2905 console.info('data[' + i + '] = ' + data[i]); 2906 } 2907 }) 2908} catch (err) { 2909 console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2910} 2911``` 2912 2913## sensor.transformRotationMatrix<sup>9+</sup> 2914 2915transformRotationMatrix(inRotationVector: Array<number>, coordinates: CoordinatesOptions): Promise<Array<number>> 2916 2917根据指定坐标系映射旋转矩阵。 2918 2919**系统能力**：SystemCapability.Sensors.Sensor 2920 2921**参数：** 2922 2923| 参数名 | 类型 | 必填 | 说明 | 2924| ---------------- | ----------------------------------------- | ---- | ---------------- | 2925| inRotationVector | Array<number> | 是 | 旋转矩阵。 | 2926| coordinates | [CoordinatesOptions](#coordinatesoptions) | 是 | 指定坐标系方向。 | 2927 2928**返回值：** 2929 2930| 类型 | 说明 | 2931| ---------------------------------- | ---------------------- | 2932| Promise<Array<number>> | Promise对象，返回转换后的旋转矩阵。 | 2933 2934**错误码**： 2935 2936以下错误码的详细介绍请参见 [sensor.transformRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 2937 2938| 错误码ID | 错误信息 | 2939| -------- | ------------------ | 2940| 14500101 | Service exception. | 2941 2942**示例：** 2943 2944```js 2945try { 2946 let rotationMatrix = [ 2947 1, 0, 0, 2948 0, 0.87, -0.50, 2949 0, 0.50, 0.87 2950 ]; 2951 const promise = sensor.transformRotationMatrix(rotationMatrix, { x: 1, y: 3 }); 2952 promise.then((data) => { 2953 for (var i = 0; i < data.length; i++) { 2954 console.info('data[' + i + ']: ' + data[i]); 2955 } 2956 }, (err) => { 2957 console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2958 }); 2959} catch (err) { 2960 console.error('Transform rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 2961} 2962``` 2963 2964## sensor.getQuaternion<sup>9+</sup> 2965 2966getQuaternion(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void 2967 2968根据旋转向量计算归一化四元数。 2969 2970**系统能力**：SystemCapability.Sensors.Sensor 2971 2972**参数：** 2973 2974| 参数名 | 类型 | 必填 | 说明 | 2975| -------------- | ---------------------------------------- | ---- | -------------- | 2976| rotationVector | Array<number> | 是 | 旋转矢量。 | 2977| callback | AsyncCallback<Array<number>> | 是 | 回调函数，返回归一化四元数。 | 2978 2979**错误码**： 2980 2981以下错误码的详细介绍请参见 [sensor.getQuaternion错误码](../errorcodes/errorcode-sensor.md)。 2982 2983| 错误码ID | 错误信息 | 2984| -------- | ------------------ | 2985| 14500101 | Service exception. | 2986 2987**示例：** 2988 2989```js 2990try { 2991 let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877]; 2992 sensor.getQuaternion(rotationVector, function (err, data) { 2993 if (err) { 2994 console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message); 2995 return; 2996 } 2997 for (var i = 0; i < data.length; i++) { 2998 console.info('data[' + i + ']: ' + data[i]); 2999 } 3000 }) 3001} catch (err) { 3002 console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message); 3003} 3004``` 3005 3006## sensor.getQuaternion<sup>9+</sup> 3007 3008getQuaternion(rotationVector: Array<number>): Promise<Array<number>> 3009 3010根据旋转向量计算归一化四元数。 3011 3012**系统能力**：SystemCapability.Sensors.Sensor 3013 3014**参数：** 3015 3016| 参数名 | 类型 | 必填 | 说明 | 3017| -------------- | ------------------- | ---- | -------------- | 3018| rotationVector | Array<number> | 是 | 旋转矢量。 | 3019 3020**返回值：** 3021 3022| 类型 | 说明 | 3023| ---------------------------------- | ------------ | 3024| Promise<Array<number>> | Promise，对象返归一化回四元数。 | 3025 3026**错误码**： 3027 3028以下错误码的详细介绍请参见 [sensor.getQuaternion错误码](../errorcodes/errorcode-sensor.md)。 3029 3030| 错误码ID | 错误信息 | 3031| -------- | ------------------ | 3032| 14500101 | Service exception. | 3033 3034**示例：** 3035 3036```js 3037try { 3038 let rotationVector = [0.20046076, 0.21907, 0.73978853, 0.60376877]; 3039 const promise = sensor.getQuaternion(rotationVector); 3040 promise.then((data) => { 3041 for (var i = 0; i < data.length; i++) { 3042 console.info('data[' + i + ']: ' + data[i]); 3043 } 3044 }, (err) => { 3045 console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message); 3046 }); 3047} catch (err) { 3048 console.error('Get quaternion failed. Error code: ' + err.code + '; message: ' + err.message); 3049} 3050``` 3051 3052## sensor.getOrientation<sup>9+</sup> 3053 3054getOrientation(rotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void 3055 3056根据旋转矩阵计算设备方向。 3057 3058**系统能力**：SystemCapability.Sensors.Sensor 3059 3060**参数：** 3061 3062| 参数名 | 类型 | 必填 | 说明 | 3063| -------------- | ---------------------------------------- | ---- | --------------------------------- | 3064| rotationMatrix | Array<number> | 是 | 旋转矩阵。 | 3065| callback | AsyncCallback<Array<number>> | 是 | 回调函数，返回围绕z、x、y轴方向的旋转角度。 | 3066 3067**错误码**： 3068 3069以下错误码的详细介绍请参见 [sensor.getOrientation错误码](../errorcodes/errorcode-sensor.md)。 3070 3071| 错误码ID | 错误信息 | 3072| -------- | ------------------ | 3073| 14500101 | Service exception. | 3074 3075**示例：** 3076 3077```js 3078try { 3079 let preRotationMatrix = [ 3080 1, 0, 0, 3081 0, 0.87, -0.50, 3082 0, 0.50, 0.87 3083 ]; 3084 sensor.getOrientation(preRotationMatrix, function (err, data) { 3085 if (err) { 3086 console.error('Get orientation failed. Error code: ' + err.code + '; message: ' + err.message); 3087 return; 3088 } 3089 if (data.length < 3) { 3090 console.error("Get orientation failed, length" + data.length); 3091 } 3092 console.info("Z: " + data[0]); 3093 console.info("X: " + data[1]); 3094 console.info("Y : " + data[2]); 3095 }) 3096} catch (err) { 3097 console.error('Get orientation failed. Error code: ' + err.code + '; message: ' + err.message); 3098} 3099``` 3100 3101## sensor.getOrientation<sup>9+</sup> 3102 3103getOrientation(rotationMatrix: Array<number>): Promise<Array<number>> 3104 3105根据旋转矩阵计算设备的方向。 3106 3107**系统能力**：SystemCapability.Sensors.Sensor 3108 3109**参数：** 3110 3111| 参数名 | 类型 | 必填 | 说明 | 3112| -------------- | ------------------- | ---- | -------------- | 3113| rotationMatrix | Array<number> | 是 | 旋转矩阵。 | 3114 3115**返回值：** 3116 3117| 类型 | 说明 | 3118| ---------------------------------- | --------------------------------- | 3119| Promise<Array<number>> | Promise对象，返回围绕z、x、y轴方向的旋转角度。 | 3120 3121**错误码**： 3122 3123以下错误码的详细介绍请参见 [sensor.getOrientation错误码](../errorcodes/errorcode-sensor.md)。 3124 3125| 错误码ID | 错误信息 | 3126| -------- | ------------------ | 3127| 14500101 | Service exception. | 3128 3129**示例：** 3130 3131```js 3132try { 3133 let preRotationMatrix = [ 3134 1, 0, 0, 3135 0, 0.87, -0.50, 3136 0, 0.50, 0.87 3137 ]; 3138 const promise = sensor.getOrientation(preRotationMatrix); 3139 promise.then((data) => { 3140 for (var i = 0; i < data.length; i++) { 3141 console.info('data[' + i + ']: ' + data[i]); 3142 } 3143 }, (err) => { 3144 console.error('getOrientation failed. Error code: ' + err.code + '; message: ' + err.message); 3145 }); 3146} catch (err) { 3147 console.error('getOrientation failed. Error code: ' + err.code + '; message: ' + err.message); 3148} 3149``` 3150 3151## sensor.getRotationMatrix<sup>9+</sup> 3152 3153getRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>, callback: AsyncCallback<RotationMatrixResponse>): void 3154 3155根据重力矢量和地磁矢量计算旋转矩阵。 3156 3157**系统能力**：SystemCapability.Sensors.Sensor 3158 3159**参数：** 3160 3161| 参数名 | 类型 | 必填 | 说明 | 3162| ----------- | ------------------------------------------------------------ | ---- | -------------- | 3163| gravity | Array<number> | 是 | 重力矢量。 | 3164| geomagnetic | Array<number> | 是 | 地磁矢量。 | 3165| callback | AsyncCallback<[RotationMatrixResponse](#rotationmatrixresponse)> | 是 | 回调函数，返回旋转矩阵。 | 3166 3167**错误码**： 3168 3169以下错误码的详细介绍请参见 [sensor.getRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 3170 3171| 错误码ID | 错误信息 | 3172| -------- | ------------------ | 3173| 14500101 | Service exception. | 3174 3175**示例：** 3176 3177```js 3178try { 3179 let gravity = [-0.27775216, 0.5351276, 9.788099]; 3180 let geomagnetic = [210.87253, -78.6096, -111.44444]; 3181 sensor.getRotationMatrix(gravity, geomagnetic, function (err, data) { 3182 if (err) { 3183 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 3184 return; 3185 } 3186 console.info('RotationMatrix' + JSON.stringify(data)); 3187 }) 3188} catch (err) { 3189 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 3190} 3191``` 3192 3193## sensor.getRotationMatrix<sup>9+</sup> 3194 3195getRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>): Promise<RotationMatrixResponse> 3196 3197根据重力矢量和地磁矢量计算旋转矩阵。 3198 3199**系统能力**：SystemCapability.Sensors.Sensor 3200 3201**参数：** 3202 3203| 参数名 | 类型 | 必填 | 说明 | 3204| ----------- | ------------------- | ---- | -------------- | 3205| gravity | Array<number> | 是 | 重力向量。 | 3206| geomagnetic | Array<number> | 是 | 地磁矢量。 | 3207 3208**返回值：** 3209 3210| 类型 | 说明 | 3211| ------------------------------------------------------------ | -------------- | 3212| Promise<[RotationMatrixResponse](#rotationmatrixresponse)> | Promise对象，返回旋转矩阵。 | 3213 3214**错误码**： 3215 3216以下错误码的详细介绍请参见 [sensor.getRotationMatrix错误码](../errorcodes/errorcode-sensor.md)。 3217 3218| 错误码ID | 错误信息 | 3219| -------- | ------------------ | 3220| 14500101 | Service exception. | 3221 3222**示例：** 3223 3224```js 3225try { 3226 let gravity = [-0.27775216, 0.5351276, 9.788099]; 3227 let geomagnetic = [210.87253, -78.6096, -111.44444]; 3228 const promise = sensor.getRotationMatrix(gravity, geomagnetic); 3229 promise.then((data) => { 3230 console.info('RotationMatrix' + JSON.stringify(data)); 3231 }, (err) => { 3232 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 3233 }); 3234} catch (err) { 3235 console.error('Get rotationMatrix failed. Error code: ' + err.code + '; message: ' + err.message); 3236} 3237``` 3238 3239## sensor.getSensorList<sup>9+</sup> 3240 3241getSensorList(callback: AsyncCallback<Array<Sensor>>): void 3242 3243获取设备上的所有传感器信息。 3244 3245**系统能力**：SystemCapability.Sensors.Sensor 3246 3247**参数：** 3248 3249| 参数名 | 类型 | 必填 | 说明 | 3250| -------- | ---------------------------------------------- | ---- | ---------------- | 3251| callback | AsyncCallback<Array<[Sensor](#sensor9)>> | 是 | 回调函数，返回传感器属性列表。 | 3252 3253**错误码**： 3254 3255以下错误码的详细介绍请参见 [sensor.getSensorList错误码](../errorcodes/errorcode-sensor.md)。 3256 3257| 错误码ID | 错误信息 | 3258| -------- | ------------------ | 3259| 14500101 | Service exception. | 3260 3261**示例：** 3262 3263```js 3264try { 3265 sensor.getSensorList((err, data) => { 3266 if (err) { 3267 console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message); 3268 return; 3269 } 3270 for (var i = 0; i < data.length; i++) { 3271 console.info('data[' + i + ']: ' + JSON.stringify(data[i])); 3272 } 3273 }); 3274} catch (err) { 3275 console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message); 3276} 3277``` 3278 3279## sensor.getSensorList<sup>9+</sup> 3280 3281 getSensorList(): Promise<Array<Sensor>> 3282 3283获取设备上的所有传感器信息。 3284 3285**系统能力**：SystemCapability.Sensors.Sensor 3286 3287**返回值：** 3288 3289| 参数名 | 类型 | 必填 | 说明 | 3290| ------- | ---------------------------------------- | ---- | ---------------- | 3291| promise | Promise<Array<[Sensor](#sensor9)>> | 是 | Promise对象，返回传感器属性列表。 | 3292 3293**错误码**： 3294 3295以下错误码的详细介绍请参见 [sensor.getSensorList错误码](../errorcodes/errorcode-sensor.md)。 3296 3297| 错误码ID | 错误信息 | 3298| -------- | ------------------ | 3299| 14500101 | Service exception. | 3300 3301**示例：** 3302 3303```js 3304try { 3305 sensor.getSensorList().then((data) => { 3306 for (var i = 0; i < data.length; i++) { 3307 console.info('data[' + i + ']: ' + JSON.stringify(data[i])); 3308 } 3309 }, (err) => { 3310 console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message); 3311 }); 3312} catch (err) { 3313 console.error('Get sensorList failed. Error code: ' + err.code + '; message: ' + err.message); 3314} 3315``` 3316 3317## sensor.getSingleSensor<sup>9+</sup> 3318 3319getSingleSensor(type: SensorId, callback: AsyncCallback<Sensor>): void 3320 3321获取指定传感器类型的属性信息。 3322 3323**系统能力**：SystemCapability.Sensors.Sensor 3324 3325**参数：** 3326 3327| 参数名 | 类型 | 必填 | 说明 | 3328| -------- | --------------------------------------- | ---- | ---------------- | 3329| type | [SensorId](#sensorid9) | 是 | 指定传感器类型。 | 3330| callback | AsyncCallback<[Sensor](#sensor9)> | 是 | 回调函数，返回指定传感器的属性信息。 | 3331 3332**错误码**： 3333 3334以下错误码的详细介绍请参见 [sensor.getSingleSensor错误码](../errorcodes/errorcode-sensor.md)。 3335 3336| 错误码ID | 错误信息 | 3337| -------- | ------------------ | 3338| 14500101 | Service exception. | 3339 3340**示例：** 3341 3342```js 3343try { 3344 sensor.getSingleSensor(sensor.SensorId.ACCELEROMETER, (err, data) => { 3345 if (err) { 3346 console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message); 3347 return; 3348 } 3349 console.info('Sensor: ' + JSON.stringify(data)); 3350 }); 3351} catch (err) { 3352 console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message); 3353} 3354``` 3355 3356## sensor.getSingleSensor<sup>9+</sup> 3357 3358 getSingleSensor(type: SensorId): Promise<Sensor> 3359 3360获取指定类型的传感器信息。 3361 3362**系统能力**：SystemCapability.Sensors.Sensor 3363 3364**参数：** 3365 3366| 参数名 | 类型 | 必填 | 说明 | 3367| ------ | ---------------------- | ---- | ------------ | 3368| type | [SensorId](#sensorid9) | 是 | 传感器类型。 | 3369 3370**返回值：** 3371 3372| 参数名 | 类型 | 必填 | 说明 | 3373| ------- | --------------------------------- | ---- | ---------------- | 3374| promise | Promise<[Sensor](#sensor9)> | 是 | 返回传感器信息。 | 3375 3376**错误码**： 3377 3378以下错误码的详细介绍请参见 [sensor.getSingleSensor错误码](../errorcodes/errorcode-sensor.md)。 3379 3380| 错误码ID | 错误信息 | 3381| -------- | ------------------ | 3382| 14500101 | Service exception. | 3383 3384**示例：** 3385 3386```js 3387try { 3388 sensor.getSingleSensor(sensor.SensorId.ACCELEROMETER).then((data) => { 3389 console.info('Sensor: ' + JSON.stringify(data)); 3390 }, (err) => { 3391 console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message); 3392 }); 3393} catch (err) { 3394 console.error('Get singleSensor failed. Error code: ' + err.code + '; message: ' + err.message); 3395} 3396``` 3397 3398## SensorId<sup>9+</sup> 3399 3400表示要订阅或取消订阅的传感器类型。 3401 3402**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3403 3404| 名称 | 值 | 说明 | 3405| --------------------------- | ---- | ---------------------- | 3406| ACCELEROMETER | 1 | 加速度传感器。 | 3407| GYROSCOPE | 2 | 陀螺仪传感器。 | 3408| AMBIENT_LIGHT | 5 | 环境光传感器。 | 3409| MAGNETIC_FIELD | 6 | 磁场传感器。 | 3410| BAROMETER | 8 | 气压计传感器。 | 3411| HALL | 10 | 霍尔传感器。 | 3412| PROXIMITY | 12 | 接近光传感器。 | 3413| HUMIDITY | 13 | 湿度传感器。 | 3414| ORIENTATION | 256 | 方向传感器。 | 3415| GRAVITY | 257 | 重力传感器。 | 3416| LINEAR_ACCELEROMETER | 258 | 线性加速度传感器。 | 3417| ROTATION_VECTOR | 259 | 旋转矢量传感器。 | 3418| AMBIENT_TEMPERATURE | 260 | 环境温度传感器。 | 3419| MAGNETIC_FIELD_UNCALIBRATED | 261 | 未校准磁场传感器。 | 3420| GYROSCOPE_UNCALIBRATED | 263 | 未校准陀螺仪传感器。 | 3421| SIGNIFICANT_MOTION | 264 | 有效运动传感器。 | 3422| PEDOMETER_DETECTION | 265 | 计步检测传感器。 | 3423| PEDOMETER | 266 | 计步传感器。 | 3424| HEART_RATE | 278 | 心率传感器。 | 3425| WEAR_DETECTION | 280 | 佩戴检测传感器。 | 3426| ACCELEROMETER_UNCALIBRATED | 281 | 未校准加速度计传感器。 | 3427 3428## SensorType<sup>(deprecated)</sup> 3429 3430表示要订阅或取消订阅的传感器类型。 3431 3432**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3433 3434 3435| 名称 | 值 | 说明 | 3436| ------------------------------------------ | ---- | ---------------------- | 3437| SENSOR_TYPE_ID_ACCELEROMETER | 1 | 加速度传感器。 | 3438| SENSOR_TYPE_ID_GYROSCOPE | 2 | 陀螺仪传感器。 | 3439| SENSOR_TYPE_ID_AMBIENT_LIGHT | 5 | 环境光传感器。 | 3440| SENSOR_TYPE_ID_MAGNETIC_FIELD | 6 | 磁场传感器。 | 3441| SENSOR_TYPE_ID_BAROMETER | 8 | 气压计传感器。 | 3442| SENSOR_TYPE_ID_HALL | 10 | 霍尔传感器。 | 3443| SENSOR_TYPE_ID_PROXIMITY | 12 | 接近光传感器。 | 3444| SENSOR_TYPE_ID_HUMIDITY | 13 | 湿度传感器。 | 3445| SENSOR_TYPE_ID_ORIENTATION | 256 | 方向传感器。 | 3446| SENSOR_TYPE_ID_GRAVITY | 257 | 重力传感器。 | 3447| SENSOR_TYPE_ID_LINEAR_ACCELERATION | 258 | 线性加速度传感器。 | 3448| SENSOR_TYPE_ID_ROTATION_VECTOR | 259 | 旋转矢量传感器。 | 3449| SENSOR_TYPE_ID_AMBIENT_TEMPERATURE | 260 | 环境温度传感器。 | 3450| SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED | 261 | 未校准磁场传感器。 | 3451| SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED | 263 | 未校准陀螺仪传感器。 | 3452| SENSOR_TYPE_ID_SIGNIFICANT_MOTION | 264 | 有效运动传感器。 | 3453| SENSOR_TYPE_ID_PEDOMETER_DETECTION | 265 | 计步检测传感器。 | 3454| SENSOR_TYPE_ID_PEDOMETER | 266 | 计步传感器。 | 3455| SENSOR_TYPE_ID_HEART_RATE | 278 | 心率传感器。 | 3456| SENSOR_TYPE_ID_WEAR_DETECTION | 280 | 佩戴检测传感器。 | 3457| SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED | 281 | 未校准加速度计传感器。 | 3458 3459 3460## Response 3461 3462传感器数据的时间戳。 3463 3464**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3465 3466| 名称 | 类型 | 可读 | 可写 | 说明 | 3467| --------- | ------ | ---- | ---- | ------------------------ | 3468| timestamp | number | 是 | 是 | 传感器数据上报的时间戳。 | 3469 3470## Sensor<sup>9+</sup> 3471 3472指示传感器信息。 3473 3474**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3475 3476| 名称 | 类型 | 可读 | 可写 | 说明 | 3477| --------------- | -------- | ---------------------- | ---------------------- | ---------------------- | 3478| sensorName | string | 是 | 是 | 传感器名称。 | 3479| vendorName | string | 是 | 是 | 传感器供应商。 | 3480| firmwareVersion | string | 是 | 是 | 传感器固件版本。 | 3481| hardwareVersion | string | 是 | 是 | 传感器硬件版本。 | 3482| sensorId | number | 是 | 是 | 传感器类型id。 | 3483| maxRange | number | 是 | 是 | 传感器测量范围的最大值。 | 3484| minSamplePeriod | number | 是 | 是 | 允许的最小采样周期。 | 3485| maxSamplePeriod | number | 是 | 是 | 允许的最大采样周期。 | 3486| precision | number | 是 | 是 | 传感器精度。 | 3487| power | number | 是 | 是 | 传感器功率。 | 3488 3489## AccelerometerResponse 3490 3491加速度传感器数据，继承于[Response](#response)。 3492 3493**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3494 3495 3496| 名称 | 类型 | 可读 | 可写 | 说明 | 3497| ---- | ------ | ---- | ---- | ------------------------------------ | 3498| x | number | 是 | 是 | 施加在设备x轴的加速度，单位 : m/s2。 | 3499| y | number | 是 | 是 | 施加在设备y轴的加速度，单位 : m/s2。 | 3500| z | number | 是 | 是 | 施加在设备z轴的加速度，单位 : m/s2。 | 3501 3502 3503## LinearAccelerometerResponse 3504 3505线性加速度传感器数据，继承于[Response](#response)。 3506 3507**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3508 3509 3510| 名称 | 类型 | 可读 | 可写 | 说明 | 3511| ---- | ------ | ---- | ---- | ---------------------------------------- | 3512| x | number | 是 | 是 | 施加在设备x轴的线性加速度，单位 : m/s2。 | 3513| y | number | 是 | 是 | 施加在设备y轴的线性加速度，单位 : m/s2。 | 3514| z | number | 是 | 是 | 施加在设备z轴的线性加速度，单位 : m/s2。 | 3515 3516 3517## AccelerometerUncalibratedResponse 3518 3519未校准加速度计传感器数据，继承于[Response](#response)。 3520 3521**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3522 3523 3524| 名称 | 类型 | 可读 | 可写 | 说明 | 3525| ----- | ------ | ---- | ---- | ------------------------------------------------ | 3526| x | number | 是 | 是 | 施加在设备x轴未校准的加速度，单位 : m/s2。 | 3527| y | number | 是 | 是 | 施加在设备y轴未校准的加速度，单位 : m/s2。 | 3528| z | number | 是 | 是 | 施加在设备z轴未校准的加速度，单位 : m/s2。 | 3529| biasX | number | 是 | 是 | 施加在设备x轴未校准的加速度偏量，单位 : m/s2。 | 3530| biasY | number | 是 | 是 | 施加在设备上y轴未校准的加速度偏量，单位 : m/s2。 | 3531| biasZ | number | 是 | 是 | 施加在设备z轴未校准的加速度偏量，单位 : m/s2。 | 3532 3533 3534## GravityResponse 3535 3536重力传感器数据，继承于[Response](#response)。 3537 3538**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3539 3540 3541| 名称 | 类型 | 可读 | 可写 | 说明 | 3542| ---- | ------ | ---- | ---- | ---------------------------------------- | 3543| x | number | 是 | 是 | 施加在设备x轴的重力加速度，单位 : m/s2。 | 3544| y | number | 是 | 是 | 施加在设备y轴的重力加速度，单位 : m/s2。 | 3545| z | number | 是 | 是 | 施加在设备z轴的重力加速度，单位 : m/s2。 | 3546 3547 3548## OrientationResponse 3549 3550方向传感器数据，继承于[Response](#response)。 3551 3552**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3553 3554 3555| 名称 | 类型 | 可读 | 可写 | 说明 | 3556| ----- | ------ | ---- | ---- | --------------------------------- | 3557| alpha | number | 是 | 是 | 设备围绕Z轴的旋转角度，单位：度。 | 3558| beta | number | 是 | 是 | 设备围绕X轴的旋转角度，单位：度。 | 3559| gamma | number | 是 | 是 | 设备围绕Y轴的旋转角度，单位：度。 | 3560 3561 3562## RotationVectorResponse 3563 3564旋转矢量传感器数据，继承于[Response](#response)。 3565 3566**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3567 3568 3569| 名称 | 类型 | 可读 | 可写 | 说明 | 3570| ---- | ------ | ---- | ---- | ----------------- | 3571| x | number | 是 | 是 | 旋转矢量x轴分量。 | 3572| y | number | 是 | 是 | 旋转矢量y轴分量。 | 3573| z | number | 是 | 是 | 旋转矢量z轴分量。 | 3574| w | number | 是 | 是 | 标量。 | 3575 3576 3577## GyroscopeResponse 3578 3579陀螺仪传感器数据，继承于[Response](#response)。 3580 3581**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3582 3583 3584| 名称 | 类型 | 可读 | 可写 | 说明 | 3585| ---- | ------ | ---- | ---- | -------------------------------- | 3586| x | number | 是 | 是 | 设备x轴的旋转角速度，单位rad/s。 | 3587| y | number | 是 | 是 | 设备y轴的旋转角速度，单位rad/s。 | 3588| z | number | 是 | 是 | 设备z轴的旋转角速度，单位rad/s。 | 3589 3590 3591## GyroscopeUncalibratedResponse 3592 3593未校准陀螺仪传感器数据，继承于[Response](#response)。 3594 3595**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3596 3597 3598| 名称 | 类型 | 可读 | 可写 | 说明 | 3599| ----- | ------ | ---- | ---- | ------------------------------------------ | 3600| x | number | 是 | 是 | 设备x轴未校准的旋转角速度，单位rad/s。 | 3601| y | number | 是 | 是 | 设备y轴未校准的旋转角速度，单位rad/s。 | 3602| z | number | 是 | 是 | 设备z轴未校准的旋转角速度，单位rad/s。 | 3603| biasX | number | 是 | 是 | 设备x轴未校准的旋转角速度偏量，单位rad/s。 | 3604| biasY | number | 是 | 是 | 设备y轴未校准的旋转角速度偏量，单位rad/s。 | 3605| biasZ | number | 是 | 是 | 设备z轴未校准的旋转角速度偏量，单位rad/s。 | 3606 3607 3608## SignificantMotionResponse 3609 3610有效运动传感器数据，继承于[Response](#response)。 3611 3612**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3613 3614 3615| 名称 | 类型 | 可读 | 可写 | 说明 | 3616| ------ | ------ | ---- | ---- | ------------------------------------------------------------ | 3617| scalar | number | 是 | 是 | 表示剧烈运动程度。测量三个物理轴（x、y 和 z）上，设备是否存在大幅度运动；如果取值为1则代表存在大幅度运动，取值为0则代表没有大幅度运动。 | 3618 3619 3620## ProximityResponse 3621 3622接近光传感器数据，继承于[Response](#response)。 3623 3624**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3625 3626 3627| 名称 | 类型 | 可读 | 可写 | 说明 | 3628| -------- | ------ | ---- | ---- | ------------------------------------------------------ | 3629| distance | number | 是 | 是 | 可见物体与设备显示器的接近程度。0表示接近，1表示远离。 | 3630 3631 3632## LightResponse 3633 3634环境光传感器数据，继承于[Response](#response)。 3635 3636**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3637 3638 3639| 名称 | 类型 | 可读 | 可写 | 说明 | 3640| --------- | ------ | ---- | ---- | ---------------------- | 3641| intensity | number | 是 | 是 | 光强（单位：勒克斯）。 | 3642 3643 3644## HallResponse 3645 3646霍尔传感器数据，继承于[Response](#response)。 3647 3648**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3649 3650 3651| 名称 | 类型 | 可读 | 可写 | 说明 | 3652| ------ | ------ | ---- | ---- | ------------------------------------------------------------ | 3653| status | number | 是 | 是 | 显示霍尔状态。测量设备周围是否存在磁力吸引，0表示没有，大于0表示有。 | 3654 3655 3656## MagneticFieldResponse 3657 3658磁场传感器数据，继承于[Response](#response)。 3659 3660**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3661 3662 3663| 名称 | 类型 | 可读 | 可写 | 说明 | 3664| ---- | ------ | ---- | ---- | ---------------------------- | 3665| x | number | 是 | 是 | x轴环境磁场强度，单位 : μT。 | 3666| y | number | 是 | 是 | y轴环境磁场强度，单位 : μT。 | 3667| z | number | 是 | 是 | z轴环境磁场强度，单位 : μT。 | 3668 3669 3670## MagneticFieldUncalibratedResponse 3671 3672未校准磁场传感器数据，继承于[Response](#response)。 3673 3674**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3675 3676 3677| 名称 | 类型 | 可读 | 可写 | 说明 | 3678| ----- | ------ | ---- | ---- | -------------------------------------- | 3679| x | number | 是 | 是 | x轴未校准环境磁场强度，单位 : μT。 | 3680| y | number | 是 | 是 | y轴未校准环境磁场强度，单位 : μT。 | 3681| z | number | 是 | 是 | z轴未校准环境磁场强度，单位 : μT。 | 3682| biasX | number | 是 | 是 | x轴未校准环境磁场强度偏量，单位 : μT。 | 3683| biasY | number | 是 | 是 | y轴未校准环境磁场强度偏量，单位 : μT。 | 3684| biasZ | number | 是 | 是 | z轴未校准环境磁场强度偏量，单位 : μT。 | 3685 3686 3687## PedometerResponse 3688 3689计步传感器数据，继承于[Response](#response)。 3690 3691**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3692 3693 3694| 名称 | 类型 | 可读 | 可写 | 说明 | 3695| ----- | ------ | ---- | ---- | ---------------- | 3696| steps | number | 是 | 是 | 用户的行走步数。 | 3697 3698 3699## HumidityResponse 3700 3701湿度传感器数据，继承于[Response](#response)。 3702 3703**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3704 3705 3706| 名称 | 类型 | 可读 | 可写 | 说明 | 3707| -------- | ------ | ---- | ---- | --------------------------------------------------------- | 3708| humidity | number | 是 | 是 | 湿度值。测量环境的相对湿度，以百分比 (%) 表示。 | 3709 3710 3711## PedometerDetectionResponse 3712 3713计步检测传感器数据，继承于[Response](#response)。 3714 3715**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3716 3717 3718| 名称 | 类型 | 可读 | 可写 | 说明 | 3719| ------ | ------ | ---- | ---- | ------------------------------------------------------------ | 3720| scalar | number | 是 | 是 | 计步器检测。检测用户的计步动作，如果取值为1则代表用户产生了计步行走的动作，取值为0则代表用户没有发生运动。 | 3721 3722 3723## AmbientTemperatureResponse 3724 3725温度传感器数据，继承于[Response](#response)。 3726 3727**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3728 3729 3730| 名称 | 类型 | 可读 | 可写 | 说明 | 3731| ----------- | ------ | ---- | ---- | -------------------------- | 3732| temperature | number | 是 | 是 | 环境温度（单位：摄氏度）。 | 3733 3734 3735## BarometerResponse 3736 3737气压计传感器数据，继承于[Response](#response)。 3738 3739**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3740 3741 3742| 名称 | 类型 | 可读 | 可写 | 说明 | 3743| -------- | ------ | ---- | ---- | ------------------------ | 3744| pressure | number | 是 | 是 | 压力值（单位：帕斯卡）。 | 3745 3746 3747## HeartRateResponse 3748 3749心率传感器数据，继承于[Response](#response)。 3750 3751**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3752 3753 3754| 名称 | 类型 | 可读 | 可写 | 说明 | 3755| --------- | ------ | ---- | ---- | --------------------------------------- | 3756| heartRate | number | 是 | 是 | 心率值。测量用户的心率数值，单位：bpm。 | 3757 3758 3759## WearDetectionResponse 3760 3761佩戴检测传感器数据，继承于[Response](#response)。 3762 3763**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3764 3765 3766| 名称 | 类型 | 可读 | 可写 | 说明 | 3767| ----- | ------ | ---- | ---- | ------------------------------------------------ | 3768| value | number | 是 | 是 | 表示设备是否被穿戴（1表示已穿戴，0表示未穿戴）。 | 3769 3770 3771## Options 3772 3773设置传感器上报频率。 3774 3775**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3776 3777| 名称 | 类型 | 可读 | 可写 | 说明 | 3778| -------- | ------ | ---- | ---- | ------------------------------------------- | 3779| interval | number | 是 | 是 | 表示传感器的上报频率，默认值为200000000ns。 | 3780 3781## RotationMatrixResponse 3782 3783设置旋转矩阵响应对象。 3784 3785**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3786 3787| 名称 | 类型 | 可读 | 可写 | 说明 | 3788| ----------- | ------------------- | ---- | ---- | ---------- | 3789| rotation | Array<number> | 是 | 是 | 旋转矩阵。 | 3790| inclination | Array<number> | 是 | 是 | 倾斜矩阵。 | 3791 3792 3793## CoordinatesOptions 3794 3795设置坐标选项对象。 3796 3797**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3798 3799| 名称 | 类型 | 可读 | 可写 | 说明 | 3800| ---- | ------ | ---- | ---- | ----------- | 3801| x | number | 是 | 是 | x坐标方向。 | 3802| y | number | 是 | 是 | y坐标方向。 | 3803 3804 3805## GeomagneticResponse 3806 3807设置地磁响应对象，继承于[Response](#response)。 3808 3809**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3810 3811| 名称 | 类型 | 可读 | 可写 | 说明 | 3812| --------------- | ------ | ---- | ---- | -------------------------------------------------- | 3813| x | number | 是 | 是 | 地磁场的北分量。 | 3814| y | number | 是 | 是 | 地磁场的东分量。 | 3815| z | number | 是 | 是 | 地磁场的垂直分量。 | 3816| geomagneticDip | number | 是 | 是 | 地磁倾角，即地球磁场线与水平面的夹角。 | 3817| deflectionAngle | number | 是 | 是 | 地磁偏角，即地磁北方向与正北方向在水平面上的角度。 | 3818| levelIntensity | number | 是 | 是 | 地磁场的水平强度。 | 3819| totalIntensity | number | 是 | 是 | 地磁场的总强度。 | 3820 3821## LocationOptions 3822 3823指示地理位置。 3824 3825**系统能力**：以下各项对应的系统能力均为SystemCapability.Sensors.Sensor 3826 3827| 名称 | 类型 | 可读 | 可写 | 说明 | 3828| --------- | ------ | ---- | ---- | ---------- | 3829| latitude | number | 是 | 是 | 纬度。 | 3830| longitude | number | 是 | 是 | 经度。 | 3831| altitude | number | 是 | 是 | 海拔高度。 | 3832 3833## sensor.on<sup>(deprecated)</sup> 3834 3835### ACCELEROMETER<sup>(deprecated)</sup> 3836 3837on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<AccelerometerResponse>,options?: Options): void 3838 3839监听加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3840 3841从API version 9 开始不再维护，建议使用[sensor.on.ACCELEROMETER](#accelerometer9)代替。 3842 3843**需要权限**：ohos.permission.ACCELEROMETER 3844 3845**系统能力**：SystemCapability.Sensors.Sensor 3846 3847**参数：** 3848 3849| 参数名 | 类型 | 必填 | 说明 | 3850| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 3851| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER | 是 | 要订阅的加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。 | 3852| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 是 | 注册加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。 | 3853| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 3854 3855**示例：** 3856 3857 ```js 3858 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER,function(data){ 3859 console.info('X-coordinate component: ' + data.x); 3860 console.info('Y-coordinate component: ' + data.y); 3861 console.info('Z-coordinate component: ' + data.z); 3862 }, 3863 {interval: 10000000} 3864 ); 3865 ``` 3866 3867### LINEAR_ACCELERATION<sup>(deprecated)</sup> 3868 3869on(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback<LinearAccelerometerResponse>, options?: Options): void 3870 3871监听线性加速度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3872 3873从API version 9 开始不再维护，建议使用[sensor.on.LINEAR_ACCELEROMETER](#linear_accelerometer9)代替。 3874 3875**需要权限**：ohos.permission.ACCELEROMETER 3876 3877**系统能力**：SystemCapability.Sensors.Sensor 3878 3879**参数：** 3880 3881| 参数名 | 类型 | 必填 | 说明 | 3882| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 3883| type | [SensorType](#sensortype).SENSOR_TYPE_ID_LINEAR_ACCELERATION | 是 | 要订阅的线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。 | 3884| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 是 | 注册线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 | 3885| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 3886 3887### ACCELEROMETER_UNCALIBRATED<sup>(deprecated)</sup> 3888 3889on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback<AccelerometerUncalibratedResponse>, options?: Options): void 3890 3891监听未校准加速度计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3892 3893从API version 9 开始不再维护，建议使用[sensor.on.ACCELEROMETER_UNCALIBRATED](#accelerometer_uncalibrated9)代替。 3894 3895**需要权限**：ohos.permission.ACCELEROMETER 3896 3897**系统能力**：SystemCapability.Sensors.Sensor 3898 3899**参数：** 3900 3901| 参数名 | 类型 | 必填 | 说明 | 3902| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 3903| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED | 是 | 要订阅的未校准加速度计传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。 | 3904| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 是 | 注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 | 3905| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 3906 3907**示例：** 3908 ```js 3909 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,function(data){ 3910 console.info('X-coordinate component: ' + data.x); 3911 console.info('Y-coordinate component: ' + data.y); 3912 console.info('Z-coordinate component: ' + data.z); 3913 console.info('X-coordinate bias: ' + data.biasX); 3914 console.info('Y-coordinate bias: ' + data.biasY); 3915 console.info('Z-coordinate bias: ' + data.biasZ); 3916 }, 3917 {interval: 10000000} 3918 ); 3919 ``` 3920 3921### GRAVITY<sup>(deprecated)</sup> 3922 3923on(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback<GravityResponse>,options?: Options): void 3924 3925监听重力传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3926 3927从API version 9 开始不再维护，建议使用[sensor.on.GRAVITY](#gravity9)代替。 3928 3929**系统能力**：SystemCapability.Sensors.Sensor 3930 3931**参数：** 3932 3933| 参数名 | 类型 | 必填 | 说明 | 3934| -------- | --------------------------------------------------- | ---- | ----------------------------------------------------------- | 3935| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GRAVITY | 是 | 要订阅的重力传感器类型为SENSOR_TYPE_ID_GRAVITY。 | 3936| callback | Callback<[GravityResponse](#gravityresponse)> | 是 | 注册重力传感器的回调函数，上报的数据类型为GravityResponse。 | 3937| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 3938 3939**示例：** 3940 ```js 3941 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY,function(data){ 3942 console.info('X-coordinate component: ' + data.x); 3943 console.info('Y-coordinate component: ' + data.y); 3944 console.info('Z-coordinate component: ' + data.z); 3945 }, 3946 {interval: 10000000} 3947 ); 3948 ``` 3949 3950### GYROSCOPE<sup>(deprecated)</sup> 3951 3952on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeResponse>, options?: Options): void 3953 3954监听陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3955 3956从API version 9 开始不再维护，建议使用[sensor.on.GYROSCOPE](#gyroscope9)代替。 3957 3958**需要权限**：ohos.permission.GYROSCOPE 3959 3960**系统能力**：SystemCapability.Sensors.Sensor 3961 3962**参数：** 3963 3964| 参数名 | 类型 | 必填 | 说明 | 3965| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 3966| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE | 是 | 要订阅的陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。 | 3967| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 是 | 注册陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。 | 3968| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 3969 3970**示例：** 3971 ```js 3972 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE,function(data){ 3973 console.info('X-coordinate component: ' + data.x); 3974 console.info('Y-coordinate component: ' + data.y); 3975 console.info('Z-coordinate component: ' + data.z); 3976 }, 3977 {interval: 10000000} 3978 ); 3979 ``` 3980 3981### GYROSCOPE_UNCALIBRATED<sup>(deprecated)</sup> 3982 3983on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:Callback<GyroscopeUncalibratedResponse>, options?: Options): void 3984 3985监听未校准陀螺仪传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 3986 3987从API version 9 开始不再维护，建议使用[sensor.on.GYROSCOPE_UNCALIBRATED](#gyroscope_uncalibrated9)代替。 3988 3989**需要权限**：ohos.permission.GYROSCOPE 3990 3991**系统能力**：SystemCapability.Sensors.Sensor 3992 3993**参数：** 3994 3995| 参数名 | 类型 | 必填 | 说明 | 3996| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 3997| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED | 是 | 要订阅的未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。 | 3998| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 是 | 注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 | 3999| options | [Options](#options) | 否 | 可选参数列表，设置上报频率。 | 4000 4001**示例：** 4002 ```js 4003 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,function(data){ 4004 console.info('X-coordinate component: ' + data.x); 4005 console.info('Y-coordinate component: ' + data.y); 4006 console.info('Z-coordinate component: ' + data.z); 4007 console.info('X-coordinate bias: ' + data.biasX); 4008 console.info('Y-coordinate bias: ' + data.biasY); 4009 console.info('Z-coordinate bias: ' + data.biasZ); 4010 }, 4011 {interval: 10000000} 4012 ); 4013 ``` 4014 4015### SIGNIFICANT_MOTION<sup>(deprecated)</sup> 4016 4017on(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback: Callback<SignificantMotionResponse>, options?: Options): void 4018 4019监听大幅动作传感器数据变化。如果多次调用该接口，仅最后一次调用生效。 4020 4021从API version 9 开始不再维护，建议使用[sensor.on.SIGNIFICANT_MOTION](#significant_motion9) 代替。 4022 4023**系统能力**：SystemCapability.Sensors.Sensor 4024 4025**参数：** 4026 4027| 参数名 | 类型 | 必填 | 说明 | 4028| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4029| type | [SensorType](#sensortype).SENSOR_TYPE_ID_SIGNIFICANT_MOTION | 是 | 要订阅的大幅动作传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。 | 4030| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 是 | 注册有效运动传感器的回调函数，上报的数据类型为SignificantMotionResponse。 | 4031| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4032 4033**示例：** 4034 ```js 4035 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION,function(data){ 4036 console.info('Scalar data: ' + data.scalar); 4037 }, 4038 {interval: 10000000} 4039 ); 4040 ``` 4041 4042### PEDOMETER_DETECTION<sup>(deprecated)</sup> 4043 4044on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback: Callback<PedometerDetectionResponse>, options?: Options): void 4045 4046监听计步检测传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4047 4048从API version 9 开始不再维护，建议使用[sensor.on.PEDOMETER_DETECTION](#pedometer_detection9)代替。 4049 4050**需要权限**：ohos.permission.ACTIVITY_MOTION 4051 4052**系统能力**：SystemCapability.Sensors.Sensor 4053 4054**参数：** 4055 4056| 参数名 | 类型 | 必填 | 说明 | 4057| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4058| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER_DETECTION | 是 | 要订阅的计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。 | 4059| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 是 | 注册计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。 | 4060| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4061 4062**示例：** 4063 ```js 4064 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION,function(data){ 4065 console.info('Scalar data: ' + data.scalar); 4066 }, 4067 {interval: 10000000} 4068 ); 4069 ``` 4070 4071### PEDOMETER<sup>(deprecated)</sup> 4072 4073on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback<PedometerResponse>, options?: Options): void 4074 4075监听计步传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4076 4077从API version 9 开始不再维护，建议使用[sensor.on.PEDOMETER](#pedometer9)代替。 4078 4079**需要权限**：ohos.permission.ACTIVITY_MOTION 4080 4081**系统能力**：SystemCapability.Sensors.Sensor 4082 4083**参数：** 4084 4085| 参数名 | 类型 | 必填 | 说明 | 4086| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4087| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER | 是 | 要订阅的计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。 | 4088| callback | Callback<[PedometerResponse](#pedometerresponse)> | 是 | 注册计步传感器的回调函数，上报的数据类型为PedometerResponse。 | 4089| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4090 4091**示例：** 4092 ```js 4093 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER,function(data){ 4094 console.info('Steps: ' + data.steps); 4095 }, 4096 {interval: 10000000} 4097 ); 4098 ``` 4099 4100### AMBIENT_TEMPERATURE<sup>(deprecated)</sup> 4101 4102on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:Callback<AmbientTemperatureResponse>, options?: Options): void 4103 4104监听环境温度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4105 4106从API version 9 开始不再维护，建议使用[sensor.on.AMBIENT_TEMPERATURE](#ambient_temperature9)代替。 4107 4108**系统能力**：SystemCapability.Sensors.Sensor 4109 4110**参数：** 4111 4112| 参数名 | 类型 | 必填 | 说明 | 4113| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4114| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_TEMPERATURE | 是 | 要订阅的环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。 | 4115| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 是 | 注册环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。 | 4116| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4117 4118**示例：** 4119 4120 ```js 4121 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,function(data){ 4122 console.info('Temperature: ' + data.temperature); 4123 }, 4124 {interval: 10000000} 4125 ); 4126 ``` 4127 4128### MAGNETIC_FIELD<sup>(deprecated)</sup> 4129 4130on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>,options?: Options): void 4131 4132监听磁场传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4133 4134从API version 9 开始不再维护，建议使用[sensor.on.MAGNETIC_FIELD](#magnetic_field9)代替。 4135 4136**系统能力**：SystemCapability.Sensors.Sensor 4137 4138**参数：** 4139 4140| 参数名 | 类型 | 必填 | 说明 | 4141| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4142| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD | 是 | 要订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。 | 4143| callback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 是 | 注册磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。 | 4144| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4145 4146**示例：** 4147 4148 ```js 4149 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD,function(data){ 4150 console.info('X-coordinate component: ' + data.x); 4151 console.info('Y-coordinate component: ' + data.y); 4152 console.info('Z-coordinate component: ' + data.z); 4153 }, 4154 {interval: 10000000} 4155 ); 4156 ``` 4157 4158### MAGNETIC_FIELD_UNCALIBRATED<sup>(deprecated)</sup> 4159 4160on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback: Callback<MagneticFieldUncalibratedResponse>, options?: Options): void 4161 4162监听未校准磁场传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4163 4164从API version 9 开始不再维护，建议使用[sensor.on.MAGNETIC_FIELD_UNCALIBRATED](#magnetic_field_uncalibrated9)代替。 4165 4166**系统能力**：SystemCapability.Sensors.Sensor 4167 4168**参数：** 4169 4170| 参数名 | 类型 | 必填 | 说明 | 4171| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4172| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED | 是 | 要订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。 | 4173| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 是 | 注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 | 4174| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4175 4176**示例：** 4177 ```js 4178 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,function(data){ 4179 console.info('X-coordinate component: ' + data.x); 4180 console.info('Y-coordinate component: ' + data.y); 4181 console.info('Z-coordinate component: ' + data.z); 4182 console.info('X-coordinate bias: ' + data.biasX); 4183 console.info('Y-coordinate bias: ' + data.biasY); 4184 console.info('Z-coordinate bias: ' + data.biasZ); 4185 }, 4186 {interval: 10000000} 4187 ); 4188 ``` 4189 4190### PROXIMITY<sup>(deprecated)</sup> 4191 4192on(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback<ProximityResponse>,options?: Options): void 4193 4194监听接近光传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4195 4196从API version 9 开始不再维护，建议使用[sensor.on.PROXIMITY](#proximity9)代替。 4197 4198**系统能力**：SystemCapability.Sensors.Sensor 4199 4200**参数：** 4201 4202| 参数名 | 类型 | 必填 | 说明 | 4203| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4204| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PROXIMITY | 是 | 要订阅的接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。 | 4205| callback | Callback<[ProximityResponse](#proximityresponse)> | 是 | 注册接近光传感器的回调函数，上报的数据类型为ProximityResponse。 | 4206| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4207 4208**示例：** 4209 ```js 4210 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY,function(data){ 4211 console.info('Distance: ' + data.distance); 4212 }, 4213 {interval: 10000000} 4214 ); 4215 ``` 4216 4217### HUMIDITY<sup>(deprecated)</sup> 4218 4219on(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback<HumidityResponse>,options?: Options): void 4220 4221监听湿度传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4222 4223从API version 9 开始不再维护，建议使用[sensor.on.HUMIDITY](#humidity9)代替。 4224 4225**系统能力**：SystemCapability.Sensors.Sensor 4226 4227**参数：** 4228 4229| 参数名 | 类型 | 必填 | 说明 | 4230| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | 4231| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HUMIDITY | 是 | 要订阅的湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。 | 4232| callback | Callback<[HumidityResponse](#humidityresponse)> | 是 | 注册湿度传感器的回调函数，上报的数据类型为HumidityResponse。 | 4233| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4234 4235**示例：** 4236 4237 ```js 4238 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY,function(data){ 4239 console.info('Humidity: ' + data.humidity); 4240 }, 4241 {interval: 10000000} 4242 ); 4243 ``` 4244 4245### BAROMETER<sup>(deprecated)</sup> 4246 4247on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerResponse>,options?: Options): void 4248 4249监听气压计传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4250 4251从API version 9 开始不再维护，建议使用[sensor.on.BAROMETER](#barometer9)代替。 4252 4253**系统能力**：SystemCapability.Sensors.Sensor 4254 4255**参数：** 4256 4257| 参数名 | 类型 | 必填 | 说明 | 4258| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4259| type | [SensorType](#sensortype).SENSOR_TYPE_ID_BAROMETER | 是 | 要订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。 | 4260| callback | Callback<[BarometerResponse](#barometerresponse)> | 是 | 注册气压计传感器的回调函数，上报的数据类型为BarometerResponse。 | 4261| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4262 4263**示例：** 4264 4265 ```js 4266 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER,function(data){ 4267 console.info('Atmospheric pressure: ' + data.pressure); 4268 }, 4269 {interval: 10000000} 4270 ); 4271 ``` 4272 4273### HALL<sup>(deprecated)</sup> 4274 4275on(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback<HallResponse>, options?: Options): void 4276 4277监听霍尔传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4278 4279从API version 9 开始不再维护，建议使用[sensor.on.HALL](#hall9)代替。 4280 4281**系统能力**：SystemCapability.Sensors.Sensor 4282 4283**参数：** 4284 4285| 参数名 | 类型 | 必填 | 说明 | 4286| -------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | 4287| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HALL | 是 | 要订阅的霍尔传感器类型为SENSOR_TYPE_ID_HALL。 | 4288| callback | Callback<[HallResponse](#hallresponse)> | 是 | 注册霍尔传感器的回调函数，上报的数据类型为 HallResponse。 | 4289| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4290 4291**示例：** 4292 ```js 4293 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_HALL,function(data){ 4294 console.info('Status: ' + data.status); 4295 }, 4296 {interval: 10000000} 4297 ); 4298 ``` 4299 4300### AMBIENT_LIGHT<sup>(deprecated)</sup> 4301 4302on(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback<LightResponse>, options?: Options): void 4303 4304监听环境光传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4305 4306从API version 9 开始不再维护，建议使用[sensor.on.AMBIENT_LIGHT](#ambient_light9)代替。 4307 4308**系统能力**：SystemCapability.Sensors.Sensor 4309 4310**参数：** 4311 4312| 参数名 | 类型 | 必填 | 说明 | 4313| -------- | ------------------------------------------------------ | ---- | ----------------------------------------------------------- | 4314| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_LIGHT | 是 | 要订阅的环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。 | 4315| callback | Callback<[LightResponse](#lightresponse)> | 是 | 注册环境光传感器的回调函数，上报的数据类型为LightResponse。 | 4316| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4317 4318**示例：** 4319 4320 ```js 4321 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT,function(data){ 4322 console.info(' Illumination: ' + data.intensity); 4323 }, 4324 {interval: 10000000} 4325 ); 4326 ``` 4327 4328### ORIENTATION<sup>(deprecated)</sup> 4329 4330on(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback<OrientationResponse>, options?: Options): void 4331 4332监听方向传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4333 4334从API version 9 开始不再维护，建议使用[sensor.on.ORIENTATION](#orientation9)代替。 4335 4336**系统能力**：SystemCapability.Sensors.Sensor 4337 4338**参数：** 4339 4340| 参数名 | 类型 | 必填 | 说明 | 4341| -------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4342| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ORIENTATION | 是 | 要订阅的方向传感器类型为SENSOR_TYPE_ID_ORIENTATION | 4343| callback | Callback<[OrientationResponse](#orientationresponse)> | 是 | 注册方向传感器的回调函数，上报的数据类型为OrientationResponse。 | 4344| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4345 4346**示例：** 4347 ```js 4348 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION,function(data){ 4349 console.info('The device rotates at an angle around the X axis: ' + data.beta); 4350 console.info('The device rotates at an angle around the Y axis: ' + data.gamma); 4351 console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 4352 }, 4353 {interval: 10000000} 4354 ); 4355 ``` 4356 4357### HEART_RATE<sup>(deprecated)</sup> 4358 4359on(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback<HeartRateResponse>, options?: Options): void 4360 4361监听心率传感器数据变化一次。 4362 4363从API version 9 开始不再维护，建议使用[sensor.on.HEART_RATE](#heart_rate9)代替。 4364 4365**需要权限**：ohos.permission.HEALTH_DATA 4366 4367**系统能力**：SystemCapability.Sensors.Sensor 4368 4369**参数：** 4370 4371| 参数名 | 类型 | 必填 | 说明 | 4372| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4373| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HEART_RATE | 是 | 要订阅的心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。 | 4374| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 是 | 注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 | 4375 4376### ROTATION_VECTOR<sup>(deprecated)</sup> 4377 4378on(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR,callback: Callback<RotationVectorResponse>,options?: Options): void 4379 4380监听旋转矢量传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4381 4382从API version 9 开始不再维护，建议使用[sensor.on.ROTATION_VECTOR](#rotation_vector9)代替。 4383 4384**系统能力**：SystemCapability.Sensors.Sensor 4385 4386**参数：** 4387 4388| 参数名 | 类型 | 必填 | 说明 | 4389| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4390| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ROTATION_VECTOR | 是 | 要订阅的旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。 | 4391| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 是 | 注册旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。 | 4392| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4393 4394**示例：** 4395 ```js 4396 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR,function(data){ 4397 console.info('X-coordinate component: ' + data.x); 4398 console.info('Y-coordinate component: ' + data.y); 4399 console.info('Z-coordinate component: ' + data.z); 4400 console.info('Scalar quantity: ' + data.w); 4401 }, 4402 {interval: 10000000} 4403 ); 4404 ``` 4405 4406### WEAR_DETECTION<sup>(deprecated)</sup> 4407 4408on(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback<WearDetectionResponse>,options?: Options): void 4409 4410监听佩戴检测传感器的数据变化。如果多次调用该接口，仅最后一次调用生效。 4411 4412从API version 9 开始不再维护，建议使用[sensor.on.WEAR_DETECTION](#wear_detection9)代替。 4413 4414**系统能力**：SystemCapability.Sensors.Sensor 4415 4416**参数：** 4417 4418| 参数名 | 类型 | 必填 | 说明 | 4419| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4420| type | [SensorType](#sensortype).SENSOR_TYPE_ID_WEAR_DETECTION | 是 | 要订阅的佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。 | 4421| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 是 | 注册佩戴检测传感器的回调函数，上报的数据类型为WearDetectionResponse。 | 4422| options | [Options](#options) | 否 | 可选参数列表，设置上报频率，默认值为200000000ns。 | 4423 4424**示例：** 4425 ```js 4426 sensor.on(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION,function(data){ 4427 console.info('Wear status: ' + data.value); 4428 }, 4429 {interval: 10000000} 4430 ); 4431 ``` 4432 4433## sensor.once<sup>(deprecated)</sup> 4434 4435### ACCELEROMETER<sup>(deprecated)</sup> 4436 4437once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<AccelerometerResponse>): void 4438 4439监听加速度传感器的数据变化一次。 4440 4441从API version 9 开始不再维护，建议使用[sensor.once.ACCELEROMETER](#accelerometer9-1)代替。 4442 4443**需要权限**：ohos.permission.ACCELEROMETER 4444 4445**系统能力**：SystemCapability.Sensors.Sensor 4446 4447**参数：** 4448 4449| 参数名 | 类型 | 必填 | 说明 | 4450| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4451| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER | 是 | 加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。 | 4452| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 是 | 注册一次加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。 | 4453 4454**示例：** 4455 ```js 4456 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER,function(data){ 4457 console.info('X-coordinate component: ' + data.x); 4458 console.info('Y-coordinate component: ' + data.y); 4459 console.info('Z-coordinate component: ' + data.z); 4460 } 4461 ); 4462 ``` 4463 4464### LINEAR_ACCELERATION<sup>(deprecated)</sup> 4465 4466once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback<LinearAccelerometerResponse>): void 4467 4468监听线性加速度传感器数据变化一次。 4469 4470从API version 9 开始不再维护，建议使用[sensor.once.LINEAR_ACCELEROMETER](#linear_accelerometer9-1)代替。 4471 4472**需要权限**：ohos.permission.ACCELERATION 4473 4474**系统能力**：SystemCapability.Sensors.Sensor 4475 4476**参数：** 4477 4478| 参数名 | 类型 | 必填 | 说明 | 4479| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4480| type | [SensorType](#sensortype).SENSOR_TYPE_ID_LINEAR_ACCELERATION | 是 | 线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。 | 4481| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 是 | 注册一次线性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 | 4482 4483### ACCELEROMETER_UNCALIBRATED<sup>(deprecated)</sup> 4484 4485once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback<AccelerometerUncalibratedResponse>): void 4486 4487监听未校准加速度传感器的数据变化一次。 4488 4489从API version 9 开始不再维护，建议使用[sensor.once.ACCELEROMETER_UNCALIBRATED](#accelerometer_uncalibrated9-1)代替。 4490 4491**需要权限**：ohos.permission.ACCELEROMETER 4492 4493**系统能力**：SystemCapability.Sensors.Sensor 4494 4495**参数：** 4496 4497| 参数名 | 类型 | 必填 | 说明 | 4498| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4499| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED | 是 | 未校准加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。 | 4500| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 是 | 注册一次未校准加速度传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 | 4501 4502**示例：** 4503 ``` 4504 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, function(data) { 4505 console.info('X-coordinate component: ' + data.x); 4506 console.info('Y-coordinate component: ' + data.y); 4507 console.info('Z-coordinate component: ' + data.z); 4508 console.info('X-coordinate bias: ' + data.biasX); 4509 console.info('Y-coordinate bias: ' + data.biasY); 4510 console.info('Z-coordinate bias: ' + data.biasZ); 4511 } 4512 ); 4513 ``` 4514 4515### GRAVITY<sup>(deprecated)</sup> 4516 4517once(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback: Callback<GravityResponse>): void 4518 4519监听重力传感器的数据变化一次。 4520 4521从API version 9 开始不再维护，建议使用[sensor.once.GRAVITY](#gravity9-1)代替。 4522 4523**系统能力**：SystemCapability.Sensors.Sensor 4524 4525**参数：** 4526 4527| 参数名 | 类型 | 必填 | 说明 | 4528| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ | 4529| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GRAVITY | 是 | 重力传感器类型为SENSOR_TYPE_ID_GRAVITY。 | 4530| callback | Callback<[GravityResponse](#gravityresponse)> | 是 | 注册一次重力传感器的回调函数，上报的数据类型为GravityResponse。 | 4531 4532**示例：** 4533 ```js 4534 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, function(data) { 4535 console.info('X-coordinate component: ' + data.x); 4536 console.info('Y-coordinate component: ' + data.y); 4537 console.info('Z-coordinate component: ' + data.z); 4538 } 4539 ); 4540 ``` 4541 4542### GYROSCOPE<sup>(deprecated)</sup> 4543 4544once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeResponse>): void 4545 4546监听陀螺仪传感器的数据变化一次。 4547 4548从API version 9 开始不再维护，建议使用[sensor.once.GYROSCOPE](#gyroscope9-1)代替。 4549 4550**需要权限**：ohos.permission.GYROSCOPE 4551 4552**系统能力**：SystemCapability.Sensors.Sensor 4553 4554**参数：** 4555 4556| 参数名 | 类型 | 必填 | 说明 | 4557| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4558| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE | 是 | 陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。 | 4559| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 是 | 注册一次陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。 | 4560 4561**示例：** 4562 ```js 4563 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, function(data) { 4564 console.info('X-coordinate component: ' + data.x); 4565 console.info('Y-coordinate component: ' + data.y); 4566 console.info('Z-coordinate component: ' + data.z); 4567 } 4568 ); 4569 ``` 4570 4571### GYROSCOPE_UNCALIBRATED<sup>(deprecated)</sup> 4572 4573once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback: Callback<GyroscopeUncalibratedResponse>): void 4574 4575监听未校准陀螺仪传感器的数据变化一次。 4576 4577从API version 9 开始不再维护，建议使用[sensor.once.GYROSCOPE_UNCALIBRATED](#gyroscope_uncalibrated9-1)代替。 4578 4579**需要权限**：ohos.permission.GYROSCOPE 4580 4581**系统能力**：SystemCapability.Sensors.Sensor 4582 4583**参数：** 4584 4585| 参数名 | 类型 | 必填 | 说明 | 4586| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4587| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED | 是 | 未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。 | 4588| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 是 | 注册一次未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 | 4589 4590**示例：** 4591 ```js 4592 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, function(data) { 4593 console.info('X-coordinate component: ' + data.x); 4594 console.info('Y-coordinate component: ' + data.y); 4595 console.info('Z-coordinate component: ' + data.z); 4596 console.info('X-coordinate bias: ' + data.biasX); 4597 console.info('Y-coordinate bias: ' + data.biasY); 4598 console.info('Z-coordinate bias: ' + data.biasZ); 4599 } 4600 ); 4601 ``` 4602 4603### SIGNIFICANT_MOTION<sup>(deprecated)</sup> 4604 4605once(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION,callback: Callback<SignificantMotionResponse>): void 4606 4607监听有效运动传感器的数据变化一次。 4608 4609从API version 9 开始不再维护，建议使用[sensor.once.SIGNIFICANT_MOTION](#significant_motion9-1)代替。 4610 4611**系统能力**：SystemCapability.Sensors.Sensor 4612 4613**参数：** 4614 4615| 参数名 | 类型 | 必填 | 说明 | 4616| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4617| type | [SensorType](#sensortype).SENSOR_TYPE_ID_SIGNIFICANT_MOTION | 是 | 有效运动传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。 | 4618| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 是 | 注册一次有效运动传感器的回调函数，上报的数据类型为SignificantMotionResponse。 | 4619 4620**示例：** 4621 ```js 4622 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, function(data) { 4623 console.info('Scalar data: ' + data.scalar); 4624 } 4625 ); 4626 ``` 4627 4628### PEDOMETER_DETECTION<sup>(deprecated)</sup> 4629 4630once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION,callback: Callback<PedometerDetectionResponse>): void 4631 4632监听计步检测传感器数据变化一次。 4633 4634从API version 9 开始不再维护，建议使用[sensor.once.PEDOMETER_DETECTION](#pedometer_detection9-1)代替。 4635 4636**需要权限**：ohos.permission.ACTIVITY_MOTION 4637 4638**系统能力**：SystemCapability.Sensors.Sensor 4639 4640**参数：** 4641 4642| 参数名 | 类型 | 必填 | 说明 | 4643| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4644| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER_DETECTION | 是 | 计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。 | 4645| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 是 | 注册一次计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。 | 4646 4647**示例：** 4648 ```js 4649 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, function(data) { 4650 console.info('Scalar data: ' + data.scalar); 4651 } 4652 ); 4653 ``` 4654 4655### PEDOMETER<sup>(deprecated)</sup> 4656 4657once(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback<PedometerResponse>): void 4658 4659监听计步器传感器数据变化一次。 4660 4661从API version 9 开始不再维护，建议使用[sensor.once.PEDOMETER](#pedometer9-1)代替。 4662 4663**需要权限**：ohos.permission.ACTIVITY_MOTION 4664 4665**系统能力**：SystemCapability.Sensors.Sensor 4666 4667**参数：** 4668 4669| 参数名 | 类型 | 必填 | 说明 | 4670| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4671| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER | 是 | 计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。 | 4672| callback | Callback<[PedometerResponse](#pedometerresponse)> | 是 | 注册一次计步传感器的回调函数，上报的数据类型为PedometerResponse。 | 4673 4674**示例：** 4675 ```js 4676 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, function(data) { 4677 console.info('Steps: ' + data.steps); 4678 } 4679 ); 4680 ``` 4681 4682### AMBIENT_TEMPERATURE<sup>(deprecated)</sup> 4683 4684once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback: Callback<AmbientTemperatureResponse>): void 4685 4686监听环境温度传感器数据变化一次。 4687 4688从API version 9 开始不再维护，建议使用[sensor.once.AMBIENT_TEMPERATURE](#ambient_temperature9-1)代替。 4689 4690**系统能力**：SystemCapability.Sensors.Sensor 4691 4692**参数：** 4693 4694| 参数名 | 类型 | 必填 | 说明 | 4695| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4696| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_TEMPERATURE | 是 | 环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。 | 4697| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 是 | 注册一次环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。 | 4698 4699**示例：** 4700 ```js 4701 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, function(data) { 4702 console.info('Temperature: ' + data.temperature); 4703 } 4704 ); 4705 ``` 4706 4707### MAGNETIC_FIELD<sup>(deprecated)</sup> 4708 4709once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<MagneticFieldResponse>): void 4710 4711监听磁场传感器数据变化一次。 4712 4713从API version 9 开始不再维护，建议使用[sensor.once.MAGNETIC_FIELD](#magnetic_field9-1)代替。 4714 4715**系统能力**：SystemCapability.Sensors.Sensor 4716 4717**参数：** 4718 4719| 参数名 | 类型 | 必填 | 说明 | 4720| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4721| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD | 是 | 磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。 | 4722| callback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 是 | 注册一次磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。 | 4723 4724**示例：** 4725 ```js 4726 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, function(data) { 4727 console.info('X-coordinate component: ' + data.x); 4728 console.info('Y-coordinate component: ' + data.y); 4729 console.info('Z-coordinate component: ' + data.z); 4730 } 4731 ); 4732 ``` 4733 4734### MAGNETIC_FIELD_UNCALIBRATED<sup>(deprecated)</sup> 4735 4736once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback: Callback<MagneticFieldUncalibratedResponse>): void 4737 4738监听未校准磁场传感器数据变化一次。 4739 4740从API version 9 开始不再维护，建议使用[sensor.once.MAGNETIC_FIELD_UNCALIBRATED](#magnetic_field_uncalibrated9-1)代替。 4741 4742**系统能力**：SystemCapability.Sensors.Sensor 4743 4744**参数：** 4745 4746| 参数名 | 类型 | 必填 | 说明 | 4747| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4748| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED | 是 | 未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。 | 4749| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 是 | 注册一次未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 | 4750 4751**示例：** 4752 ```js 4753 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, function(data) { 4754 console.info('X-coordinate component: ' + data.x); 4755 console.info('Y-coordinate component: ' + data.y); 4756 console.info('Z-coordinate component: ' + data.z); 4757 console.info('X-coordinate bias: ' + data.biasX); 4758 console.info('Y-coordinate bias: ' + data.biasY); 4759 console.info('Z-coordinate bias: ' + data.biasZ); 4760 } 4761 ); 4762 ``` 4763 4764### PROXIMITY<sup>(deprecated)</sup> 4765 4766once(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback<ProximityResponse>): void 4767 4768监听接近光传感器数据变化一次。 4769 4770从API version 9 开始不再维护，建议使用[sensor.once.PROXIMITY](#proximity9-1)代替。 4771 4772**系统能力**：SystemCapability.Sensors.Sensor 4773 4774**参数：** 4775 4776| 参数名 | 类型 | 必填 | 说明 | 4777| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4778| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PROXIMITY | 是 | 接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。 | 4779| callback | Callback<[ProximityResponse](#proximityresponse)> | 是 | 注册一次接近光传感器的回调函数，上报的数据类型为ProximityResponse。 | 4780 4781**示例：** 4782 ```js 4783 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, function(data) { 4784 console.info('Distance: ' + data.distance); 4785 } 4786 ); 4787 ``` 4788 4789### HUMIDITY<sup>(deprecated)</sup> 4790 4791once(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback<HumidityResponse>): void 4792 4793监听湿度传感器数据变化一次。 4794 4795从API version 9 开始不再维护，建议使用[sensor.once.HUMIDITY](#humidity9-1)代替。 4796 4797**系统能力**：SystemCapability.Sensors.Sensor 4798 4799**参数：** 4800 4801| 参数名 | 类型 | 必填 | 说明 | 4802| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | 4803| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HUMIDITY | 是 | 湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。 | 4804| callback | Callback<[HumidityResponse](#humidityresponse)> | 是 | 注册一次湿度传感器的回调函数，上报的数据类型为HumidityResponse。 | 4805 4806**示例：** 4807 ```js 4808 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, function(data) { 4809 console.info('Humidity: ' + data.humidity); 4810 } 4811 ); 4812 ``` 4813 4814### BAROMETER<sup>(deprecated)</sup> 4815 4816once(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerResponse>): void 4817 4818监听气压计传感器数据变化一次。 4819 4820从API version 9 开始不再维护，建议使用[sensor.once.BAROMETER](#barometer9-1)代替。 4821 4822**系统能力**：SystemCapability.Sensors.Sensor 4823 4824**参数：** 4825 4826| 参数名 | 类型 | 必填 | 说明 | 4827| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4828| type | [SensorType](#sensortype).SENSOR_TYPE_ID_BAROMETER | 是 | 气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。 | 4829| callback | Callback<[BarometerResponse](#barometerresponse)> | 是 | 注册一次气压计传感器的回调函数，上报的数据类型为BarometerResponse。 | 4830 4831**示例：** 4832 ```js 4833 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, function(data) { 4834 console.info('Atmospheric pressure: ' + data.pressure); 4835 } 4836 ); 4837 ``` 4838 4839### HALL<sup>(deprecated)</sup> 4840 4841once(type: SensorType.SENSOR_TYPE_ID_HALL, callback: Callback<HallResponse>): void 4842 4843监听霍尔传感器数据变化一次。 4844 4845从API version 9 开始不再维护，建议使用[sensor.once.HALL](#hall9-1)代替。 4846 4847**系统能力**：SystemCapability.Sensors.Sensor 4848 4849**参数：** 4850 4851| 参数名 | 类型 | 必填 | 说明 | 4852| -------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | 4853| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HALL | 是 | 霍尔传感器类型为SENSOR_TYPE_ID_HALL。 | 4854| callback | Callback<[HallResponse](#hallresponse)> | 是 | 注册一次霍尔传感器的回调函数，上报的数据类型为HallResponse。 | 4855 4856**示例：** 4857 ```js 4858 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_HALL, function(data) { 4859 console.info('Status: ' + data.status); 4860 } 4861 ); 4862 ``` 4863 4864### AMBIENT_LIGHT<sup>(deprecated)</sup> 4865 4866once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback<LightResponse>): void 4867 4868监听环境光传感器数据变化一次。 4869 4870从API version 9 开始不再维护，建议使用[sensor.once.AMBIENT_LIGHT](#ambient_light9-1)代替。 4871 4872**系统能力**：SystemCapability.Sensors.Sensor 4873 4874**参数：** 4875 4876| 参数名 | 类型 | 必填 | 说明 | 4877| -------- | ------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4878| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_LIGHT | 是 | 环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。 | 4879| callback | Callback<[LightResponse](#lightresponse)> | 是 | 注册一次环境光传感器的回调函数，上报的数据类型为LightResponse。 | 4880 4881**示例：** 4882 4883 ```js 4884 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, function(data) { 4885 console.info(' Illumination: ' + data.intensity); 4886 } 4887 ); 4888 ``` 4889 4890### ORIENTATION<sup>(deprecated)</sup> 4891 4892once(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback<OrientationResponse>): void 4893 4894监听方向传感器数据变化一次。 4895 4896从API version 9 开始不再维护，建议使用[sensor.once.ORIENTATION](#orientation9-1)代替。 4897 4898**系统能力**：SystemCapability.Sensors.Sensor 4899 4900**参数：** 4901 4902| 参数名 | 类型 | 必填 | 说明 | 4903| -------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4904| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ORIENTATION | 是 | 方向传感器类型为SENSOR_TYPE_ID_ORIENTATION。 | 4905| callback | Callback<[OrientationResponse](#orientationresponse)> | 是 | 注册一次方向传感器的回调函数，上报的数据类型为OrientationResponse。 | 4906 4907**示例：** 4908 ```js 4909 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, function(data) { 4910 console.info('The device rotates at an angle around the X axis: ' + data.beta); 4911 console.info('The device rotates at an angle around the Y axis: ' + data.gamma); 4912 console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 4913 } 4914 ); 4915 ``` 4916 4917### ROTATION_VECTOR<sup>(deprecated)</sup> 4918 4919once(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: Callback<RotationVectorResponse>): void 4920 4921监听旋转矢量传感器数据变化一次。 4922 4923从API version 9 开始不再维护，建议使用[sensor.once.ROTATION_VECTOR](#rotation_vector9-1)代替。 4924 4925**系统能力**：SystemCapability.Sensors.Sensor 4926 4927**参数：** 4928 4929| 参数名 | 类型 | 必填 | 说明 | 4930| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4931| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ROTATION_VECTOR | 是 | 旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。 | 4932| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 是 | 注册一次旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。 | 4933 4934**示例：** 4935 ```js 4936 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, function(data) { 4937 console.info('X-coordinate component: ' + data.x); 4938 console.info('Y-coordinate component: ' + data.y); 4939 console.info('Z-coordinate component: ' + data.z); 4940 console.info('Scalar quantity: ' + data.w); 4941 } 4942 ); 4943 ``` 4944 4945### HEART_RATE<sup>(deprecated)</sup> 4946 4947once(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback<HeartRateResponse>): void 4948 4949监听心率传感器数据变化一次。 4950 4951从API version 9 开始不再维护，建议使用[sensor.once.HEART_RATE](#heart_rate9-1)代替。 4952 4953**需要权限**：ohos.permission.HEART_RATE 4954 4955**系统能力**：SystemCapability.Sensors.Sensor 4956 4957**参数：** 4958 4959| 参数名 | 类型 | 必填 | 说明 | 4960| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 4961| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HEART_RATE | 是 | 心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。 | 4962| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 是 | 注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 | 4963 4964### WEAR_DETECTION<sup>(deprecated)</sup> 4965 4966once(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback: Callback<WearDetectionResponse>): void 4967 4968监听佩戴检测传感器数据变化一次。 4969 4970从API version 9 开始不再维护，建议使用[sensor.once.WEAR_DETECTION](#wear_detection9-1)代替。 4971 4972**系统能力**：SystemCapability.Sensors.Sensor 4973 4974**参数：** 4975 4976| 参数名 | 类型 | 必填 | 说明 | 4977| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 4978| type | [SensorType](#sensortype).SENSOR_TYPE_ID_WEAR_DETECTION | 是 | 佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。 | 4979| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 是 | 注册一次穿戴检测传感器的回调函数，上报的数据类型为WearDetectionResponse。 | 4980 4981**示例：** 4982 ```js 4983 sensor.once(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, function(data) { 4984 console.info("Wear status: "+ data.value); 4985 } 4986 ); 4987 ``` 4988 4989## sensor.off<sup>(deprecated)</sup> 4990 4991### ACCELEROMETER<sup>(deprecated)</sup> 4992 4993off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback?: Callback<AccelerometerResponse>): void 4994 4995取消订阅传感器数据。 4996 4997从API version 9 开始不再维护，建议使用[sensor.off.ACCELEROMETER](#accelerometer9-2)代替。 4998 4999**需要权限**：ohos.permission.ACCELEROMETER 5000 5001**系统能力**：SystemCapability.Sensors.Sensor 5002 5003**参数：** 5004 5005| 参数名 | 类型 | 必填 | 说明 | 5006| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5007| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER | 是 | 要取消订阅的加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。 | 5008| callback | Callback<[AccelerometerResponse](#accelerometerresponse)> | 否 | 取消注册加速度传感器的回调函数，上报的数据类型为AccelerometerResponse。 | 5009 5010**示例：** 5011 5012```js 5013function callback(data) { 5014 console.info('x-coordinate component: ' + data.x); 5015 console.info('Y-coordinate component: ' + data.y); 5016 console.info('Z-coordinate component: ' + data.z); 5017} 5018sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback); 5019``` 5020 5021### ACCELEROMETER_UNCALIBRATED<sup>(deprecated)</sup> 5022 5023off(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback?: Callback<AccelerometerUncalibratedResponse>): void 5024 5025取消订阅传感器数据。 5026 5027从API version 9 开始不再维护，建议使用[sensor.off.ACCELEROMETER_UNCALIBRATED](#accelerometer_uncalibrated9-2)代替。 5028 5029**需要权限**：ohos.permission.ACCELEROMETER 5030 5031**系统能力**：SystemCapability.Sensors.Sensor 5032 5033**参数：** 5034 5035| 参数名 | 类型 | 必填 | 说明 | 5036| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5037| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED | 是 | 要取消订阅的未校准加速度计传感器类型为SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED。 | 5038| callback | Callback<[AccelerometerUncalibratedResponse](#accelerometeruncalibratedresponse)> | 否 | 取消注册未校准加速度计传感器的回调函数，上报的数据类型为AccelerometerUncalibratedResponse。 | 5039 5040**示例：** 5041 5042```js 5043function callback(data) { 5044 console.info('X-coordinate component: ' + data.x); 5045 console.info('Y-coordinate component: ' + data.y); 5046 console.info('Z-coordinate component: ' + data.z); 5047 console.info('X-coordinate bias: ' + data.biasX); 5048 console.info('Y-coordinate bias: ' + data.biasY); 5049 console.info('Z-coordinate bias: ' + data.biasZ); 5050} 5051sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED, callback); 5052``` 5053 5054### AMBIENT_LIGHT<sup>(deprecated)</sup> 5055 5056off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback?: Callback<LightResponse>): void 5057 5058取消订阅传感器数据。 5059 5060从API version 9 开始不再维护，建议使用[sensor.off.AMBIENT_LIGHT](#ambient_light9-2)代替。 5061 5062**系统能力**：SystemCapability.Sensors.Sensor 5063 5064**参数：** 5065 5066| 参数名 | 类型 | 必填 | 说明 | 5067| -------- | ------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5068| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_LIGHT | 是 | 要取消订阅的环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。 | 5069| callback | Callback<[LightResponse](#lightresponse)> | 否 | 取消注册环境光传感器的回调函数，上报的数据类型为LightResponse。 | 5070 5071**示例：** 5072 5073```js 5074function callback(data) { 5075 console.info(' Illumination: ' + data.intensity); 5076} 5077sensor.off(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback); 5078``` 5079 5080### AMBIENT_TEMPERATURE<sup>(deprecated)</sup> 5081 5082off(type: SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback?: Callback<AmbientTemperatureResponse>): void 5083 5084取消订阅传感器数据。 5085 5086从API version 9 开始不再维护，建议使用[sensor.off.AMBIENT_TEMPERATURE](#ambient_temperature9-2)代替。 5087 5088**系统能力**：SystemCapability.Sensors.Sensor 5089 5090**参数：** 5091 5092| 参数名 | 类型 | 必填 | 说明 | 5093| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5094| type | [SensorType](#sensortype).SENSOR_TYPE_ID_AMBIENT_TEMPERATURE | 是 | 要取消订阅的环境温度传感器类型为SENSOR_TYPE_ID_AMBIENT_TEMPERATURE。 | 5095| callback | Callback<[AmbientTemperatureResponse](#ambienttemperatureresponse)> | 否 | 取消注册环境温度传感器的回调函数，上报的数据类型为AmbientTemperatureResponse。 | 5096 5097**示例：** 5098 5099```js 5100function callback(data) { 5101 console.info('Temperature: ' + data.temperature); 5102} 5103sensor.off(sensor.SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE, callback); 5104``` 5105 5106### BAROMETER<sup>(deprecated)</sup> 5107 5108off(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback?: Callback<BarometerResponse>): void 5109 5110取消订阅传感器数据。 5111 5112从API version 9 开始不再维护，建议使用[sensor.off.BAROMETER](#barometer9-2)代替。 5113 5114**系统能力**：SystemCapability.Sensors.Sensor 5115 5116**参数：** 5117 5118| 参数名 | 类型 | 必填 | 说明 | 5119| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5120| type | [SensorType](#sensortype).SENSOR_TYPE_ID_BAROMETER | 是 | 要取消订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。 | 5121| callback | Callback<[BarometerResponse](#barometerresponse)> | 否 | 取消注册气压计传感器的回调函数，上报的数据类型为BarometerResponse。 | 5122 5123**示例：** 5124 5125```js 5126function callback(data) { 5127 console.info('Atmospheric pressure: ' + data.pressure); 5128} 5129sensor.off(sensor.SensorType.SENSOR_TYPE_ID_BAROMETER, callback); 5130``` 5131 5132### GRAVITY<sup>(deprecated)</sup> 5133 5134off(type: SensorType.SENSOR_TYPE_ID_GRAVITY, callback?: Callback<GravityResponse>): void 5135 5136取消订阅传感器数据。 5137 5138从API version 9 开始不再维护，建议使用[sensor.off.GRAVITY](#gravity9-2)代替。 5139 5140**系统能力**：SystemCapability.Sensors.Sensor 5141 5142**参数：** 5143 5144| 参数名 | 类型 | 必填 | 说明 | 5145| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ | 5146| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GRAVITY | 是 | 要取消订阅的重力传感器类型为SENSOR_TYPE_ID_GRAVITY。 | 5147| callback | Callback<[GravityResponse](#gravityresponse)> | 否 | 取消注册注册重力传感器的回调函数，上报的数据类型为GravityResponse。 | 5148 5149**示例：** 5150 5151```js 5152function callback(data) { 5153 console.info('X-coordinate component: ' + data.x); 5154 console.info('Y-coordinate component: ' + data.y); 5155 console.info('Z-coordinate component: ' + data.z); 5156} 5157sensor.off( sensor.SensorType.SENSOR_TYPE_ID_GRAVITY, callback); 5158``` 5159 5160### GYROSCOPE<sup>(deprecated)</sup> 5161 5162off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback?: Callback<GyroscopeResponse>): void 5163 5164取消订阅传感器数据。 5165 5166从API version 9 开始不再维护，建议使用[sensor.off.GYROSCOPE](#gyroscope9-2)代替。 5167 5168**需要权限**：ohos.permission.GYROSCOPE 5169 5170**系统能力**：SystemCapability.Sensors.Sensor 5171 5172**参数：** 5173 5174| 参数名 | 类型 | 必填 | 说明 | 5175| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5176| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE | 是 | 要取消订阅的陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE。 | 5177| callback | Callback<[GyroscopeResponse](#gyroscoperesponse)> | 否 | 取消注册陀螺仪传感器的回调函数，上报的数据类型为GyroscopeResponse。 | 5178 5179**示例：** 5180 5181```js 5182function callback(data) { 5183 console.info('X-coordinate component: ' + data.x); 5184 console.info('Y-coordinate component: ' + data.y); 5185 console.info('Z-coordinate component: ' + data.z); 5186} 5187sensor.off(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback); 5188``` 5189 5190### GYROSCOPE_UNCALIBRATED<sup>(deprecated)</sup> 5191 5192off(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback?: Callback<GyroscopeUncalibratedResponse>): void 5193 5194取消订阅传感器数据。 5195 5196从API version 9 开始不再维护，建议使用[sensor.off.GYROSCOPE_UNCALIBRATED](#gyroscope_uncalibrated9-2)代替。 5197 5198**需要权限**：ohos.permission.GYROSCOPE 5199 5200**系统能力**：SystemCapability.Sensors.Sensor 5201 5202**参数：** 5203 5204| 参数名 | 类型 | 必填 | 说明 | 5205| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5206| type | [SensorType](#sensortype).SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED | 是 | 要取消订阅的未校准陀螺仪传感器类型为SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED。 | 5207| callback | Callback<[GyroscopeUncalibratedResponse](#gyroscopeuncalibratedresponse)> | 否 | 取消注册未校准陀螺仪传感器的回调函数，上报的数据类型为GyroscopeUncalibratedResponse。 | 5208 5209**示例：** 5210 5211```js 5212function callback(data) { 5213 console.info('X-coordinate component: ' + data.x); 5214 console.info('Y-coordinate component: ' + data.y); 5215 console.info('Z-coordinate component: ' + data.z); 5216} 5217sensor.off(sensor.SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED, callback); 5218``` 5219 5220### HALL<sup>(deprecated)</sup> 5221 5222off(type: SensorType.SENSOR_TYPE_ID_HALL, callback?: Callback<HallResponse>): void 5223 5224取消订阅传感器数据。 5225 5226从API version 9 开始不再维护，建议使用[sensor.off.HALL](#hall9-2)代替。 5227 5228**系统能力**：SystemCapability.Sensors.Sensor 5229 5230**参数：** 5231 5232| 参数名 | 类型 | 必填 | 说明 | 5233| -------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | 5234| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HALL | 是 | 要取消订阅的霍尔传感器类型为SENSOR_TYPE_ID_HALL。 | 5235| callback | Callback<[HallResponse](#hallresponse)> | 否 | 取消注册霍尔传感器的回调函数，上报的数据类型为 HallResponse。 | 5236 5237**示例：** 5238 5239```js 5240function callback(data) { 5241 console.info('Status: ' + data.status); 5242} 5243sensor.off(sensor.SensorType.SENSOR_TYPE_ID_HALL, callback); 5244``` 5245 5246### HEART_RATE<sup>(deprecated)</sup> 5247 5248off(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback?: Callback<HeartRateResponse>): void 5249 5250取消订阅传感器数据。 5251 5252从API version 9 开始不再维护，建议使用[sensor.off.HEART_RATE](#heart_rate9-2)代替。 5253 5254**需要权限**：ohos.permission.HEALTH_DATA 5255 5256**系统能力**：SystemCapability.Sensors.Sensor 5257 5258**参数：** 5259 5260| 参数名 | 类型 | 必填 | 说明 | 5261| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5262| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HEART_RATE | 是 | 要取消订阅的心率传感器类型为SENSOR_TYPE_ID_HEART_RATE。 | 5263| callback | Callback<[HeartRateResponse](#heartrateresponse)> | 否 | 取消注册一次心率传感器的回调函数，上报的数据类型为HeartRateResponse。 | 5264 5265### HUMIDITY<sup>(deprecated)</sup> 5266 5267off(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback?: Callback<HumidityResponse>): void 5268 5269取消订阅传感器数据。 5270 5271从API version 9 开始不再维护，建议使用[sensor.off.HUMIDITY](#humidity9-2)代替。 5272 5273**系统能力**：SystemCapability.Sensors.Sensor 5274 5275**参数：** 5276 5277| 参数名 | 类型 | 必填 | 说明 | 5278| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | 5279| type | [SensorType](#sensortype).SENSOR_TYPE_ID_HUMIDITY | 是 | 要取消订阅的湿度传感器类型为SENSOR_TYPE_ID_HUMIDITY。 | 5280| callback | Callback<[HumidityResponse](#humidityresponse)> | 否 | 取消注册湿度传感器的回调函数，上报的数据类型为HumidityResponse。 | 5281 5282**示例：** 5283 5284```js 5285function callback(data) { 5286 console.info('Humidity: ' + data.humidity); 5287} 5288sensor.off(sensor.SensorType.SENSOR_TYPE_ID_HUMIDITY, callback); 5289``` 5290 5291### LINEAR_ACCELERATION<sup>(deprecated)</sup> 5292 5293off(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback?: Callback<LinearAccelerometerResponse>): void 5294 5295取消订阅传感器数据。 5296 5297从API version 9 开始不再维护，建议使用[sensor.off.LINEAR_ACCELEROMETER](#linear_accelerometer9-2)代替。 5298 5299**需要权限**：ohos.permission.ACCELEROMETER 5300 5301**系统能力**：SystemCapability.Sensors.Sensor 5302 5303**参数：** 5304 5305| 参数名 | 类型 | 必填 | 说明 | 5306| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5307| type | [SensorType](#sensortype).SENSOR_TYPE_ID_LINEAR_ACCELERATION | 是 | 要取消订阅的线性加速度传感器类型为SENSOR_TYPE_ID_LINEAR_ACCELERATION。 | 5308| callback | Callback<[LinearAccelerometerResponse](#linearaccelerometerresponse)> | 否 | 取消注册性加速度传感器的回调函数，上报的数据类型为LinearAccelerometerResponse。 | 5309 5310### MAGNETIC_FIELD<sup>(deprecated)</sup> 5311 5312 off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback?: Callback<MagneticFieldResponse>): void 5313 5314取消订阅传感器数据。 5315 5316从API version 9 开始不再维护，建议使用[sensor.off.MAGNETIC_FIELD](#magnetic_field9-2)代替。 5317 5318**系统能力**：SystemCapability.Sensors.Sensor 5319 5320**参数：** 5321 5322| 参数名 | 类型 | 必填 | 说明 | 5323| ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5324| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD | 是 | 要取消订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。 | 5325| callbackcallback | Callback<[MagneticFieldResponse](#magneticfieldresponse)> | 否 | 取消注册磁场传感器的回调函数，上报的数据类型为MagneticFieldResponse。 | 5326 5327**示例：** 5328 5329```js 5330function callback(data) { 5331 console.info('X-coordinate component: ' + data.x); 5332 console.info('Y-coordinate component: ' + data.y); 5333 console.info('Z-coordinate component: ' + data.z); 5334} 5335sensor.off(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback); 5336``` 5337 5338### MAGNETIC_FIELD_UNCALIBRATED<sup>(deprecated)</sup> 5339 5340 off(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback?: Callback<MagneticFieldUncalibratedResponse>): void 5341 5342取消订阅传感器数据。 5343 5344从API version 9 开始不再维护，建议使用[sensor.off.MAGNETIC_FIELD_UNCALIBRATED](#magnetic_field_uncalibrated9-2)代替。 5345 5346**系统能力**：SystemCapability.Sensors.Sensor 5347 5348**参数：** 5349 5350| 参数名 | 类型 | 必填 | 说明 | 5351| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5352| type | [SensorType](#sensortype).SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED | 是 | 要取消订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。 | 5353| callback | Callback<[MagneticFieldUncalibratedResponse](#magneticfielduncalibratedresponse)> | 否 | 取消注册未校准磁场传感器的回调函数，上报的数据类型为MagneticFieldUncalibratedResponse。 | 5354 5355**示例：** 5356 5357```js 5358function callback(data) { 5359 console.info('X-coordinate component: ' + data.x); 5360 console.info('Y-coordinate component: ' + data.y); 5361 console.info('Z-coordinate component: ' + data.z); 5362 console.info('X-coordinate bias: ' + data.biasX); 5363 console.info('Y-coordinate bias: ' + data.biasY); 5364 console.info('Z-coordinate bias: ' + data.biasZ); 5365} 5366sensor.off(sensor.SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED, callback); 5367``` 5368 5369### ORIENTATION<sup>(deprecated)</sup> 5370 5371 off(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback?: Callback<OrientationResponse>): void 5372 5373取消订阅传感器数据。 5374 5375从API version 9 开始不再维护，建议使用[sensor.off.ORIENTATION](#orientation9-2)代替。 5376 5377**系统能力**：SystemCapability.Sensors.Sensor 5378 5379**参数：** 5380 5381| 参数名 | 类型 | 必填 | 说明 | 5382| -------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5383| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ORIENTATION | 是 | 要取消订阅的方向传感器类型为SENSOR_TYPE_ID_ORIENTATION | 5384| callback | Callback<[OrientationResponse](#orientationresponse)> | 否 | 取消注册方向传感器的回调函数，上报的数据类型为OrientationResponse。 | 5385 5386**示例：** 5387 5388```js 5389function callback(data) { 5390 console.info('The device rotates at an angle around the X axis: ' + data.beta); 5391 console.info('The device rotates at an angle around the Y axis: ' + data.gamma); 5392 console.info('The device rotates at an angle around the Z axis: ' + data.alpha); 5393} 5394sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ORIENTATION, callback); 5395``` 5396 5397### PEDOMETER<sup>(deprecated)</sup> 5398 5399off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback?: Callback<PedometerResponse>): void 5400 5401取消订阅传感器数据。 5402 5403从API version 9 开始不再维护，建议使用[sensor.off.PEDOMETER](#pedometer9-2)代替。 5404 5405**需要权限**：ohos.permission.ACTIVITY_MOTION 5406 5407**系统能力**：SystemCapability.Sensors.Sensor 5408 5409**参数：** 5410 5411| 参数名 | 类型 | 必填 | 说明 | 5412| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5413| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER | 是 | 要取消订阅的计步传感器类型为SENSOR_TYPE_ID_PEDOMETER。 | 5414| callback | Callback<[PedometerResponse](#pedometerresponse)> | 否 | 取消注册计步传感器的回调函数，上报的数据类型为PedometerResponse。 | 5415 5416**示例：** 5417 5418```js 5419function callback(data) { 5420 console.info('Steps: ' + data.steps); 5421} 5422sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER, callback); 5423``` 5424 5425### PEDOMETER_DETECTION<sup>(deprecated)</sup> 5426 5427off(type: SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback?: Callback<PedometerDetectionResponse>): void 5428 5429取消订阅传感器数据。 5430 5431从API version 9 开始不再维护，建议使用[sensor.off.PEDOMETER_DETECTION](#pedometer_detection9-2)代替。 5432 5433**需要权限**：ohos.permission.ACTIVITY_MOTION 5434 5435**系统能力**：SystemCapability.Sensors.Sensor 5436 5437**参数：** 5438 5439| 参数名 | 类型 | 必填 | 说明 | 5440| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5441| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PEDOMETER_DETECTION | 是 | 要取消订阅的计步检测传感器类型为SENSOR_TYPE_ID_PEDOMETER_DETECTION。 | 5442| callback | Callback<[PedometerDetectionResponse](#pedometerdetectionresponse)> | 否 | 取消注册计步检测传感器的回调函数，上报的数据类型为PedometerDetectionResponse。 | 5443 5444**示例：** 5445 5446```js 5447function callback(data) { 5448 console.info('Scalar data: ' + data.scalar); 5449} 5450sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PEDOMETER_DETECTION, callback); 5451``` 5452 5453### PROXIMITY<sup>(deprecated)</sup> 5454 5455off(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback?: Callback<ProximityResponse>): void 5456 5457取消订阅传感器数据。 5458 5459从API version 9 开始不再维护，建议使用[sensor.off.PROXIMITY](#proximity9-2)代替。 5460 5461**系统能力**：SystemCapability.Sensors.Sensor 5462 5463**参数：** 5464 5465| 参数名 | 类型 | 必填 | 说明 | 5466| -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | 5467| type | [SensorType](#sensortype).SENSOR_TYPE_ID_PROXIMITY | 是 | 要取消订阅的接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。 | 5468| callback | Callback<[ProximityResponse](#proximityresponse)> | 否 | 取消注册接近光传感器的回调函数，上报的数据类型为ProximityResponse。 | 5469 5470**示例：** 5471 5472```js 5473function callback(data) { 5474 console.info('Distance: ' + data.distance); 5475} 5476sensor.off(sensor.SensorType.SENSOR_TYPE_ID_PROXIMITY, callback); 5477``` 5478 5479### ROTATION_VECTOR<sup>(deprecated)</sup> 5480 5481off(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback?: Callback<RotationVectorResponse>): void 5482 5483取消订阅传感器数据。 5484 5485从API version 9 开始不再维护，建议使用[sensor.off.ROTATION_VECTOR](#rotation_vector9-2)代替。 5486 5487**系统能力**：SystemCapability.Sensors.Sensor 5488 5489**参数：** 5490 5491| 参数名 | 类型 | 必填 | 说明 | 5492| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5493| type | [SensorType](#sensortype).SENSOR_TYPE_ID_ROTATION_VECTOR | 是 | 要取消订阅的旋转矢量传感器类型为SENSOR_TYPE_ID_ROTATION_VECTOR。 | 5494| callback | Callback<[RotationVectorResponse](#rotationvectorresponse)> | 否 | 取消注册旋转矢量传感器的回调函数，上报的数据类型为RotationVectorResponse。 | 5495 5496**示例：** 5497 5498```js 5499function callback(data) { 5500 console.info('X-coordinate component: ' + data.x); 5501 console.info('Y-coordinate component: ' + data.y); 5502 console.info('Z-coordinate component: ' + data.z); 5503 console.info('Scalar quantity: ' + data.w); 5504} 5505sensor.off(sensor.SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback); 5506``` 5507 5508### SIGNIFICANT_MOTION<sup>(deprecated)</sup> 5509 5510off(type: SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback?: Callback<SignificantMotionResponse>): void 5511 5512取消订阅传感器数据。 5513 5514从API version 9 开始不再维护，建议使用[sensor.off.SIGNIFICANT_MOTION](#significant_motion9-2)代替。 5515 5516**系统能力**：SystemCapability.Sensors.Sensor 5517 5518**参数：** 5519 5520| 参数名 | 类型 | 必填 | 说明 | 5521| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5522| type | [SensorType](#sensortype).SENSOR_TYPE_ID_SIGNIFICANT_MOTION | 是 | 要取消订阅的大幅动作传感器类型为SENSOR_TYPE_ID_SIGNIFICANT_MOTION。 | 5523| callback | Callback<[SignificantMotionResponse](#significantmotionresponse)> | 否 | 取消注册有效运动传感器的回调函数，上报的数据类型为SignificantMotionResponse。 | 5524 5525**示例：** 5526 5527```js 5528function callback(data) { 5529 console.info('Scalar data: ' + data.scalar); 5530} 5531sensor.off(sensor.SensorType.SENSOR_TYPE_ID_SIGNIFICANT_MOTION, callback); 5532``` 5533 5534### WEAR_DETECTION<sup>(deprecated)</sup> 5535 5536off(type: SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, callback?: Callback<WearDetectionResponse>): void 5537 5538取消订阅传感器数据。 5539 5540从API version 9 开始不再维护，建议使用[sensor.off.WEAR_DETECTION](#wear_detection9-2)代替。 5541 5542**系统能力**：SystemCapability.Sensors.Sensor 5543 5544**参数：** 5545 5546| 参数名 | 类型 | 必填 | 说明 | 5547| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 5548| type | [SensorType](#sensortype).SENSOR_TYPE_ID_WEAR_DETECTION | 是 | 要取消订阅的佩戴检测传感器类型为SENSOR_TYPE_ID_WEAR_DETECTION。 | 5549| callback | Callback<[WearDetectionResponse](#weardetectionresponse)> | 否 | 取消注册佩戴检测传感器的回调函数，上报的数据类型为WearDetectionResponse。 | 5550 5551**示例：** 5552 5553```js 5554function accCallback(data) { 5555 console.info('Wear status: ' + data.value); 5556} 5557sensor.off(sensor.SensorType.SENSOR_TYPE_ID_WEAR_DETECTION, accCallback); 5558``` 5559 5560## sensor.transformCoordinateSystem<sup>(deprecated)</sup> 5561 5562transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions, callback: AsyncCallback<Array<number>>): void 5563 5564旋转提供的旋转矩阵，使其可以以不同的方式表示坐标系。 5565 5566从API version 9 开始不再维护，建议使用[sensor.transformRotationMatrix](#sensortransformrotationmatrix9)代替。 5567 5568**系统能力**：SystemCapability.Sensors.Sensor 5569 5570**参数：** 5571 5572| 参数名 | 类型 | 必填 | 说明 | 5573| ---------------- | ---------------------------------------- | ---- | ----------- | 5574| inRotationVector | Array<number> | 是 | 表示旋转矩阵。 | 5575| coordinates | [CoordinatesOptions](#coordinatesoptions) | 是 | 表示坐标系方向。 | 5576| callback | AsyncCallback<Array<number>> | 是 | 返回转换后的旋转矩阵。 | 5577 5578**示例：** 5579 5580```js 5581sensor.transformCoordinateSystem([1, 0, 0, 0, 1, 0, 0, 0, 1], {x:2, y:3}, function(err, data) { 5582 if (err) { 5583 console.error("Operation failed. Error code: " + err.code + ", message: " + err.message); 5584 return; 5585 } 5586 console.info("Operation succeeded. Data obtained: " + data); 5587 for (var i=0; i < data.length; i++) { 5588 console.info("transformCoordinateSystem data[ " + i + "] = " + data[i]); 5589 } 5590 }) 5591``` 5592## sensor.transformCoordinateSystem<sup>(deprecated)</sup> 5593 5594transformCoordinateSystem(inRotationVector: Array<number>, coordinates: CoordinatesOptions): Promise<Array<number>> 5595 5596旋转提供的旋转矩阵，使其可以以不同的方式表示坐标系。 5597 5598从API version 9 开始不再维护，建议使用[sensor.transformRotationMatrix](#sensortransformrotationmatrix9-1)代替。 5599 5600**系统能力**：SystemCapability.Sensors.Sensor 5601 5602**参数：** 5603 5604| 参数名 | 类型 | 必填 | 说明 | 5605| ---------------- | ---------------------------------------- | ---- | -------- | 5606| inRotationVector | Array<number> | 是 | 表示旋转矩阵。 | 5607| coordinates | [CoordinatesOptions](#coordinatesoptions) | 是 | 表示坐标系方向。 | 5608 5609**返回值：** 5610 5611| 类型 | 说明 | 5612| ---------------------------------- | ----------- | 5613| Promise<Array<number>> | 返回转换后的旋转矩阵。 | 5614 5615**示例：** 5616 5617```js 5618const promise = sensor.transformCoordinateSystem([1, 0, 0, 0, 1, 0, 0, 0, 1], {x:2, y:3}); 5619 promise.then((data) => { 5620 console.info("Operation succeeded."); 5621 for (var i=0; i < data.length; i++) { 5622 console.info("transformCoordinateSystem data[ " + i + "] = " + data[i]); 5623 } 5624 }).catch((err) => { 5625 console.info("Operation failed"); 5626}) 5627``` 5628 5629## sensor.getGeomagneticField<sup>(deprecated)</sup> 5630 5631getGeomagneticField(locationOptions: LocationOptions, timeMillis: number, callback: AsyncCallback<GeomagneticResponse>): void 5632 5633获取地球上特定位置的地磁场。 5634 5635从API version 9 开始不再维护，建议使用[sensor.getGeomagneticInfo](#sensorgetgeomagneticinfo9)代替。 5636 5637**系统能力**：SystemCapability.Sensors.Sensor 5638 5639**参数：** 5640 5641| 参数名 | 类型 | 必填 | 说明 | 5642| --------------- | ------------------------------------------------------------ | ---- | ---------------------------------- | 5643| locationOptions | [LocationOptions](#locationoptions) | 是 | 地理位置。 | 5644| timeMillis | number | 是 | 表示获取磁偏角的时间，单位为毫秒。 | 5645| callback | AsyncCallback<[GeomagneticResponse](#geomagneticresponse)> | 是 | 返回磁场信息。 | 5646 5647**示例：** 5648```js 5649sensor.getGeomagneticField({latitude:80, longitude:0, altitude:0}, 1580486400000, function(err, data) { 5650 if (err) { 5651 console.error('Operation failed. Error code: ' + err.code + '; message: ' + err.message); 5652 return; 5653 } 5654 console.info('sensor_getGeomagneticField_callback x: ' + data.x + ',y: ' + data.y + ',z: ' + 5655 data.z + ',geomagneticDip: ' + data.geomagneticDip + ',deflectionAngle: ' + data.deflectionAngle + 5656 ',levelIntensity: ' + data.levelIntensity + ',totalIntensity: ' + data.totalIntensity); 5657}); 5658``` 5659## sensor.getGeomagneticField<sup>(deprecated)</sup> 5660 5661getGeomagneticField(locationOptions: LocationOptions, timeMillis: number): Promise<GeomagneticResponse> 5662 5663获取地球上特定位置的地磁场。 5664 5665从API version 9 开始不再维护，建议使用[sensor.getGeomagneticInfo](#sensorgetgeomagneticinfo9-1)代替。 5666 5667**系统能力**：SystemCapability.Sensors.Sensor 5668 5669**参数：** 5670 5671| 参数名 | 类型 | 必填 | 说明 | 5672| --------------- | ----------------------------------- | ---- | ----------------- | 5673| locationOptions | [LocationOptions](#locationoptions) | 是 | 地理位置。 | 5674| timeMillis | number | 是 | 表示获取磁偏角的时间，单位为毫秒。 | 5675 5676**返回值：** 5677| 类型 | 说明 | 5678| ---------------------------------------- | ------- | 5679| Promise<[GeomagneticResponse](#geomagneticresponse)> | 返回磁场信息。 | 5680 5681**示例：** 5682 ```js 5683 const promise = sensor.getGeomagneticField({latitude:80, longitude:0, altitude:0}, 1580486400000); 5684 promise.then((data) => { 5685 console.info('sensor_getGeomagneticField_promise x: ' + data.x + ',y: ' + data.y + ',z: ' + 5686 data.z + ',geomagneticDip: ' + data.geomagneticDip + ',deflectionAngle: ' + data.deflectionAngle + 5687 ',levelIntensity: ' + data.levelIntensity + ',totalIntensity: ' + data.totalIntensity); 5688 }).catch((reason) => { 5689 console.info('Operation failed.'); 5690 }) 5691 ``` 5692 5693## sensor.getAltitude<sup>(deprecated)</sup> 5694 5695getAltitude(seaPressure: number, currentPressure: number, callback: AsyncCallback<number>): void 5696 5697根据气压值获取设备所在的海拔高度。 5698 5699从API version 9 开始不再维护，建议使用[sensor.getDeviceAltitude](#sensorgetdevicealtitude9)代替。 5700 5701**系统能力**：SystemCapability.Sensors.Sensor 5702 5703**参数：** 5704 5705| 参数名 | 类型 | 必填 | 说明 | 5706| --------------- | --------------------------- | ---- | -------------------- | 5707| seaPressure | number | 是 | 表示海平面气压值，单位为hPa。 | 5708| currentPressure | number | 是 | 表示设备所在高度的气压值，单位为hPa。 | 5709| callback | AsyncCallback<number> | 是 | 返回设备所在的海拔高度，单位为米。 | 5710 5711**示例：** 5712 5713 ```js 5714 sensor.getAltitude(0, 200, function(err, data) { 5715 if (err) { 5716 console.error( 5717 "Operation failed. Error code: " + err.code + ", message: " + err.message); 5718 return; 5719 } 5720 console.info("Succeeded to get getAltitude interface get data: " + data); 5721 }); 5722 ``` 5723 5724## sensor.getAltitude<sup>(deprecated)</sup> 5725 5726getAltitude(seaPressure: number, currentPressure: number): Promise<number> 5727 5728根据气压值获取设备所在的海拔高度。 5729 5730从API version 9 开始不再维护，建议使用[sensor.getDeviceAltitude](#sensorgetdevicealtitude9-1)代替。 5731 5732**系统能力**：SystemCapability.Sensors.Sensor 5733 5734**参数：** 5735 5736| 参数名 | 类型 | 必填 | 说明 | 5737| --------------- | ------ | ---- | -------------------- | 5738| seaPressure | number | 是 | 表示海平面气压值，单位为hPa。 | 5739| currentPressure | number | 是 | 表示设备所在高度的气压值，单位为hPa。 | 5740 5741**返回值：** 5742 5743| 类型 | 说明 | 5744| --------------------- | ------------------ | 5745| Promise<number> | 返回设备所在的海拔高度（单位：米）。 | 5746 5747**示例：** 5748 5749 ```js 5750 const promise = sensor.getAltitude(0, 200); 5751 promise.then((data) => { 5752 console.info(' sensor_getAltitude_Promise success', data); 5753 }).catch((err) => { 5754 console.error("Operation failed"); 5755 }) 5756 ``` 5757 5758 5759## sensor.getGeomagneticDip<sup>(deprecated)</sup> 5760 5761getGeomagneticDip(inclinationMatrix: Array<number>, callback: AsyncCallback<number>): void 5762 5763根据倾斜矩阵计算地磁倾斜角。 5764 5765从API version 9 开始不再维护，建议使用[sensor.getInclination](#sensorgetinclination9)代替。 5766 5767**系统能力**：SystemCapability.Sensors.Sensor 5768 5769**参数：** 5770 5771| 参数名 | 类型 | 必填 | 说明 | 5772| ----------------- | --------------------------- | ---- | -------------- | 5773| inclinationMatrix | Array<number> | 是 | 表示倾斜矩阵。 | 5774| callback | AsyncCallback<number> | 是 | 返回地磁倾斜角，单位为弧度。 | 5775 5776**示例：** 5777 5778 ```js 5779 sensor.getGeomagneticDip([1, 0, 0, 0, 1, 0, 0, 0, 1], function(err, data) { 5780 if (err) { 5781 console.error('SensorJsAPI--->Failed to register data, error code is:' + err.code + ', message: ' + 5782 err.message); 5783 return; 5784 } 5785 console.info("Succeeded to get getGeomagneticDip interface get data: " + data); 5786 }) 5787 ``` 5788 5789## sensor.getGeomagneticDip<sup>(deprecated)</sup> 5790 5791getGeomagneticDip(inclinationMatrix: Array<number>): Promise<number> 5792 5793根据倾斜矩阵计算地磁倾斜角。 5794 5795从API version 9 开始不再维护，建议使用[sensor.getInclination](#sensorgetinclination9-1)代替。 5796 5797**系统能力**：SystemCapability.Sensors.Sensor 5798 5799**参数：** 5800 5801| 参数名 | 类型 | 必填 | 说明 | 5802| ----------------- | ------------------- | ---- | ------- | 5803| inclinationMatrix | Array<number> | 是 | 表示倾斜矩阵。 | 5804 5805**返回值：** 5806 5807| 类型 | 说明 | 5808| --------------------- | -------------- | 5809| Promise<number> | 返回地磁倾斜角，单位为弧度。 | 5810 5811**示例：** 5812 5813 ```js 5814 const promise = sensor.getGeomagneticDip([1, 0, 0, 0, 1, 0, 0, 0, 1]); 5815 promise.then((data) => { 5816 console.info('getGeomagneticDip_promise succeeded', data); 5817 }).catch((err) => { 5818 console.error("Operation failed"); 5819 }) 5820 ``` 5821 5822## sensor. getAngleModify<sup>(deprecated)</sup> 5823 5824getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void 5825 5826获取两个旋转矩阵之间的角度变化。 5827 5828从API version 9 开始不再维护，建议使用[sensor.getAngleVariation](#sensorgetanglevariation9)代替。 5829 5830**系统能力**：SystemCapability.Sensors.Sensor 5831 5832**参数：** 5833 5834| 参数名 | 类型 | 必填 | 说明 | 5835| --------------------- | ---------------------------------------- | ---- | ------------------ | 5836| currentRotationMatrix | Array<number> | 是 | 表示当前旋转矩阵。 | 5837| preRotationMatrix | Array<number> | 是 | 表示旋转矩阵。 | 5838| callback | AsyncCallback<Array<number>> | 是 | 返回z、x、y轴方向的旋转角度变化。 | 5839 5840**示例：** 5841 5842 ```js 5843 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) { 5844 if (err) { 5845 console.error('Failed to register data, error code is: ' + err.code + ', message: ' + 5846 err.message); 5847 return; 5848 } 5849 for (var i=0; i < data.length; i++) { 5850 console.info("data[" + i + "]: " + data[i]); 5851 } 5852 }) 5853 ``` 5854 5855 5856## sensor. getAngleModify<sup>(deprecated)</sup> 5857 5858getAngleModify(currentRotationMatrix: Array<number>, preRotationMatrix: Array<number>): Promise<Array<number>> 5859 5860获取两个旋转矩阵之间的角度变化。 5861 5862从API version 9 开始不再维护，建议使用[sensor.getAngleVariation](#sensorgetanglevariation9-1)代替。 5863 5864**系统能力**：SystemCapability.Sensors.Sensor 5865 5866**参数：** 5867 5868| 参数名 | 类型 | 必填 | 说明 | 5869| --------------------- | ------------------- | ---- | --------- | 5870| currentRotationMatrix | Array<number> | 是 | 表示当前旋转矩阵。 | 5871| preRotationMatrix | Array<number> | 是 | 表示旋转矩阵。 | 5872 5873**返回值：** 5874 5875| 类型 | 说明 | 5876| ---------------------------------- | ------------------ | 5877| Promise<Array<number>> | 返回z、x、y轴方向的旋转角度变化。 | 5878 5879**示例：** 5880 5881 ```js 5882 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]); 5883 promise.then((data) => { 5884 console.info('getAngleModify_promise success'); 5885 for (var i=0; i < data.length; i++) { 5886 console.info("data[" + i + "]: " + data[i]); 5887 } 5888 }).catch((reason) => { 5889 console.info("promise::catch", reason); 5890 }) 5891 ``` 5892 5893 5894## sensor.createRotationMatrix<sup>(deprecated)</sup> 5895 5896createRotationMatrix(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void 5897 5898将旋转矢量转换为旋转矩阵。 5899 5900从API version 9 开始不再维护，建议使用[sensor.getRotationMatrix](#sensorgetrotationmatrix9)代替。 5901 5902**系统能力**：SystemCapability.Sensors.Sensor 5903 5904**参数：** 5905 5906| 参数名 | 类型 | 必填 | 说明 | 5907| -------------- | ---------------------------------------- | ---- | ------- | 5908| rotationVector | Array<number> | 是 | 表示旋转矢量。 | 5909| callback | AsyncCallback<Array<number>> | 是 | 返回旋转矩阵。 | 5910 5911**示例：** 5912 5913 ```js 5914 sensor.createRotationMatrix([0.20046076, 0.21907, 0.73978853, 0.60376877], function(err, data) { 5915 if (err) { 5916 console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' + 5917 err.message); 5918 return; 5919 } 5920 for (var i=0; i < data.length; i++) { 5921 console.info("data[" + i + "]: " + data[i]); 5922 } 5923 }) 5924 ``` 5925 5926 5927## sensor.createRotationMatrix<sup>(deprecated)</sup> 5928 5929createRotationMatrix(rotationVector: Array<number>): Promise<Array<number>> 5930 5931将旋转矢量转换为旋转矩阵。 5932 5933从API version 9 开始不再维护，建议使用[sensor.getRotationMatrix](#sensorgetrotationmatrix9-1)代替。 5934 5935**系统能力**：SystemCapability.Sensors.Sensor 5936 5937**参数：** 5938 5939| 参数名 | 类型 | 必填 | 说明 | 5940| -------------- | ------------------- | ---- | ------- | 5941| rotationVector | Array<number> | 是 | 表示旋转矢量。 | 5942 5943**返回值：** 5944 5945| 类型 | 说明 | 5946| ---------------------------------- | ------- | 5947| Promise<Array<number>> | 返回旋转矩阵。 | 5948 5949**示例：** 5950 5951 ```js 5952 const promise = sensor.createRotationMatrix([0.20046076, 0.21907, 0.73978853, 0.60376877]); 5953 promise.then((data) => { 5954 console.info('createRotationMatrix_promise success'); 5955 for (var i=0; i < data.length; i++) { 5956 console.info("data[" + i + "]: " + data[i]); 5957 } 5958 }).catch((reason) => { 5959 console.info("promise::catch", reason); 5960 }) 5961 ``` 5962 5963 5964## sensor.createQuaternion<sup>(deprecated)</sup> 5965 5966createQuaternion(rotationVector: Array<number>, callback: AsyncCallback<Array<number>>): void 5967 5968将旋转矢量转换为四元数。 5969 5970从API version 9 开始不再维护，建议使用[sensor.getQuaternion](#sensorgetquaternion9)代替。 5971 5972**系统能力**：SystemCapability.Sensors.Sensor 5973 5974**参数：** 5975 5976| 参数名 | 类型 | 必填 | 说明 | 5977| -------------- | ---------------------------------------- | ---- | ------- | 5978| rotationVector | Array<number> | 是 | 表示旋转矢量。 | 5979| callback | AsyncCallback<Array<number>> | 是 | 返回四元数。 | 5980 5981**示例：** 5982 5983 ```js 5984 sensor.createQuaternion([0.20046076, 0.21907, 0.73978853, 0.60376877], function(err, data) { 5985 if (err) { 5986 console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' + 5987 err.message); 5988 return; 5989 } 5990 for (var i=0; i < data.length; i++) { 5991 console.info("data[" + i + "]: " + data[i]); 5992 } 5993 }) 5994 ``` 5995 5996 5997## sensor.createQuaternion<sup>(deprecated)</sup> 5998 5999createQuaternion(rotationVector: Array<number>): Promise<Array<number>> 6000 6001将旋转矢量转换为四元数。 6002 6003从API version 9 开始不再维护，建议使用[sensor.getQuaternion](#sensorgetquaternion9-1)代替。 6004 6005**系统能力**：SystemCapability.Sensors.Sensor 6006 6007**参数：** 6008 6009| 参数名 | 类型 | 必填 | 说明 | 6010| -------------- | ------------------- | ---- | ------- | 6011| rotationVector | Array<number> | 是 | 表示旋转矢量。 | 6012 6013**返回值：** 6014 6015| 类型 | 说明 | 6016| ---------------------------------- | ------ | 6017| Promise<Array<number>> | 返回四元数。 | 6018 6019**示例：** 6020 6021 ```js 6022 const promise = sensor.createQuaternion([0.20046076, 0.21907, 0.73978853, 0.60376877]); 6023 promise.then((data) => { 6024 console.info('createQuaternion_promise succeeded'); 6025 for (var i=0; i < data.length; i++) { 6026 console.info("data[" + i + "]: " + data[i]); 6027 } 6028 }).catch((err) => { 6029 console.info('promise failed'); 6030 }) 6031 ``` 6032 6033 6034## sensor.getDirection<sup>(deprecated)</sup> 6035 6036getDirection(rotationMatrix: Array<number>, callback: AsyncCallback<Array<number>>): void 6037 6038根据旋转矩阵计算设备的方向。 6039 6040从API version 9 开始不再维护，建议使用[sensor.getOrientation](#sensorgetorientation9)代替。 6041 6042**系统能力**：SystemCapability.Sensors.Sensor 6043 6044**参数：** 6045 6046| 参数名 | 类型 | 必填 | 说明 | 6047| -------------- | ---------------------------------------- | ---- | ------------------ | 6048| rotationMatrix | Array<number> | 是 | 表示旋转矩阵。 | 6049| callback | AsyncCallback<Array<number>> | 是 | 返回围绕z、x、y轴方向的旋转角度。 | 6050 6051**示例：** 6052 6053 ```js 6054 sensor.getDirection([1, 0, 0, 0, 1, 0, 0, 0, 1], function(err, data) { 6055 if (err) { 6056 console.error('SensorJsAPI--->Failed to register data, error code is: ' + err.code + ', message: ' + 6057 err.message); 6058 return; 6059 } 6060 console.info("SensorJsAPI--->Succeeded to get getDirection interface get data: " + data); 6061 for (var i = 1; i < data.length; i++) { 6062 console.info("sensor_getDirection_callback" + data[i]); 6063 } 6064 }) 6065 ``` 6066 6067 6068## sensor.getDirection<sup>(deprecated)</sup> 6069 6070getDirection(rotationMatrix: Array<number>): Promise<Array<number>> 6071 6072根据旋转矩阵计算设备的方向。 6073 6074从API version 9 开始不再维护，建议使用[sensor.getOrientation](#sensorgetorientation9-1)代替。 6075 6076**系统能力**：SystemCapability.Sensors.Sensor 6077 6078**参数：** 6079 6080| 参数名 | 类型 | 必填 | 说明 | 6081| -------------- | ------------------- | ---- | ------- | 6082| rotationMatrix | Array<number> | 是 | 表示旋转矩阵。 | 6083 6084**返回值：** 6085 6086| 类型 | 说明 | 6087| ---------------------------------- | ------------------ | 6088| Promise<Array<number>> | 返回围绕z、x、y轴方向的旋转角度。 | 6089 6090**示例：** 6091 6092 ```js 6093 const promise = sensor.getDirection([1, 0, 0, 0, 1, 0, 0, 0, 1]); 6094 promise.then((data) => { 6095 console.info('sensor_getAltitude_Promise success', data); 6096 for (var i = 1; i < data.length; i++) { 6097 console.info("sensor_getDirection_promise" + data[i]); 6098 } 6099 }).catch((err) => { 6100 console.info('promise failed'); 6101 }) 6102 ``` 6103 6104 6105## sensor.createRotationMatrix<sup>(deprecated)</sup> 6106 6107createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>, callback: AsyncCallback<RotationMatrixResponse>): void 6108 6109根据重力矢量和地磁矢量计算旋转矩阵。 6110 6111从API version 9 开始不再维护，建议使用[sensor.getRotationMatrix](#sensorgetrotationmatrix9-2)代替。 6112 6113**系统能力**：SystemCapability.Sensors.Sensor 6114 6115**参数：** 6116 6117| 参数名 | 类型 | 必填 | 说明 | 6118| ----------- | ---------------------------------------- | ---- | ------- | 6119| gravity | Array<number> | 是 | 表示重力向量。 | 6120| geomagnetic | Array<number> | 是 | 表示地磁矢量。 | 6121| callback | AsyncCallback<[RotationMatrixResponse](#rotationmatrixresponse)> | 是 | 返回旋转矩阵。 | 6122 6123**示例：** 6124 6125 ```js 6126 sensor.createRotationMatrix([-0.27775216, 0.5351276, 9.788099], [210.87253, -78.6096, -111.44444], function(err, data) { 6127 if (err) { 6128 console.error('error code is: ' + err.code + ', message: ' + err.message); 6129 return; 6130 } 6131 console.info(JSON.stringify(data)); 6132 }) 6133 ``` 6134 6135 6136## sensor.createRotationMatrix<sup>(deprecated)</sup> 6137 6138createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number>,): Promise<RotationMatrixResponse> 6139 6140根据重力矢量和地磁矢量计算旋转矩阵。 6141 6142从API version 9 开始不再维护，建议使用[sensor.getRotationMatrix](#sensorgetrotationmatrix9-3)代替。 6143 6144**系统能力**：SystemCapability.Sensors.Sensor 6145 6146**参数：** 6147 6148| 参数名 | 类型 | 必填 | 说明 | 6149| ----------- | ------------------- | ---- | ------- | 6150| gravity | Array<number> | 是 | 表示重力向量。 | 6151| geomagnetic | Array<number> | 是 | 表示地磁矢量。 | 6152 6153**返回值：** 6154 6155| 类型 | 说明 | 6156| ---------------------------------------- | ------- | 6157| Promise<[RotationMatrixResponse](#rotationmatrixresponse)> | 返回旋转矩阵。 | 6158 6159**示例：** 6160 6161 ```js 6162 const promise = sensor.createRotationMatrix([-0.27775216, 0.5351276, 9.788099], [210.87253, -78.6096, -111.44444]); 6163 promise.then((data) => { 6164 console.info(JSON.stringify(data)); 6165 }).catch((err) => { 6166 console.info('promise failed'); 6167 }) 6168 ``` 6169