AI 助理
备案控制台
开发者社区 人工智能 文章 正文

HarmonyOS学习路之开发篇—设备管理（传感器开发）

2023-08-07 512
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： HarmonyOS传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的Sensor API，可以查询设备上的传感器，订阅传感器的数据，并根据传感器数据定制相应的算法，开发各类应用，比如指南针、运动健康、游戏等。

传感器开发概述

基本概念

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


根据传感器的用途，可以将传感器分为六大类：运动类传感器、环境类传感器、方向类传感器、光线类传感器、健康类传感器、其他类传感器（如霍尔传感器），每一大类传感器包含不同类型的传感器，某种类型的传感器可能是单一的物理传感器，也可能是由多个物理传感器复合而成。


表1 传感器列表

分类


API类名


传感器类型


中文描述


说明


主要用途


运动类


ohos.sensor.agent.CategoryMotionAgent


SENSOR_TYPE_ACCELEROMETER


加速度传感器


测量三个物理轴（x、y 和 z）上，施加在设备上的加速度（包括重力加速度），单位 : m/s2


检测运动状态


SENSOR_TYPE_ACCELEROMETER_UNCALIBRATED


未校准加速度传感器


测量三个物理轴（x、y 和 z）上，施加在设备上的未校准的加速度（包括重力加速度），单位 : m/s2


检测加速度偏差估值


SENSOR_TYPE_LINEAR_ACCELERATION


线性加速度传感器


测量三个物理轴（x、y 和 z）上，施加在设备上的线性加速度（不包括重力加速度），单位 : m/s2


检测每个单轴方向上的线性加速度


SENSOR_TYPE_GRAVITY


重力传感器


测量三个物理轴（x、y 和 z）上，施加在设备上的重力加速度，单位 : m/s2


测量重力大小


SENSOR_TYPE_GYROSCOPE


陀螺仪传感器


测量三个物理轴（x、y 和 z）上，设备的旋转角速度，单位 : rad/s


测量旋转的角速度


SENSOR_TYPE_GYROSCOPE_UNCALIBRATED


未校准陀螺仪传感器


测量三个物理轴（x、y 和 z）上，设备的未校准旋转角速度，单位 : rad/s


测量旋转的角速度及偏差估值


SENSOR_TYPE_SIGNIFICANT_MOTION


大幅度动作传感器


测量三个物理轴（x、y 和 z）上，设备是否存在大幅度运动；如果取值为1则代表存在大幅度运动，取值为0则代表没有大幅度运动


用于检测设备是否存在大幅度运动


SENSOR_TYPE_DROP_DETECTION


跌落检测传感器


检测设备的跌落状态；如果取值为1则代表发生跌落，取值为0则代表没有发生跌落


用于检测设备是否发生了跌落


SENSOR_TYPE_PEDOMETER_DETECTION


计步器检测传感器


检测用户的计步动作；如果取值为1则代表用户产生了计步行走的动作；取值为0则代表用户没有发生运动


用于检测用户是否有计步的动作


SENSOR_TYPE_PEDOMETER


计步器传感器


统计用户的行走步数


用于提供用户行走的步数数据


环境类


ohos.sensor.agent.CategoryEnvironmentAgent


SENSOR_TYPE_AMBIENT_TEMPERATURE


环境温度传感器


测量环境温度，单位 : 摄氏度 (°C)


测量环境温度


SENSOR_TYPE_MAGNETIC_FIELD


磁场传感器


测量三个物理轴向（x、y、z）上，环境地磁场，单位 : μT


创建指南针


SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED


未校准磁场传感器


测量三个物理轴向（x、y、z）上，未校准环境地磁场，单位 : μT


测量地磁偏差估值


SENSOR_TYPE_HUMIDITY


湿度传感器


测量环境的相对湿度，以百分比 (%) 表示


监测露点、绝对湿度和相对湿度


SENSOR_TYPE_BAROMETER


气压计传感器


测量环境气压，单位 : hPa 或 mbar


测量环境气压


SENSOR_TYPE_SAR


比吸收率传感器


测量比吸收率，单位：W/kg


测量设备的电磁波能量吸收比值。


方向类


ohos.sensor.agent.CategoryOrientationAgent


SENSOR_TYPE_6DOF


6自由度传感器


测量上下、前后、左右方向上的位移，单位：m或mm；测量俯仰、偏摆、翻滚的角度，单位：rad


检测设备的三个平移自由度以及旋转自由度，用于目标定位追踪，如：VR


SENSOR_TYPE_SCREEN_ROTATION


屏幕旋转传感器


检测设备屏幕的旋转状态


