Camera2 API外接USB相机拍照存黑图问题排查求助

以下是针对POS设备上仅出现该问题的具体分析方向：

• ImageReader格式/分辨率不兼容
  外接USB相机的硬件规格和手机内置相机差异较大，可能不支持你当前设置的图像格式或分辨率。比如你直接用ImageFormat.JPEG创建ImageReader，但部分USB相机仅支持YUV格式的原始帧输出；或者设置的分辨率不在USB相机的支持列表内，导致捕获的帧数据为空。
  解决：通过CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP获取USB相机支持的所有格式和分辨率，确保ImageReader的参数与之匹配，必要时先捕获YUV帧再转成JPEG保存。

• 拍照请求参数缺失关键控制项
  手机内置相机的HAL会自动补全部分捕获参数，但USB相机可能需要显式配置对焦、曝光等参数。如果你的拍照请求没设置自动对焦触发、自动曝光模式，可能导致帧曝光不足成黑图。
  检查代码中构建拍照请求的部分，确保添加这些关键参数：

  captureRequestBuilder.set(CaptureRequest.CONTROL_AF_TRIGGER, CaptureRequest.CONTROL_AF_TRIGGER_START);
  captureRequestBuilder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON);
  

• ImageReader回调的帧处理逻辑问题
  USB相机的帧传输延迟可能比内置相机高，如果你在onImageAvailable()中直接调用acquireNextImage()，可能拿到还未完全写入数据的空帧。另外，如果处理完图像后未及时调用image.close()，会导致缓冲区泄漏，后续帧无法正常写入。
  调整：改用acquireLatestImage()获取最新的有效帧，处理完成后务必调用image.close()释放资源。

• POS设备Camera HAL兼容性缺陷
  部分POS设备的Camera硬件抽象层对USB相机的支持不完善，比如无法正确处理捕获请求的输出缓冲区，或者帧数据传输时出现丢失。查看LogCat日志，重点关注CameraDevice、ImageReader相关的警告或错误，比如BufferQueue报错、Failed to dequeue buffer等信息，这些能直接定位HAL层的问题。

• 设备资源竞争
  POS设备可能有后台系统服务或其他应用占用了USB相机的捕获资源，导致你的应用拿到的帧为空。检查设备是否有其他进程在使用相机，同时确保你的代码在退出时正确关闭CameraDevice、ImageReader等资源，避免资源泄漏。

内容的提问来源于stack exchange，提问作者Ac. Selvan