20、传感器校准：距离传感器为何需要校准？校准API（SensorManager.calibrate）、校准流程。
距离传感器这东西，看着简单，其实挺“娇气”的。
你可能遇到过这种情况：手机明明没贴脸，屏幕却黑了；或者通话时脸都贴上去了，屏幕还亮着，脸颊直接帮你挂断了电话。嗯，这多半是传感器没校准。
我个人习惯，拿到一台新手机或者刷完系统后，第一件事就是检查距离传感器的表现。为什么？因为不校准的传感器，就像一把没调过准星的枪，打不准是常态。
20.1 为什么需要校准？
说白了，距离传感器的工作原理是发射红外光，然后接收反射回来的光。但每个手机的组装公差、屏幕玻璃的透光率、甚至保护膜的厚度都不一样。
我在项目中遇到过最典型的案例：用户贴了一张很厚的钢化膜，结果传感器一直报“有物体靠近”。因为膜把发射的光直接反射回来了，传感器以为有东西挡着。
校准的目的，就是让传感器知道：
- “无遮挡”状态下，应该读到什么值（通常是最大值）
- “完全遮挡”状态下，应该读到什么值（通常是最小值）
校准后，系统才能准确判断“远”和“近”的阈值。
核心观点：校准不是让传感器变得更精确，而是让传感器适应当前的物理环境。说白了，就是给传感器做一次“环境适配”。
20.2 校准API：SensorManager.calibrate
Android 从某个版本开始，提供了官方的校准接口。不过要注意，这个API不是所有厂商都支持的。我见过一些定制ROM，直接把这个接口给阉割了。
先看代码怎么用：
// 获取SensorManager实例
SensorManager sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
// 获取距离传感器
Sensor proximitySensor = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY);
if (proximitySensor != null) {
// 调用校准接口
boolean result = sensorManager.calibrate(proximitySensor, SensorManager.CALIBRATION_TRIGGER_MANUAL);
if (result) {
Log.d("Calibration", "校准触发成功，请按照提示操作");
} else {
Log.w("Calibration", "校准失败，可能传感器不支持或权限不足");
}
}这里有个坑，我必须要说：calibrate() 方法返回 true 不代表校准完成了，它只代表“校准请求已提交”。真正的校准过程是异步的，你需要注册 SensorEventListener 来监听校准状态的变化。
警告：不要在主线程中调用 calibrate() 并等待结果。我曾经见过一个同事这么干，结果UI线程被卡死，ANR弹出来了。校准过程可能涉及硬件操作，耗时不确定。
20.3 校准流程
校准流程其实不复杂，但步骤顺序很重要。我总结了一个标准流程，你照着做基本不会出问题。
- 检查传感器是否支持校准：调用
sensorManager.getSensorList(Sensor.TYPE_PROXIMITY)，看看返回的传感器列表里有没有isCalibrationSupported()为 true 的。 - 清除遮挡物：确保传感器前方没有任何物体，包括保护膜、灰尘、手指。嗯，这一步很多人会忽略。
- 触发校准：调用
calibrate()方法，传入CALIBRATION_TRIGGER_MANUAL或CALIBRATION_TRIGGER_AUTO。 - 等待校准完成：注册监听器，等待
onSensorChanged()回调中收到校准完成事件。 - 验证校准结果：用手遮挡传感器，观察读数是否在合理范围内。通常“无遮挡”时读数接近最大值（比如10cm），“完全遮挡”时读数为0。
你想想看，如果跳过第2步直接校准，传感器会把“有遮挡”的状态当成基准，那校准完就全乱套了。
小技巧：我习惯在校准前先读取一次当前的传感器值，记录下来。如果校准后值没有明显变化，说明校准可能没生效。这时候可以尝试重启传感器再校准一次。
20.4 校准状态与回调
校准过程中，传感器会通过 SensorEvent 返回状态信息。你需要解析 values 数组中的特定索引值。
| values索引 | 含义 | 典型值 |
|---|---|---|
| values[0] | 距离值（cm） | 0.0 ~ 10.0 |
| values[1] | 校准状态 | 0=未校准, 1=校准中, 2=校准完成 |
| values[2] | 校准精度 | 0=低, 1=中, 2=高 |
我曾经踩过一个坑：有些厂商的传感器，values[1] 和 values[2] 根本不存在，只返回 values[0]。所以你在解析时一定要做数组长度检查，否则直接 ArrayIndexOutOfBoundsException 就崩了。
20.5 校准的避坑指南
做校准功能时，有几个地方特别容易出问题。我一个个说：
- 权限问题：部分Android版本要求
CALIBRATE_SENSORS权限，记得在AndroidManifest.xml中声明。 - 多传感器冲突：如果同时有多个传感器在监听，校准过程中可能会收到干扰数据。我建议在校准前暂停其他传感器的监听。
- 校准超时：有些硬件校准需要几秒钟，如果长时间没收到回调，应该设置一个超时机制，提示用户重试。
- 保护膜影响：用户贴了厚膜时，校准结果可能不准确。我一般会在校准前弹个提示：“请确保传感器前方无遮挡物”。
个人经验：有一次我调试一个项目，校准死活不成功。折腾了半天，最后发现是传感器表面有一层出厂保护膜没撕掉。嗯，这种低级错误，说出来都是泪。
20.6 知识体系图
下面这张图，把校准的核心逻辑串起来了。你一看就明白。
这张图把校准的“为什么”、“用什么”、“怎么做”都串起来了。你照着这个思路去实现，基本不会跑偏。
20.7 最后说两句
校准这件事，看起来是个小功能，但做不好真的很影响用户体验。我见过不少手机，就是因为距离传感器没校准好，导致通话时屏幕乱跳，用户直接给差评。
所以，别小看这几行代码。校准做好了，用户可能感觉不到；但做不好，用户一定骂娘。
嗯，今天就聊到这儿。记住：校准不是万能的，但不校准是万万不能的。