Android CameraX无法访问ResolutionStrategy构造函数问题排查

可能原因 #

• CameraX依赖版本不匹配：部分新版本的CameraX中，ResolutionStrategy的构造函数可能被标记为内部使用（即使文档显示公开），官方已推荐使用静态工厂方法创建实例。
• Android Studio缓存异常：IDE缓存紊乱导致代码索引错误，明明构造函数是公开的却提示私有。
• 导入类错误：误导入了其他包下的同名类。

解决方法 #

• 使用官方推荐的静态工厂方法创建ResolutionStrategy，替代直接调用构造函数：

  // 示例：创建目标分辨率为640x480， fallback规则优先匹配比例
  val resolutionStrategy = ResolutionStrategy.create(
      Size(640, 480),
      ResolutionStrategy.FALLBACK_RULE_CLOSEST_HIGHER_THEN_LOWER
  )
  

• 检查CameraX核心库依赖版本，确保使用稳定版，比如在build.gradle中：

  implementation "androidx.camera:camera-core:1.4.0"
  implementation "androidx.camera:camera-camera2:1.4.0"
  

• 清理Android Studio缓存：依次点击File -> Invalidate Caches... -> Invalidate and Restart，重启后重新索引代码。
• 确认导入的类是androidx.camera.core.ResolutionStrategy，避免导错包。

可能原因 #

• 未处理图像旋转角度：CameraX输出的MediaImage带有传感器旋转信息，ML Kit检测时未适配该旋转，导致人脸坐标基于原始图像方向，和UI显示的方向不匹配。
• 预览View与MediaImage尺寸比例不一致：预览View的宽高比（比如16:9）和MediaImage的4:3（640x480）不匹配，直接映射坐标会导致拉伸或压缩。
• 坐标映射逻辑缺失：ML Kit返回的人脸坐标基于图像像素尺寸，未转换为预览View的实际显示坐标。

解决方法 #

1. 适配图像旋转角度
   从ImageProxy中获取旋转角度，创建ML Kit的InputImage时传入该角度，让检测结果自动适配UI方向：

   val imageProxy: ImageProxy = ... // CameraX的图像回调参数
   val inputImage = InputImage.fromMediaImage(
       imageProxy.image!!,
       imageProxy.imageInfo.rotationDegrees
   )
   // 传入inputImage进行人脸检测
   

2. 正确映射坐标到预览View
   假设预览View的尺寸为previewWidth和previewHeight，MediaImage尺寸为640x480，按以下步骤转换人脸坐标：

   • 计算缩放比例和偏移量：

     val imageWidth = 640
     val imageHeight = 480
     val previewRatio = previewWidth.toFloat() / previewHeight.toFloat()
     val imageRatio = imageWidth.toFloat() / imageHeight.toFloat()
     
     var scaleX: Float
     var scaleY: Float
     var offsetX = 0f
     var offsetY = 0f
     
     if (previewRatio > imageRatio) {
         // 预览View更宽，图像上下有黑边
         scaleY = previewHeight.toFloat() / imageHeight.toFloat()
         scaleX = scaleY
         offsetX = (previewWidth - imageWidth * scaleX) / 2
     } else {
         // 预览View更高，图像左右有黑边
         scaleX = previewWidth.toFloat() / imageWidth.toFloat()
         scaleY = scaleX
         offsetY = (previewHeight - imageHeight * scaleY) / 2
     }
     

   • 将ML Kit返回的Face.getBoundingBox()转换为预览View的坐标：

     val faceRect = face.boundingBox
     val left = faceRect.left * scaleX + offsetX
     val top = faceRect.top * scaleY + offsetY
     val right = faceRect.right * scaleX + offsetX
     val bottom = faceRect.bottom * scaleY + offsetY
     // 使用left、top、right、bottom绘制矩形框
     

3. 确保预览配置与图像尺寸匹配
   如果允许，可以调整CameraX的预览分辨率，让其与预览View的比例一致，减少坐标转换的复杂度。

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