CameraX身份证拍摄：OverlayView框选后Bitmap底部裁剪异常求助

问题现状 #

开发身份证拍摄功能时，基于CameraX在预览视图绘制矩形引导框，目前已实现顶部、左侧、右侧的正确裁剪，但底部仍包含框外区域。

核心解决思路 #

裁剪底部异常通常是预览视图与拍摄图像的坐标/比例不匹配、窗口位置偏移未修正或图像旋转后的尺寸计算错误导致的，以下是具体修复步骤：

1. 统一Preview与ImageCapture的宽高比 #

CameraX的Preview和ImageCapture组件如果使用不同的宽高比，会导致拍摄图像与预览画面的缩放比例不一致，进而引发裁剪坐标计算错误。需确保两者使用相同的目标宽高比：

// 初始化Preview
val preview = Preview.Builder()
    .setTargetAspectRatio(AspectRatio.RATIO_4_3) // 或根据需求用RATIO_16_9
    .build()

// 初始化ImageCapture
val imageCapture = ImageCapture.Builder()
    .setTargetAspectRatio(AspectRatio.RATIO_4_3) // 与Preview保持一致
    .build()

2. 修正Y坐标的窗口偏移 #

getLocationInWindow获取的坐标包含状态栏高度，而预览视图通常位于状态栏下方，导致Y轴坐标计算偏高，最终裁剪时底部多包含了区域。需减去状态栏高度修正Y坐标：

val location = IntArray(2)
cardFrameView.getLocationInWindow(location)

// 获取状态栏高度
val statusBarHeight = run {
    val resId = resources.getIdentifier("status_bar_height", "dimen", "android")
    if (resId > 0) resources.getDimensionPixelSize(resId) else 0
}

// 修正Y坐标，减去状态栏偏移
val correctedY = location[1] - statusBarHeight
val y = (correctedY * scaleY).toInt()

3. 使用预览视图的实际绘制尺寸计算缩放比例 #

预览视图的布局尺寸可能与实际绘制尺寸不一致（如设置了scaleType），需获取其真实绘制宽高来计算缩放比例：

// 在预览视图布局完成后获取实际尺寸
previewView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        previewView.viewTreeObserver.removeOnGlobalLayoutListener(this)
        // 保存实际宽高用于后续裁剪计算
        previewActualWidth = previewView.width
        previewActualHeight = previewView.height
    }
})

// 后续计算缩放比例时使用实际尺寸
val scaleX = bitmap.width.toFloat() / previewActualWidth.toFloat()
val scaleY = bitmap.height.toFloat() / previewActualHeight.toFloat()

4. 验证图像旋转后的尺寸正确性 #

rotateBitmapIfRequired方法可能导致图像宽高互换（如竖拍图像旋转后），需确保旋转后的Bitmap尺寸与预览方向匹配，同时检查Exif信息读取是否正确。可以添加日志验证：

val bitmap = rotateBitmapIfRequired(bitmap1, uri)
Log.d(TAG, "旋转后Bitmap宽高: ${bitmap.width} x ${bitmap.height}")
Log.d(TAG, "预览视图宽高: ${previewActualWidth} x ${previewActualHeight}")

5. 调试裁剪区域坐标 #

添加日志打印裁剪区域的关键参数，确认Y轴和高度计算是否正确：

Log.d(TAG, "修正后Y坐标: $y, 裁剪高度: $rectHeight, 图像总高度: ${mat.height()}")
Log.d(TAG, "裁剪底部位置: ${y + rectHeight}, 图像底部边界: ${mat.height()}")

如果y + rectHeight大于图像高度，说明裁剪高度计算过大，需调整scaleY或rectHeight的计算逻辑。

内容的提问来源于stack exchange，提问作者Tuần