用于检测设备屏幕是否发生了旋转


SENSOR_TYPE_DEVICE_ORIENTATION


设备方向传感器


测量设备的旋转方向，单位：rad


用于检测设备旋转方向的角度值


SENSOR_TYPE_ORIENTATION


方向传感器


测量设备围绕所有三个物理轴（x、y、z）旋转的角度值，单位：rad


用于提供屏幕旋转的3个角度值


SENSOR_TYPE_ROTATION_VECTOR


旋转矢量传感器


测量设备旋转矢量，复合传感器：由加速度传感器、磁场传感器、陀螺仪传感器合成


检测设备相对于东北天坐标系的方向


SENSOR_TYPE_GAME_ROTATION_VECTOR


游戏旋转矢量传感器


测量设备游戏旋转矢量，复合传感器：由加速度传感器、陀螺仪传感器合成


应用于游戏场景


SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR


地磁旋转矢量传感器


测量设备地磁旋转矢量，复合传感器：由加速度传感器、磁场传感器合成


用于测量地磁旋转矢量


光线类


ohos.sensor.agent.CategoryLightAgent


SENSOR_TYPE_PROXIMITY


接近光传感器


测量可见物体相对于设备显示屏的接近或远离状态


通话中设备相对人的位置


SENSOR_TYPE_TOF


ToF传感器


测量光在介质中行进一段距离所需的时间


识别人像


SENSOR_TYPE_AMBIENT_LIGHT


环境光传感器


测量设备周围光线强度，单位：lux


自动调节屏幕亮度，检测屏幕上方是否有遮挡


SENSOR_TYPE_COLOR_TEMPERATURE


色温传感器


测量环境中的色温


应用于设备的影像处理


SENSOR_TYPE_COLOR_RGB


RGB颜色传感器


测量环境中的RGB颜色值


通过三原色的反射比率实现颜色检测


SENSOR_TYPE_COLOR_XYZ


XYZ颜色传感器


测量环境中的XYZ颜色值


用于辨识真色色点，还原色彩更真实


健康类


ohos.sensor.agent.CategoryBodyAgent


SENSOR_TYPE_HEART_RATE


心率传感器


测量用户的心率数值


用于提供用户的心率健康数据


SENSOR_TYPE_WEAR_DETECTION


佩戴检测传感器


检测用户是否佩戴


用于检测用户是否佩戴智能穿戴


其他类


ohos.sensor.agent.CategoryOtherAgent


SENSOR_TYPE_HALL


霍尔传感器


测量设备周围是否存在磁力吸引


设备的皮套模式


SENSOR_TYPE_GRIP_DETECTOR


手握检测传感器


检测设备是否有抓力施加


用于检查设备侧边是否被手握住


SENSOR_TYPE_MAGNET_BRACKET


磁铁支架传感器


检测设备是否被磁吸


检测设备是否位于车内或者室内


SENSOR_TYPE_PRESSURE_DETECTOR


按压检测传感器


检测设备是否有压力施加


用于检测设备的正上方是否存在按压


运作机制

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

图1 HarmonyOS传感器

af10eb2f964df4655cadaee23a507687.png

'Sensor API：提供传感器的基础API，主要包含查询传感器的列表、订阅/取消传感器的数据、执行控制命令等，简化应用开发。

Sensor Framework：主要实现传感器的订阅管理，数据通道的创建、销毁、订阅与取消订阅，实现与SensorService的通信。

Sensor Service：主要实现HD_IDL层数据接收、解析、分发，前后台的策略管控，对该设备Sensor的管理，Sensor权限管控等。

HD_IDL层：对不同的FIFO、频率进行策略选择，以及对不同设备的适配。

约束与限制

针对某些传感器，开发者需要请求相应的权限，才能获取到相应传感器的数据。

表2 传感器权限列表

image.png

传感器数据订阅和取消订阅接口成对调用，当不再需要订阅传感器数据时，开发者需要调用取消订阅接口进行资源释放。

传感器开发

场景介绍

通过方向传感器数据，可以感知用户设备当前的朝向，从而达到为用户指明方位的目的。

通过重力和陀螺仪传感器数据，能感知设备倾斜和旋转量，提高用户在游戏场景中的体验。

通过接近光传感器数据，感知距离遮挡物的距离，使设备能够自动亮灭屏，达到防误触目的。

通过气压计传感器数据，可以准确的判断设备当前所处的海拔。

通过环境光传感器数据，设备能够实现背光自动调节。

通过霍尔传感器数据，设备可以实现皮套功能等。

接口说明

