第26章 HarmonyOs开发图解之 设备管理

学习目标

主要图解

内容讲解

设备管理概述

HarmonyOS 的设备管理模块涵盖四大方向：传感器、控制类小器件、位置服务和程序设置。这些能力让应用能够感知物理世界、控制设备硬件和获取使用者位置。

生活化类比：传感器就像"手机的五官"

加速度计是"前庭"。陀螺仪是"内耳"，环境光传感器是"眼睛对光的感知"，温度计是"皮肤对温度的感知"。不过，而位置服务就像"GPS 导航仪"——通过卫星、基站信号和 WLAN 信号三种方式来确定你在哪。说起来，采样率就像“眨眼频率”——采样率越高越灵敏，但也越费电。

痛点： 很多新手在第一次尝试订阅传感器时发现回调从未触发，原因往往是未正确配置采样率或未调用SENSOR_DELAY_NORMAL/FASTEST/etc.。或者忘记在MainAbility.onStart里注册，而是在MainAbility.onCreate)中注册导致生命周期错配。

痛点： 一样。定位功能经常出现“错误码1001”或一直返回空位置信息，这通常不是代码问题，而是程序位置开关被关闭或权限被拒绝。

痛点： 因为某些厂商自定义了硬件驱动。对某些低功耗模式下会自动关闭加速度计，导致数据间断，这需要在业务层做重连策略。话说回来，

痛点： 许多开发者不知道必须在MainAbility.onStop/MainAbility.onDestroy中调用sensors.releaseSensorDataCallback。否则应用即使切换到后台也会持续耗电。

传感器使用

// 订阅方向传感器数据
SensorAgent sensorAgent = SensorAgent.getSensorAgent;boolean success = sensorAgent.setSensorDataCallback(
new SensorDataCallback {
@Override
public void onSensorDataCallback {
float values = event.values;HiLog.info，}
},SensorAgent.SENSOR_TYPE_ACCELEROMETER。SensorAgent.SENSOR_DELAY_NORMAL // 采样率
);// 取消订阅
sensorAgent.releaseSensorDataCallback(
callback,SensorAgent.SENSOR_TYPE_ACCELEROMETER);

控制类小器件

• LED 指示灯控制

  
  // LED 指示灯控制
  LightAgent lightAgent = new LightAgent;int lightIds = lightAgent.getLightIdList;if {
  lightAgents.turnOn
  .setLightColor // 红色
  .setBlinkMode
  .setBlinkOnTime
  .setBlinkOffTime
  .build);}
  

// 振动器控制
VibratorAgent vibrator = new VibratorAg ent;vibrator.vibrate;// 振动200毫秒

注上述代码片段均已按标准HTML格式化，为确保兼容性请将其拷贝至项目对应文件夹后编译运行。按理说，

位置服务

// 单次定位
Locator locator = new Locator;
locator.requestOnce,new MyLocationCallback);

// 持续定位 locator.startLocating,new MyLocationCallback);

// 获取缓存位置 Location cachedLocation = locator.getCachedLocation;

class MyLocationCallback implements LocationCallback { @Override public void onLocationReport { HiLog.info+",经度:"+location.getLongitude);} @Override public void onErrorReport { HiLog.error;} }

Pain Point: 很多人认为只要申请了LOCATION_PERMISSION就能正常定位，却忽略了程序位置开关必须开启才能接收定位信息。 解决办法：  

代码速查卡

...

提示 * 上面只是一个简化示例，实际项目中请及异常码。* 如果你想更直观了解每个 API 的用法，可以去官方 GitHub 示例仓库搜索对应类名。* 请确保你的项目已经添加相应依赖，如 ohos.hardware.sensor 与 ohos.hardware.locator。

Truncated furr for brevity – see above quick reference snippets. This part of table includes all key APIs such as: • setSensorDataCallback • releaseSensorDataCallback • getLightIdList • turnOn • turnOff • vibrate • startLocating • requestOnce • getCachedLocation

---

⚠️ 常见痛点与方法⚠️

🚀 进阶方向 🚀