CameraX图像分析应用在搭载LineageOS的树莓派3B上不执行analyze方法

问题根因 #

该问题由树莓派3B搭载的LineageOS系统的相机HAL层与CameraX框架的适配兼容性导致：常规安卓手机的相机HAL完整支持CameraX纯分析流的工作模式，但树莓派的移植版ROM的相机HAL存在适配缺失，且对输出流格式、绑定规则的要求更严格。

可行解决方案 #

• 开启CameraX兼容降级模式
  在自定义Application类中实现CameraXConfig.Provider接口，强制启用Camera2兼容层与设备降级适配，避免CameraX对非常规设备做硬件加速优化导致的流输出异常：

  public class MyApp extends Application implements CameraXConfig.Provider {
      @NonNull
      @Override
      public CameraXConfig getCameraXConfig() {
          return CameraXConfig.Builder.fromConfig(Camera2Config.defaultConfig())
                  .setCameraProviderExecutor(Executors.newCachedThreadPool())
                  .setMinimumLoggingLevel(Log.DEBUG)
                  .build();
      }
  }
  

  同时在AndroidManifest.xml的application节点声明该自定义Application类。

• 调整ImageAnalysis配置参数

  1. 降低目标分辨率至树莓派摄像头默认支持的640x480，避免HAL层不支持1280x720的分析流输出
  2. 明确指定分析流格式为YUV_420_888，匹配多数USB/CSI摄像头的原生输出格式
  3. 更换背压策略为STRATEGY_BLOCK_PRODUCER，避免部分HAL层不支持丢帧逻辑导致的流中断
     修改后的代码示例：

  analysis=new ImageAnalysis.Builder()
          .setBackpressureStrategy(ImageAnalysis.STRATEGY_BLOCK_PRODUCER)
          .setTargetResolution(new Size(640, 480))
          .setOutputImageFormat(ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888)
          .build();
  

• 补充绑定Preview用例
  绝大多数安卓设备的相机HAL要求必须同时绑定预览流才会输出分析流，你当前仅绑定了分析用例，树莓派的HAL不支持纯分析流的工作模式，新增一个无需绑定到View的哑Preview用例即可：

  Preview preview = new Preview.Builder().build();
  // 绑定时同时传入preview和analysis
  m.get().bindToLifecycle((LifecycleOwner) MainActivity.this, selector, preview, analysis);
  

• 更换CameraX稳定版本
  避免使用alpha/beta版CameraX，建议使用1.2.4或1.3.0正式版，该版本对非移动安卓设备的适配兼容性更高。

• 开启完整调试日志
  在Application初始化时添加如下代码开启CameraX全量日志，可捕获被静默过滤的适配错误：

  if (BuildConfig.DEBUG) {
      Logger.setMinLevel(Logger.LogLevel.DEBUG);
  }
  

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