Jetpack Compose中CameraX每秒截取预览帧存为PNG的问题

云上老周

2026-8-16

问题核心原因

IO操作阻塞主线程：writeBitmap是同步阻塞的文件写入逻辑，默认在viewModelScope的Main调度器执行，会卡住主线程，拖慢协程调度，导致每秒截帧的定时逻辑被打乱。
Bitmap复用风险：直接使用previewView.bitmap拿到的是CameraX复用的实例，后续新帧会覆盖旧内容，导致保存的图片内容错误。
定时逻辑受阻塞影响：while(true)+delay(1000)是从上一次协程恢复后开始计时，若保存操作阻塞线程，下一次截帧时间会被延后，无法保证严格的每秒一次。

解决方案

1. 将IO操作移至后台线程

修改ViewModel的保存函数，用withContext(Dispatchers.IO)把文件写入切换到IO线程，彻底避免阻塞主线程：

fun saveBitmapToPosesFolder(bitmap: Bitmap, context: Context, ext: Int) = viewModelScope.launch {
    Log.d("MP20", "saveBitmapToPosesFolder and ext is:$ext")
    val dirPath = context.filesDir.absolutePath
    val fName = "${dirPath}/poses/live${ext}.png"
    
    // 切换到IO线程执行文件操作，同时拷贝Bitmap避免原实例被复用
    withContext(Dispatchers.IO) {
        val savedBitmap = bitmap.copy(bitmap.config, false)
        File(fName).writeBitmap(savedBitmap, Bitmap.CompressFormat.PNG, 65)
        savedBitmap.recycle() // 释放拷贝的Bitmap，避免内存泄漏
    }
}

2. 优化截帧定时逻辑

用flow.interval替代while(true)+delay，保证定时不受保存操作的影响：

LaunchedEffect(isTimerRunning) {
    if (!isTimerRunning) return@LaunchedEffect
    
    flow {
        interval(1000) // 每秒触发一次
    }.collect {
        if (!isTimerRunning) return@collect
        
        val bitmap = previewView.bitmap
        if (bitmap != null) {
            val currentExt = a.value.toInt()
            myViewModel.saveBitmapToPosesFolder(bitmap, context, currentExt)
            a.value = currentExt + 1
        }
    }
}

3. 改用CameraX ImageAnalysis获取帧（更优方案）

previewView.bitmap效率低且易出同步问题，推荐用ImageAnalysis直接获取预览帧：

// 配置ImageAnalysis
val imageAnalysis = ImageAnalysis.Builder()
    .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST) // 只保留最新帧
    .build()
    .also {
        // 用后台线程池执行帧分析
        it.setAnalyzer(Executors.newSingleThreadExecutor()) { imageProxy ->
            if (!isTimerRunning) {
                imageProxy.close()
                return@setAnalyzer
            }
            
            // 将YUV格式的Image转换为Bitmap（需实现该扩展函数）
            val bitmap = imageProxy.toBitmap()
            val currentExt = a.value.toInt()
            myViewModel.saveBitmapToPosesFolder(bitmap, context, currentExt)
            a.value = currentExt + 1
            
            imageProxy.close() // 必须关闭，否则CameraX会停止输出新帧
        }
    }

// 绑定到Camera生命周期
CameraProvider.bindToLifecycle(
    this,
    CameraSelector.DEFAULT_FRONT_CAMERA,
    preview,
    imageAnalysis
)

4. 可选：将writeBitmap转为挂起函数

如果希望writeBitmap本身是挂起逻辑，可修改为：

suspend fun File.writeBitmap(bitmap: Bitmap, format: Bitmap.CompressFormat, quality: Int) =
    withContext(Dispatchers.IO) {
        outputStream().use { out ->
            bitmap.compress(format, quality, out)
            out.flush()
        }
    }

之后在ViewModel中直接调用即可，无需额外包裹withContext。

关键注意事项

Bitmap内存管理：拷贝Bitmap后记得调用recycle()释放内存，避免OOM。
ImageProxy必须关闭：使用ImageAnalysis时，处理完帧后必须关闭imageProxy，否则CameraX会停止发送新帧。
定时精度：flow.interval基于系统时钟，比while+delay更稳定，但主线程负载过高时仍可能有微小偏差，可结合系统时间戳手动调整。

内容的提问来源于stack exchange，提问作者Gregor Sotošek