8、距离传感器数据解读：values[0]的含义（厘米级距离）、PROXIMITY_FAR与PROXIMITY_CLOSE常量、不同厂商的差异。
好，我们直接切入正题。上一章我们聊了怎么注册监听器，拿到了SensorEvent。那这个事件里到底装了什么？说白了，就是那个values[]数组。对于距离传感器，这个数组通常只有一个元素有用——values[0]。但别小看这一个数，里面门道可不少。
values[0]：它到底代表什么？
官方文档说，values[0]代表物体到传感器的距离，单位是厘米。嗯，听起来很简单对吧？但我第一次做项目时就被它坑过。
我记得当时测试一款手机，手靠近屏幕，距离显示0cm；手拿开，显示5cm。一切正常。但换了一台手机，同样的代码，靠近时显示1cm，拿开显示10cm。我当时就懵了——这5cm和10cm的差距是哪来的？
后来我才明白，values[0]的值其实是一个“原始读数”，它并不总是真实的物理距离。不同厂商对传感器的校准方式不同，导致这个值的范围和含义有差异。
核心要点：
- 理论值： 0.0cm ~ 传感器最大量程（通常5-10cm）
- 实际值： 靠近时通常为0.0cm或1.0cm，远离时为一个固定最大值
- 注意： 这个值不一定是连续的！很多传感器只有两个状态：近和远。
PROXIMITY_FAR 与 PROXIMITY_CLOSE：系统帮你做了判断
Android系统也意识到这个问题了。所以它提供了两个常量：
SensorManager.PROXIMITY_FAR：值为0.0，表示物体远离SensorManager.PROXIMITY_CLOSE：值为1.0，表示物体靠近
等等，这跟values[0]有什么关系？
我个人的习惯是：永远不要直接拿values[0]做判断。因为不同手机返回的值可能完全不同。比如：
| 手机型号 | 靠近时 values[0] | 远离时 values[0] | 阈值 |
|---|---|---|---|
| Google Pixel | 0.0 | 5.0 | 1.0 |
| Samsung Galaxy | 1.0 | 10.0 | 5.0 |
| Xiaomi Mi | 0.0 | 8.0 | 2.0 |
你看，同样是“靠近”，有的返回0.0，有的返回1.0。如果你写死if (values[0] == 0.0)，那在Samsung上就永远触发不了靠近事件。
那怎么办？用系统提供的常量啊！
// 推荐做法：使用系统常量判断
if (event.values[0] <= sensor.getMaximumRange() / 2) {
// 靠近
isNear = true;
} else {
// 远离
isNear = false;
}
// 或者更简单：直接比较阈值
float threshold = sensor.getMaximumRange() / 2;
if (event.values[0] < threshold) {
// 靠近
} else {
// 远离
}
我的经验： 我一般会取sensor.getMaximumRange()的一半作为阈值。这样不管手机返回0~5还是1~10，都能正确判断。当然，你也可以用PROXIMITY_FAR和PROXIMITY_CLOSE，但要注意——这两个常量是float类型，直接比较时小心精度问题。
不同厂商的差异：这才是真正的坑
嗯，这里我要重点说说。不同厂商的距离传感器，差异比你想象的大得多。
1. 传感器类型不同
- 红外LED + 光电二极管： 最常见，成本低，但容易受环境光干扰
- 激光测距： 精度高，但贵，一般旗舰机才有
- 超声波： 少见，但不怕油污
2. 校准方式不同
有些厂商会在出厂时做校准，保证0cm就是0cm。有些则偷懒，直接给个固定偏移。我曾经遇到过一台手机，靠近时显示0.5cm，远离时显示5.5cm——永远多了0.5cm。
3. 采样率不同
有的手机每秒采样100次，有的只有10次。这会影响你判断的实时性。我建议用SensorManager.SENSOR_DELAY_UI，别用FASTEST，不然电池扛不住。
避坑指南： 我曾经在某个项目里，直接拿values[0] == 0.0判断靠近。结果在华为手机上死活不触发。查了半天才发现，华为的距离传感器在靠近时返回的是1.0，而不是0.0。从那以后，我再也不敢写死阈值了。
知识体系图：距离传感器数据解读
实战建议：如何写出兼容性好的代码
说了这么多，来点实际的。这是我个人总结的“三要三不要”：
要做的：
- 要动态获取最大量程：
sensor.getMaximumRange() - 要使用阈值判断： 取最大量程的一半作为分界线
- 要处理异常值： 比如突然跳变、负值等
不要做的：
- 不要写死阈值： 比如
if (value < 1.0) - 不要依赖连续值： 很多传感器只有两个状态
- 不要忽略传感器类型： 先检查
sensor.getType()
// 一个兼容性更好的距离传感器监听示例
SensorManager sensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
Sensor proximitySensor = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY);
if (proximitySensor != null) {
float maxRange = proximitySensor.getMaximumRange();
float threshold = maxRange / 2.0f;
SensorEventListener listener = new SensorEventListener() {
@Override
public void onSensorChanged(SensorEvent event) {
float distance = event.values[0];
boolean isNear = distance < threshold;
// 处理靠近/远离事件
if (isNear) {
// 屏幕熄灭或防误触
} else {
// 屏幕点亮
}
}
@Override
public void onAccuracyChanged(Sensor sensor, int accuracy) {
// 精度变化时处理
}
};
sensorManager.registerListener(listener, proximitySensor, SensorManager.SENSOR_DELAY_UI);
}
一个小技巧： 如果你发现某些手机在通话时距离传感器不工作，先检查一下是不是权限问题。有些厂商把距离传感器和光线传感器绑在一起，需要同时申请权限。我曾经因为这个排查了整整两天...
好了，关于values[0]的含义、系统常量、厂商差异，就聊到这里。记住一句话：别信文档，信实测。每个手机都有自己的脾气，多测几台，你就能摸清规律。
公众号:蓝海资料掘金营，微信deep3321