Android平板无法获取焦距/传感器尺寸致MediaPipe崩溃问题排查

问题概述 #

在Android 11系统的平板上使用Google MediaPipe库时，程序崩溃并抛出NullPointerException，报错栈指向com.google.mediapipe.components.CameraXPreviewHelper类的calculateFocalLengthInPixels方法。

通过单独制作的APK检查相机特性，发现LENS_INFO_AVAILABLE_FOCAL_LENGTHS和SENSOR_INFO_PHYSICAL_SIZE字段为空，但根据Android官方文档，这两个属性在Android 11中应始终存在。目前不考虑硬编码相机特性的方案，寻求根本原因与最优解决办法。

报错栈信息 #

Process: com.example.jarvis, PID: 9853
java.lang.NullPointerException: Attempt to read from null array
    at com.google.mediapipe.components.CameraXPreviewHelper.calculateFocalLengthInPixels(CameraXPreviewHelper.java:485)
    at com.google.mediapipe.components.CameraXPreviewHelper.updateCameraCharacteristics(CameraXPreviewHelper.java:472)
    at 

相机特性检查代码片段 #

if (!characteristicsStateValue.characteristicsExists) {
    Text(text = "Can't obtain the camera characteristics!")
}
if (!characteristicsStateValue.focalLengthCharacteristicsExists) {
    Text(text = "Obtained characteristics doesn't contain the focal length")
}
if (!characteristicsStateValue.sensorWidthCharacteristicsExists) {
    Text(text = "Obtained characteristics doesn't contain the sensor width")
}

可能原因 #

• 平板厂商的Camera HAL实现存在缺陷：部分定制ROM未严格遵循Android 11的规范，没有正确返回必填的相机特性字段，导致读取时为空。
• CameraX与MediaPipe版本不兼容：二者版本匹配度不足，导致获取相机特性的API调用出现异常，无法正确读取字段值。
• 相机权限获取时机不当：在相机权限未完全就绪的情况下读取特性，导致读取失败返回空值。
• 相机选择逻辑问题：误读取了不支持标准特性的特殊定制副摄像头，但该概率较低，因为Android 11要求所有相机必须提供这些字段。

解决方案建议 #

• 版本兼容性检查：对照MediaPipe官方文档，确认当前使用的CameraX版本为MediaPipe推荐的兼容版本，避免因版本差异导致的API调用问题。
• 重新获取相机特性：在读取特性前，尝试重新初始化CameraCharacteristics对象或重启相机实例，避免因初始化不全或缓存问题导致的空值。
• 反馈厂商ROM问题：收集设备型号、ROM版本等信息，向平板厂商提交bug报告，要求修复Camera HAL的特性返回问题。
• 兼容式估算方案：若需临时解决，可通过CameraX预览尺寸、屏幕分辨率等参数估算焦距，或尝试使用MediaPipe内置的 fallback 机制（若存在），替代硬编码方案。
• 权限流程校验：确保在获取相机特性前，已成功申请并获取CAMERA权限，且在权限回调完成后再执行特性读取操作。

内容的提问来源于stack exchange，提问作者ObjectNameDisplay