HarmonyOS传感器提供的功能有：查询传感器的列表、订阅/取消订阅传感器数据、查询传感器的最小采样时间间隔、执行控制命令。


以订阅方向类别的传感器数据为例，本节示例涉及的接口如下：


表1 CategoryOrientationAgent的主要接口

image.png

表2 SensorAgent的主要接口

image.png

表3 CategoryEnvironmentData的主要接口

image.png

表4 CategoryOrientationData的主要接口

image.png

开发步骤

权限配置

如果设备上使用了传感器权限列表中的传感器，需要请求相应的权限，开发者才能获取到传感器数据。

表5 不同敏感级别的传感器举例

image.png

开发者需要在config.json里面配置权限：

  • 开发者如果需要获取加速度的数据，需要进行如下权限配置。
"reqPermissions": [
    {
        "name": "ohos.permission.ACCELEROMETER",
        "reason": "",
        "usedScene": {
            "ability": [
                ".MainAbility"
            ],
            "when": "inuse"
        }
    }
]
  • 对于需要用户授权的权限，如计步器传感器，需要进行如下权限配置。
"reqPermissions": [
    {
        "name": "ohos.permission.ACTIVITY_MOTION",
        "reason": "",
        "usedScene": {
            "ability": [
                ".MainAbility"
            ],
            "when": "inuse"
        }
    }
]

由于敏感权限需要用户授权，因此，开发者在应用启动时或者调用订阅数据接口前，需要调用权限检查和请求权限接口。

@Override
public void onStart(Intent intent) {
    super.onStart(intent);
    if (verifySelfPermission("ohos.permission.ACTIVITY_MOTION") != 0) {
        if (canRequestPermission("ohos.permission.ACTIVITY_MOTION")) {
            requestPermissionsFromUser(new String[] {"ohos.permission.ACTIVITY_MOTION"}, 1);
        }
    }
    // ...
}
@Override
public void onRequestPermissionsFromUserResult(int requestCode, String[] permissions,
        int[] grantResults) {
    // 匹配requestPermissionsFromUser的requestCode
    if (requestCode == 1) {
        if (grantResults.length > 0 && grantResults[0] == 0) {
            // 权限被授予
        } else {
            // 权限被拒绝
        }
    }
}

使用传感器

以使用方向类别的传感器为例，运动类、环境类、健康类等类别的传感器使用方法类似。

  1. 1.获取待订阅数据的传感器。
  2. 2.创建传感器回调。
  3. 3.订阅传感器数据。
  4. 4.接收并处理传感器数据。
  5. 5.取消订阅传感器数据。
private static final long INTERVAL = 100000000L;
private Button btnSubscribe;
private Button btnUnsubscribe;
private CategoryOrientationAgent categoryOrientationAgent = new CategoryOrientationAgent();
private ICategoryOrientationDataCallback orientationDataCallback;
private CategoryOrientation orientationSensor;
private int matrix_length = 9;
private int rotationVectorLength = 9;
@Override
public void onStart(Intent intent) {
    super.onStart(intent);
    super.setUIContent(ResourceTable.Layout_sensor_layout);
    findComponent(rootComponent);
    // 创建传感器回调对象。
    orientationDataCallback = new ICategoryOrientationDataCallback() {
        @Override
        public void onSensorDataModified(CategoryOrientationData categoryOrientationData) {
            // 对接收的categoryOrientationData传感器数据对象解析和使用
            int dim = categoryOrientationData.getSensorDataDim(); // 获取传感器的维度信息
            float degree = categoryOrientationData.getValues()[0]; // 获取方向类传感器的第一维数据
            float[] rotationMatrix = new float[matrix_length];
            CategoryOrientationData.getDeviceRotationMatrix(rotationMatrix, categoryOrientationData.values); // 根据旋转矢量传感器的数据获得旋转矩阵
            float[] rotationAngle = new float[rotationVectorLength];
            rotationAngle = CategoryOrientationData.getDeviceOrientation(rotationMatrix, rotationAngle); // 根据计算出来的旋转矩阵获取设备的方向
        }
        @Override
        public void onAccuracyDataModified(CategoryOrientation categoryOrientation, int index) {
            // 使用变化的精度
        }
        @Override
        public void onCommandCompleted(CategoryOrientation categoryOrientation) {
            // 传感器执行命令回调
        }
    };
    btnSubscribe.setClickedListener(v -> {
        // 获取传感器对象，并订阅传感器数据
        orientationSensor = categoryOrientationAgent.getSingleSensor(
                CategoryOrientation.SENSOR_TYPE_ORIENTATION);
        if (orientationSensor != null) {
            categoryOrientationAgent.setSensorDataCallback(
                    orientationDataCallback, orientationSensor, INTERVAL);
        }
    });
    // 取消订阅传感器数据
    btnUnsubscribe.setClickedListener(v -> {
        if (orientationSensor != null) {
            categoryOrientationAgent.releaseSensorDataCallback(
                    orientationDataCallback, orientationSensor);
        }
    });
}
private void findComponent(Component component) {
    btnSubscribe = (Button) component.findComponentById(ResourceTable.Id_btnSubscribe);
    btnUnsubscribe = (Button) component.findComponentById(ResourceTable.Id_btnUnsubscribe);
}

