7、SensorEventListener接口：onSensorChanged与onAccuracyChanged回调方法详解、SensorEvent数据结构

距离传感器开发中，最核心的就是这个 SensorEventListener 接口。说白了，它就是系统和你的App之间的“传话筒”。系统检测到传感器数据变了，或者精度变了，就通过这个接口通知你。

我个人习惯，写传感器相关的代码时，第一件事就是把这个接口的架子搭好。今天我们就把它掰开揉碎了讲清楚。

7.1 接口总览：两个回调方法

SensorEventListener 接口只有两个方法需要实现：

• onSensorChanged(SensorEvent event) —— 传感器数值变化时触发
• onAccuracyChanged(Sensor sensor, int accuracy) —— 传感器精度变化时触发

嗯，这里要注意：两个方法都必须实现，缺一不可。哪怕你精度回调里什么都不写，也得有个空实现。

7.2 onSensorChanged 回调详解

这个方法接收一个 SensorEvent 对象。每次传感器数据刷新，系统就会把这个对象扔给你。刷新的频率取决于你注册监听器时设置的采样率。

我曾经在项目里遇到过一个问题：注册时用了 SENSOR_DELAY_FASTEST，结果回调频率高得吓人，UI线程直接卡死。后来我学乖了，非必要不用最快模式。

7.2.1 回调触发的时机

• 传感器检测到新的物理数据（比如物体靠近/远离）
• 系统按照采样率定时推送数据（即使数值没变）
• 重新注册监听器后，第一次回调

7.2.2 典型代码结构

SensorEventListener listener = new SensorEventListener() {
    @Override
    public void onSensorChanged(SensorEvent event) {
        // 先判断传感器类型，防止混淆
        if (event.sensor.getType() != Sensor.TYPE_PROXIMITY) {
            return;
        }

        // 距离值存储在 values[0] 中
        float distance = event.values[0];
        
        // 处理业务逻辑
        if (distance < 5.0f) {
            // 物体靠近，熄屏
            turnOffScreen();
        } else {
            // 物体远离，亮屏
            turnOnScreen();
        }
    }

    @Override
    public void onAccuracyChanged(Sensor sensor, int accuracy) {
        // 精度处理（后面细讲）
    }
};

7.3 onAccuracyChanged 回调详解

这个回调很多人会忽略，甚至直接写空实现。但我建议你重视它。为什么？因为精度变化往往意味着传感器工作异常，或者环境干扰严重。

精度参数 accuracy 有四个取值：

常量	值	含义
SensorManager.SENSOR_STATUS_UNRELIABLE	0	数据不可靠，建议丢弃
SensorManager.SENSOR_STATUS_ACCURACY_LOW	1	精度低，但勉强可用
SensorManager.SENSOR_STATUS_MEDIUM	2	中等精度，常规使用
SensorManager.SENSOR_STATUS_HIGH	3	高精度，最佳状态

你想想看，如果精度突然降到 UNRELIABLE，你还拿这个数据去控制屏幕开关，那不就乱套了吗？

7.4 SensorEvent 数据结构

SensorEvent 是系统传递数据的载体。它包含以下关键字段：

• sensor：触发事件的 Sensor 对象，可以用来获取传感器类型、名称、厂商等信息
• values：float[] 数组，存储传感器数据。距离传感器只用 values[0]
• accuracy：本次数据的精度等级，取值同上表
• timestamp：事件发生的时间戳，单位是纳秒

这里有个细节：values 数组的长度取决于传感器类型。距离传感器固定长度为1，但像加速度传感器就有3个值（x、y、z轴）。所以写代码时不要硬编码数组长度，最好用 event.values.length 来判断。

7.4.1 距离传感器的 values 解读

对于 TYPE_PROXIMITY：

• values[0] 表示物体到传感器的距离，单位是厘米
• 最大值通常为传感器能检测到的最大距离（常见5cm、8cm、10cm）
• 最小值通常为0，表示物体紧贴传感器

说白了，你只需要判断 values[0] 是否小于某个阈值，就能知道物体是“靠近”还是“远离”。

7.5 知识体系结构图

下面这张图帮你理清 SensorEventListener 的整体脉络：

7.6 实际开发中的注意事项

最后，我总结几个实际开发中容易踩的坑：

1. 不要在主线程做耗时操作 —— onSensorChanged 回调频率可能很高，阻塞会导致丢帧甚至ANR
2. 记得在 onPause 或 onStop 中取消注册 —— 否则传感器会持续耗电，而且回调会泄漏Activity引用
3. 处理 values[0] 时注意边界值 —— 有些手机返回的最大值不是标准值，建议用 event.sensor.getMaximumRange() 动态获取
4. onAccuracyChanged 不要只写空实现 —— 哪怕只是打个日志，也能帮你排查线上问题

好了，SensorEventListener 接口的核心内容就这些。说白了就是两个回调加一个数据结构，但用好了，就能让你的距离传感器应用既稳定又省电。

---