HarmonyOS鸿蒙Next传感器开发指南

一、传感器开发概述

HarmonyOS系统传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的Sensor接口，可以查询设备上的传感器，订阅传感器数据，并根据传感器数据定制相应的算法开发各类应用，比如指南针、运动健康、游戏等。

运作机制

HarmonyOS传感器包含如下四个模块：Sensor API、Sensor Framework、Sensor Service和HDF层。

• Sensor API：提供传感器的基础API，主要包含查询传感器列表，订阅/取消传感器的数据、执行控制命令等，简化应用开发。
• Sensor Framework：主要实现传感器的订阅管理，数据通道的创建、销毁、订阅与取消订阅，实现与SensorService的通信。
• Sensor Service：主要实现HD_IDL层数据接收、解析、分发，前后台的策略管控，对该设备Sensor的管理，Sensor权限管控等。
• HDF层：对不同的FIFO、频率进行策略选择，以及适配不同设备。

约束与限制

权限需求

针对下面所列传感器，开发者需要请求响应的权限，才能获取到相应传感器的数据。

开发注意事项

1. 传感器数据订阅和取消订阅接口成对调用，当不再需要订阅传感器数据时，开发者需要调用取消订阅接口停止数据上报。

二、传感器开发指导

场景介绍

当设备需要获取传感器数据时，可以使用sensor模块，例如：通过订阅方向传感器数据感知用户设备当前的朝向，通过订阅计步传感器数据统计用户的步数等。

详细的接口介绍请参考Sensor接口。

接口说明

开发步骤

1. 获取设备上传感器的数据前，需要检查是否已经配置请求相应的权限。

   • 系统提供的传感器权限有：
     • ohos.permission.ACCELEROMETER
     • ohos.permission.GYROSCOPE
     • ohos.permission.ACTIVITY_MOTION
     • ohos.permission.READ_HEALTH_DATA

   具体配置方式请参考权限申请声明。

2. 以下场景以加速度传感器ACCELEROMETER为例。展示持续监听传感器接口的调用结果。

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); // 获取数据成功
});

1. 注销传感器数据监听。

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

1. 获取一次传感器数据变化。

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); // 获取数据成功
});

若接口调用不成功，建议使用try/catch语句捕获代码中可能出现的错误信息。例如：

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); // 获取数据成功
  });
} catch (error) {
  console.error("Get sensor data error, error:" + error.data, ", msg:", error.message);
}