另外，CategoryEnvironmentData中地磁场算法相关接口的使用示例如下：

  • 构造指定地点和时间的磁场
long timeMillis = new GregorianCalendar(2020, 1, 1).getTimeInMillis();
CategoryEnvironmentData.GeomagneticField geomagneticField = new CategoryEnvironmentData.GeomagneticField(80, 0, 0, timeMillis);
  • 获取指定地点和时间的磁场数据
float geomagneticX = geomagneticField.obtainX();
float geomagneticY = geomagneticField.obtainY();
float geomagneticZ = geomagneticField.obtainZ();
float deflectionAngle = geomagneticField.obtainDeflectionAngle();
float geomagneticDip = geomagneticField.obtainGeomagneticDip();
float levelIntensity = geomagneticField.obtainLevelIntensity();
float totalIntensity = geomagneticField.obtainTotalIntensity();
文章标签：
vr&ar
知识图谱
传感器
API
算法
开发者
关键词：
HarmonyOS开发
HarmonyOS学习
HarmonyOS设备管理
HarmonyOS学习开发设备管理
爱吃土豆丝的打工人
目录
相关文章
二流小码农
|
1天前
|
API
鸿蒙开发：切换至基于rcp的网络请求
本文的内容主要是把之前基于http封装的库，修改为当前的Remote Communication Kit（远场通信服务），无非就是通信的方式变了，其他都大差不差。
二流小码农
27 3
鸿蒙开发：切换至基于rcp的网络请求
lqj_本人
|
6天前
|
UED
鸿蒙next版开发：相机开发-适配不同折叠状态的摄像头变更(ArkTS)
在HarmonyOS 5.0中，ArkTS提供了强大的相机开发能力，特别是针对折叠屏设备的摄像头适配。本文详细介绍了如何在ArkTS中检测和适配不同折叠状态下的摄像头变更，确保相机应用在不同设备状态下的稳定性和用户体验。通过代码示例展示了具体的实现步骤。
lqj_本人
29 8
lqj_本人
|
6天前
|
API 内存技术
鸿蒙next版开发：相机开发-拍照(ArkTS)
在HarmonyOS 5.0中，ArkTS提供了一套完整的API来管理相机功能，特别是拍照功能。本文详细介绍如何在ArkTS中实现拍照功能，包括导入接口、创建会话、配置会话、触发拍照及监听拍照输出流状态，并提供代码示例进行详细解读。通过本文，你将掌握如何在HarmonyOS 5.0中使用ArkTS实现高效的拍照功能。
lqj_本人
25 7
二流小码农
|
1天前
|
Android开发
鸿蒙开发：自定义一个简单的标题栏
本身就是一个很简单的标题栏组件，没有什么过多的技术含量，有一点需要注意，当使用沉浸式的时候，注意标题栏的位置，需要避让状态栏。
二流小码农
26 4
鸿蒙开发：自定义一个简单的标题栏
lqj_本人
|
6天前
|
前端开发 API
鸿蒙next版开发：相机开发-预览(ArkTS)
在HarmonyOS 5.0中，使用ArkTS进行相机预览是核心功能之一。本文详细介绍了如何使用ArkTS实现相机预览，包括导入相机接口、创建Surface、获取相机输出能力、创建会话并开始预览，以及监听预览输出状态等步骤，并提供了代码示例。通过本文，读者可以掌握在HarmonyOS 5.0中使用ArkTS进行相机预览的基本方法。
lqj_本人
23 6
lqj_本人
|
6天前
|
编解码 开发工具 计算机视觉
鸿蒙5.0版开发：命令行工具（mediatool工具）
在HarmonyOS 5.0的开发中，命令行工具mediatool基于FFmpeg库，提供了丰富的媒体处理功能，如视频和音频的转码、封装格式转换、提取媒体信息等。本文详细介绍mediatool的功能和使用方法，并提供代码示例。
lqj_本人
25 6
lqj_本人
|
6天前
|
前端开发 开发者
鸿蒙next版开发：相机开发-元数据(ArkTS)
在HarmonyOS 5.0中，ArkTS新增了对相机元数据的访问能力，帮助开发者获取图像的详细信息。本文介绍了如何在ArkTS中获取和使用相机元数据，包括导入接口、创建元数据输出流、开启和停止元数据输出、监听元数据对象可用事件等步骤，并提供了详细的代码示例。
lqj_本人
23 5
lqj_本人
|
6天前
|
前端开发 API 开发者
鸿蒙next版开发：相机开发-录像(ArkTS)
在HarmonyOS 5.0中，ArkTS提供了一套完整的API来管理相机录像功能。本文详细介绍了如何在ArkTS中实现录像功能，包括导入接口、创建Surface、获取相机输出能力、创建会话并开始录像以及监听录像输出流状态，并提供了代码示例进行解读。希望本文能帮助开发者更好地利用ArkTS的相机录像功能。
lqj_本人
21 5
lqj_本人
|
6天前
|
API 开发者 内存技术
鸿蒙next版开发：相机开发-会话管理(ArkTS)
在HarmonyOS 5.0中，ArkTS提供了完整的API来管理相机会话，包括创建相机输入流、预览输出流、拍照输出流，配置和管理会话。本文详细介绍了相机会话管理的基础步骤和代码示例，涵盖会话创建、闪光灯和焦距配置及错误处理等内容，帮助开发者更好地利用ArkTS开发相机应用。
lqj_本人
21 4
lqj_本人
|
6天前
|
UED
鸿蒙next版开发：音频并发策略扩展(ArkTS)
在HarmonyOS 5.0中，音频并发策略通过ArkTS的AudioSessionManager接口管理多个音频流的交互和优先级。本文介绍了如何自定义音频焦点策略，包括激活、停用音频会话及注册回调函数，并提供了示例代码。适用于多媒体、通信和游戏应用。
lqj_本人
25 4

