如何在Jetpack Compose中为CameraXViewfinder实现自定义动态裁剪？

要实现类似Google Duo的自动取景（基于自定义归一化Rect动态裁剪预览并填满组件），最优且性能最高的方案是用CameraX Preview用例配合TextureView（替代默认SurfaceView），结合GPU加速的矩阵变换，而非依赖ImageAnalysis（后者性能开销更大）。

为什么你之前的方案行不通 #

• ViewPort：预设的ScaleType仅支持固定位置裁剪，无法满足任意动态Rect的需求，灵活性不足。
• Modifier.graphicsLayer：CameraXViewfinder底层使用SurfaceView，它的渲染独立于Compose的UI层级，Compose的图形变换无法作用于SurfaceView的内容，导致预览变黑。

推荐实现步骤 #

1. 用TextureView替代SurfaceView封装预览组件 #

TextureView支持硬件加速的缩放、平移等变换，完美适配Compose的UI环境。通过AndroidView封装TextureView，绑定CameraX的Preview用例：

@Composable
fun CustomCameraPreview(
    previewUseCase: Preview,
    transformMatrix: Matrix,
    modifier: Modifier = Modifier
) {
    AndroidView(
        modifier = modifier,
        factory = { context ->
            TextureView(context).apply {
                layoutParams = ViewGroup.LayoutParams(
                    ViewGroup.LayoutParams.MATCH_PARENT,
                    ViewGroup.LayoutParams.MATCH_PARENT
                )
                // 绑定CameraX Preview用例
                previewUseCase.setSurfaceProvider { request ->
                    val surface = Surface(surfaceTexture)
                    request.provideSurface(surface, ContextCompat.getMainExecutor(context)) {
                        surface.release()
                    }
                }
            }
        },
        update = { textureView ->
            // 应用动态变换矩阵
            textureView.setTransform(transformMatrix)
        }
    )
}

2. 动态计算裁剪变换矩阵 #

根据目标归一化Rect（比如图像右半部分：Rect(0.5f, 0f, 1f, 1f)），计算对应的缩放比例和平移量，生成Matrix：

fun calculateTransformMatrix(
    targetRect: RectF, // 归一化目标区域（0~1范围）
    viewSize: Size // 预览组件的尺寸
): Matrix {
    val matrix = Matrix()
    
    // 计算缩放比例：需要将目标区域放大到填满组件
    val scaleX = 1f / (targetRect.right - targetRect.left)
    val scaleY = 1f / (targetRect.bottom - targetRect.top)
    val scale = max(scaleX, scaleY)
    
    // 计算平移量：将目标区域居中到组件
    val translateX = -targetRect.left * viewSize.width * scale + (viewSize.width - viewSize.width * scale) / 2
    val translateY = -targetRect.top * viewSize.height * scale + (viewSize.height - viewSize.height * scale) / 2
    
    matrix.postScale(scale, scale)
    matrix.postTranslate(translateX, translateY)
    
    return matrix
}

3. 结合人脸检测动态更新裁剪区域 #

使用CameraX的FaceDetection用例获取人脸位置，实时调整目标Rect并更新变换矩阵，实现自动居中：

// 初始化FaceDetection用例
val faceDetection = FaceDetection.Builder()
    .setPerformanceMode(FaceDetection.PERFORMANCE_MODE_FAST)
    .build()

faceDetection.setAnalyzer(ContextCompat.getMainExecutor(context)) { faces ->
    if (faces.isNotEmpty()) {
        val face = faces[0]
        // 将人脸位置转换为归一化Rect（根据相机传感器方向调整）
        val faceRect = face.boundingBox
        val normalizedFaceRect = RectF(
            faceRect.left / cameraSensorSize.width.toFloat(),
            faceRect.top / cameraSensorSize.height.toFloat(),
            faceRect.right / cameraSensorSize.width.toFloat(),
            faceRect.bottom / cameraSensorSize.height.toFloat()
        )
        // 更新变换矩阵
        val newMatrix = calculateTransformMatrix(normalizedFaceRect, previewViewSize)
        // 触发Compose重组更新预览
        transformMatrixState.value = newMatrix
    }
}

关于ImageAnalysis的疑问 #

ImageAnalysis并非唯一可靠方式，反而不推荐用于实时预览裁剪：它需要将每一帧图像转换为Bitmap，涉及CPU层面的像素操作，性能开销大，难以维持高帧率。而TextureView的矩阵变换完全由GPU硬件加速，帧率更高、性能更优，是处理预览流动态裁剪的更直接方案。

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