7、SensorEventListener接口：onSensorChanged() 回调、SensorEvent 数据结构、values[] 数组含义
好，咱们继续往下走。上一节我们把传感器注册的流程捋了一遍，今天要聊的是真正“干活”的部分——SensorEventListener 接口。说白了，这个接口就是系统通知你“传感器有数据了”的通道。
我个人习惯把传感器开发比作“监听心跳”。你注册好监听器，系统每跳一下（数据变化），就会回调你一次。而你要做的，就是在回调里把数据接住、解析、用起来。
7.1 onSensorChanged() 回调——数据来了！
这个方法是整个传感器编程的核心入口。系统一旦检测到传感器数据变化，就会调用它。原型长这样：
@Override
public void onSensorChanged(SensorEvent event) {
// 你的处理逻辑写在这里
}
嗯，这里要注意：这个回调是在主线程执行的。我早期做项目时踩过坑——在回调里做耗时操作，结果界面卡得不行。后来学乖了，数据解析完就扔到子线程去处理。
reporting-mode。光线传感器通常是“变化即触发”，但如果你注册时设置了采样延迟（比如 SENSOR_DELAY_UI），系统可能会合并或丢弃部分事件。别指望每次物理变化都能收到回调。
7.2 SensorEvent 数据结构——数据包长什么样？
每次回调都会给你一个 SensorEvent 对象。它不是一个简单的数值，而是一个结构体。我把它拆开给你看：
| 字段 | 类型 | 说明 |
|---|---|---|
sensor |
Sensor | 触发事件的传感器对象，可以用来判断是哪个传感器 |
accuracy |
int | 精度等级：0=不可靠，1=低，2=中，3=高 |
timestamp |
long | 事件发生时的纳秒时间戳（注意是纳秒！） |
values |
float[] | 传感器数据数组，长度和含义因传感器而异 |
你看，values 只是其中一个字段。但实际开发中，我们最常打交道的也就是它。其他字段呢？accuracy 我建议你每次都要检查一下——我曾经遇到过设备在弱光环境下精度突然掉到0，如果不做判断，拿到的数据就是废的。
(event2.timestamp - event1.timestamp) / 1000000f 转成毫秒。我刚开始直接相减，结果算出来的数值大得离谱，排查了半天才发现单位不对。
7.3 values[] 数组含义——光线传感器到底返回什么？
对于光线传感器（TYPE_LIGHT），values[] 数组只有一个元素：values[0]，单位是勒克斯（lux）。
说白了，就是环境光的照度值。数值越大，环境越亮。比如：
- 0~10 lux：昏暗的室内或夜晚
- 100~500 lux：正常室内照明
- 1000+ lux：户外阴天或室内靠窗
- 10000+ lux：大晴天直射
但这里有个坑：不同设备的传感器量程和精度差异很大。我测试过一台老平板，最大只能读到 4000 lux，而另一台旗舰机可以读到 100000+ lux。所以，别硬编码阈值，最好做归一化或动态适配。
@Override
public void onSensorChanged(SensorEvent event) {
if (event.sensor.getType() == Sensor.TYPE_LIGHT) {
float lux = event.values[0];
// 检查精度
if (event.accuracy == SensorManager.SENSOR_STATUS_UNRELIABLE) {
// 数据不可靠，建议忽略或使用上次值
return;
}
// 更新UI或做自动亮度调节
updateBrightness(lux);
}
}
7.4 知识体系总览
下面这张图帮你理清整个 SensorEventListener 的工作流程：
从硬件到回调，中间经过了内核和 SensorManager 两层。你作为应用开发者，只需要关注最后一环——onSensorChanged() 里拿到的 SensorEvent 对象。
7.5 避坑指南
最后，分享几个我踩过的坑：
- 不要阻塞回调线程：onSensorChanged 跑在主线程，做耗时操作会卡UI。我曾经在里面写了个日志写入文件的操作，结果界面掉帧严重。
- 检查 accuracy：光线传感器在快速变化时（比如从暗处走到亮处），精度可能短暂下降。忽略不可靠数据，用上次有效值代替。
- values 数组长度：虽然光线传感器只有 values[0]，但别写死
event.values.length == 1的判断。有些设备可能返回更多元素（虽然多余），用event.values[0]取第一个就行。 - 注销监听器：Activity 或 Fragment 销毁时，记得在 onPause 或 onDestroy 里注销。否则传感器会一直开着，耗电不说，还可能导致内存泄漏。
好了，这一节的内容就到这。SensorEventListener 接口其实不复杂，但细节很多。你只要记住：onSensorChanged 是入口，SensorEvent 是数据包，values[0] 是你要的光线值。把这三点吃透，后面写自动亮度调节、环境光检测就顺了。