热门文章

最新文章

  • 1
    嵌入式linux/鸿蒙开发板(IMX6ULL）开发（一） 嵌入式Linux开发基本概念以及开发流程介绍
  • 2
    鸿蒙应用开发项目新建过程与hap包生成方法
  • 3
    【鸿蒙软件开发】ArkUI容器组件之Grid(网格布局)
  • 4
    嵌入式linux/鸿蒙开发板(IMX6ULL）开发（四）传输文件
  • 5
    【鸿蒙软件开发】文本显示（Text/Span）
  • 6
    【鸿蒙软件开发】UIAbility组件概况、生命周期与启动模式
  • 7
    嵌入式linux/鸿蒙开发板(IMX6ULL）开发流程（六）烧写整个系统或更新部分系统
  • 8
    鸿蒙OS Next与安卓系统的比较
  • 9
    scrcpy投屏工具的在harmonyOS开发上的使用
  • 10
    【HarmonyOS 4.0 应用开发实战】ArkTS 快速入门
  • 1
    鸿蒙应用实践：利用扣子API开发起床文案生成器
    108
  • 2
    「架构」嵌入式鸿蒙架构
    162
  • 3
    鸿蒙使用 @Builder扩展出来的布局数据更新没法更新UI
    145
  • 4
    鸿蒙base64编码字符集转化成图片文件
    130
  • 5
    鸿蒙打电话功能
    121
  • 6
    鸿蒙应用更新跳转到应用市场
    96
  • 7
    鸿蒙实现获取应用缓存和清理缓存
    312
  • 8
    鸿蒙使用 @Builder扩展出来的布局数据更新没法更新UI
    185
  • 9
    HarmonyOS-UIAbitity-TextArea——【坚果派-红目香薰】
    40
  • 10
    HarmonyOS-UIAbitity-Text——【坚果派-红目香薰】
    23

    • 相关课程

    更多
  • 嵌入式之RFID开发与应用2020版
  • AliOS Things物联网开发教程
  • HaaS物联网云端一体低代码开发课程
  • 基于STM32的端到端物联网全栈开发
  • IoT小程序框架课程
  • HaaS智能硬件开发训练营

    • 相关电子书

    更多
  • 无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案
  • HaaS物联网设备云端一体开发框架：AliOS Things
  • 移动App性能监测实践（ios篇）

    • 相关实验场景

    更多
  • 基于函数计算一键部署掌上游戏机
  • 使用操作系统智能助手OS Copilot解锁操作系统运维与编程
  • 使用物联网平台远程管理运维设备
  • 2分钟自动化部署人生模拟器
  • 阿里云IoT小程序应用开发和组件实践
  • 搭建IoT小程序开发环境，创建一个应用
    • 下一篇
    阿里云OSS设置跨域访问