Sensor Development

When to Use

With the sensor module, a device can obtain sensor data. For example, the device can subscribe to data of the orientation sensor to detect its own orientation, and data of the pedometer sensor to learn the number of steps the user walks every day.

For details about the APIs, see Sensor.

Available APIs

How to Develop

1. Before obtaining data from a type of sensor, check whether the required permission has been configured.
   The system provides the following sensor-related permissions:

   • ohos.permission.ACCELEROMETER

   • ohos.permission.GYROSCOPE

   • ohos.permission.ACTIVITY_MOTION

   • ohos.permission.READ_HEALTH_DATA

   For details about how to configure a permission, see Declaring Permissions.

2. Subscribe to data changes of a type of sensor. The following uses the acceleration sensor as an example.

   import sensor from "@ohos.sensor";
   sensor.on(sensor.SensorId.ACCELEROMETER, function(data){
      console.info("Data obtained successfully. x: " + data.x + "y: " + data.y + "z: " + data.z); // Data is obtained.
   });
   

   

3. Unsubscribe from sensor data changes.

   import sensor from "@ohos.sensor";
   sensor.off(sensor.SensorId.ACCELEROMETER);
   

   

4. Subscribe to only one data change of a type of sensor.

   import sensor from "@ohos.sensor";
   sensor.once(sensor.SensorId.ACCELEROMETER, function(data) {
      console.info("Data obtained successfully. x: " + data.x + "y: " + data.y + "z: " + data.z); // Data is obtained.
   });
   

   

   If the API fails to be called, you are advised to use the try/catch statement to capture error information that may occur in the code. Example:

   import sensor from "@ohos.sensor";
   try {
     sensor.once(sensor.SensorId.ACCELEROMETER, function(data) {
         console.info("Data obtained successfully. x: " + data.x + "y: " + data.y + "z: " + data.z); // Data is obtained.
     });
   } catch (error) {
     console.error("Get sensor data error. data:" + error.data, " msg:", error.message);
   }