Android CameraX拍照前如何确保对焦完成以避免拍摄出模糊照片

问题原因梳理 #

你第二次手动对焦耗时过长的核心是调用了disableAutoCancel()，导致对焦动作没有自动超时机制，在低亮、纹理不足等难以对焦的场景下会长时间等待，才会出现数秒的卡顿。

优化步骤 #

1. 开启连续自动对焦（基础配置） #

绑定UseCase时给相机配置连续自动对焦模式，相机会在预览过程中持续调整对焦状态，不需要每次拍照前全量触发对焦：

// 初始化预览、拍照用例
val preview = Preview.Builder().build()
val imageCapture = ImageCapture.Builder()
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
    .build()

// 绑定到生命周期
val camera = cameraProvider.bindToLifecycle(
    lifecycleOwner, cameraSelector, preview, imageCapture
)

// 监听对焦状态，记录当前是否已完成对焦
var isFocused = false
camera.cameraInfo.focusState.observe(lifecycleOwner) { focusState ->
    isFocused = focusState.isFocused
}

2. 拍照前的对焦逻辑优化 #

拍照前先判断当前对焦状态，如果已经对焦完成直接拍照；如果未完成，触发带超时的对焦动作，超时后无论是否对焦成功都执行拍照，避免用户长时间等待：

fun takePhoto() {
    // 已对焦直接拍照
    if (isFocused) {
        executeImageCapture()
        return
    }

    // 未对焦则触发1秒超时的对焦动作
    val focusAction = FocusMeteringAction.Builder(
        autoFocusPoint,
        FocusMeteringAction.FLAG_AF
    )
    .setAutoCancelDuration(1, TimeUnit.SECONDS) // 1秒超时自动取消对焦
    .build()

    camera?.cameraControl?.startFocusAndMetering(focusAction)
        ?.addListener({
            // 无论对焦成功失败都执行拍照，保证响应速度
            executeImageCapture()
        }, ContextCompat.getMainExecutor(context))
}

private fun executeImageCapture() {
    // 原有调用imageCapture.takePicture的逻辑
}

3. 高画质场景可选配置 #

如果你的业务对画质要求高于拍照速度，可以直接将ImageCapture设置为最大质量模式，CameraX底层会自动在拍照前触发对焦、测光优化，不需要手动写对焦逻辑：

val imageCapture = ImageCapture.Builder()
    // 该模式下CameraX自动处理拍照前的对焦流程
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MAXIMIZE_QUALITY)
    .build()

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