Android CameraX中ImageCapture.takePicture回调未触发问题求助

问题原因 #

这是CameraX在API 31及以上Android模拟器上的已知兼容性问题，核心是模拟器的Camera HAL层对ImageCapture的内存回调处理存在异常，导致拍照请求被静默丢弃，既不触发onCaptureSuccess也不触发onError回调。同时，未明确设置ImageCapture的目标分辨率、使用不兼容的线程执行器，也会加重该问题的出现概率。

修复方案 #

1. 升级CameraX依赖至最新稳定版 #

Google后续版本已针对该问题做了修复，优先升级CameraX相关依赖：

dependencies {
    def camerax_version = "1.3.0" // 可替换为最新稳定版
    implementation "androidx.camera:camera-core:$camerax_version"
    implementation "androidx.camera:camera-camera2:$camerax_version"
    implementation "androidx.camera:camera-lifecycle:$camerax_version"
    implementation "androidx.camera:camera-view:$camerax_version"
}

2. 明确设置ImageCapture的目标分辨率 #

API 31+模拟器对默认分辨率支持不佳，为ImageCapture指定明确的分辨率：

val imageCapture = remember {
    ImageCapture.Builder()
        .setTargetResolution(Size(1920, 1080)) // 设置常用的1080P分辨率
        .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
        .build()
}

3. 替换执行器为主线程执行器 #

避免使用自定义单线程执行器，改用主线程执行器，解决线程兼容性问题：

// 替换原executor的创建代码
val executor = ContextCompat.getMainExecutor(context)

4. 使用文件保存式拍照重载（临时Workaround） #

若上述方案无效，改用takePicture的文件保存重载，该方式在API31+模拟器上稳定性更高：

fun takePhoto(
    imageCapture: ImageCapture,
    context: Context,
    onCaptureSuccess: (Uri) -> Unit,
    onError: (ImageCaptureException) -> Unit
) {
    val photoFile = File(
        context.externalMediaDirs.firstOrNull() ?: context.filesDir,
        "${System.currentTimeMillis()}.jpg"
    )
    val outputOptions = ImageCapture.OutputFileOptions.Builder(photoFile).build()

    imageCapture.takePicture(
        outputOptions,
        ContextCompat.getMainExecutor(context),
        object : ImageCapture.OnImageSavedCallback {
            override fun onImageSaved(outputFileResults: ImageCapture.OutputFileResults) {
                val savedUri = Uri.fromFile(photoFile)
                onCaptureSuccess(savedUri)
                Log.d(TAG, "拍照成功，路径：$savedUri")
            }

            override fun onError(exception: ImageCaptureException) {
                onError(exception)
                Log.e(TAG, "拍照失败", exception)
            }
        }
    )
}

验证建议 #

• 在真实设备上测试：该问题仅出现在API31+模拟器，真实设备通常无此异常；
• 若必须使用模拟器，可尝试切换至API30及以下版本的模拟器环境。

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