摘要
很多开发者在做鸿蒙应用时，想用陀螺仪、加速度计、光照传感器等数据做点酷东西，结果发现：怎么也获取不到传感器数据。明明 API 都写了，控制台还报错。其实问题往往不在代码，而在权限、系统支持和 API 调用方式。这篇文章就带你从头到尾梳理一遍——怎么在鸿蒙里正确拿到传感器数据。
引言
随着设备硬件越来越丰富，鸿蒙系统开放的传感器种类也逐步增加，比如加速度、陀螺仪、方向、光照、磁场等。这些数据在智能运动、健康监测、手势识别等场景中都很常见。
但鸿蒙对于传感器使用有一定限制，不同设备支持的传感器种类也不一样。如果你没配置权限、没检查设备支持情况，直接调用 API 就可能会失败。下面我们一步一步拆解。
鸿蒙中传感器无法访问的常见原因
权限没有配置
鸿蒙中访问传感器是需要权限的，而且必须写在 config.json5 里，否则调用就会失败，哪怕你的代码完全正确。
权限配置示例：
{
"module": {
"reqPermissions": [
{
"name": "ohos.permission.READ_SENSOR"
}
]
}
}**提示：**这个配置要放在项目的 config.json 或 config.json5 文件的 module 下，而不是 app 下。
API 调用方式不正确
很多开发者直接在生命周期中调用传感器监听，但没有订阅成功、也没有检查设备是否支持。
正确的订阅方式如下：
import sensor from '@system.sensor';
sensor.subscribe({
type: 'accelerometer',
success: (data) => {
console.log('Accelerometer data:', data);
},
fail: (error) => {
console.error('Failed to get sensor data', error);
}
});type 可以是 accelerometer、gyroscope、magnetic、light 等。
**注意：**订阅之前最好先检查设备是否支持该类型传感器，否则很可能执行失败。
Demo 示例：一个可以运行的传感器页面
示例结构：在页面初始化后监听加速度传感器
// xxx.ets 文件
import sensor from '@system.sensor';
@Entry
@Component
struct SensorPage {
build() {
Column() {
Text('监听中，请查看控制台输出')
.fontSize(18)
.padding(20)
}
// 启动时监听传感器
sensor.subscribe({
type: 'accelerometer',
success: (data) => {
console.log('加速度数据:', data);
},
fail: (err) => {
console.error('订阅失败:', err);
}
})
}
}在预览器或真机运行这个页面，如果一切正常，你会在控制台看到不断刷新的加速度数据。
实际应用场景示例
运动计步（基于加速度）
sensor.subscribe({
type: 'accelerometer',
success: (data) => {
// 判断步数变动逻辑（可基于Z轴振幅）
if (data.z > 9.8 || data.z < -9.8) {
console.log('走了一步');
}
}
});可以作为健身类应用的基础组件，进行步数估算。
横屏/竖屏方向识别（基于方向传感器）
sensor.subscribe({
type: 'orientation',
success: (data) => {
if (data.roll > 45 || data.roll < -45) {
console.log('当前为横屏');
} else {
console.log('当前为竖屏');
}
}
});可以用在游戏、视频类应用中自动判断横竖屏状态。
手势识别（简单基于陀螺仪变化）
sensor.subscribe({
type: 'gyroscope',
success: (data) => {
if (Math.abs(data.y) > 1.5) {
console.log('检测到甩动手势');
}
}
});可以作为手势触发器，比如“甩一下”切换歌曲。
QA 环节
Q1：为什么代码写了也没有任何数据输出？
A：检查以下几点：
- 有没有配置
READ_SENSOR权限？ - 是否运行在真机？模拟器可能不支持传感器。
- 设备是否真的内置这个传感器（低端设备可能缺失）？
Q2：能否同时监听多个传感器？
A：可以。你可以分别调用多次 sensor.subscribe({ type: ... }) 进行多类型监听。但注意取消订阅时要单独处理每个类型。
Q3：如何取消传感器监听？
A：使用 sensor.unsubscribe({ type: 'accelerometer' }) 即可关闭监听，记得在页面销毁或跳转时调用，防止内存泄漏。
总结
鸿蒙系统对传感器的使用其实很灵活，但也比较严格。只要你配置好权限、正确调用 API、并且运行在支持的设备上，获取传感器数据并不难。简单回顾一下：
- 传感器需要配置权限才能用
- 运行在真机环境才能获取真实数据
- API 调用要正确，注意订阅/取消订阅机制
- 不同传感器适合不同场景，结合业务使用效果更佳
希望这篇文章能帮你顺利解决“拿不到传感器数据”的问题。如果你有别的实战需求或使用场景，也欢迎继续交流！
如果你需要我再封装一个完整的 ArkTS 页面或组件用于传感器监听测试，也可以告诉我，我可以帮你写好直接运行的代码模板。