AndroidX Camera中如何将ImageProxy转换为JPEG/PNG格式上传

基础转换方法（支持JPEG/JPG/PNG） #

调用ImageCapture.takePicture()获取到ImageProxy后，首先要注意：ImageProxy是CameraX持有的帧资源容器，使用完成必须调用close()释放，否则会阻塞后续帧队列，导致预览卡死、后续拍照无响应。

场景1：ImageCapture配置为JPEG输出（默认配置） #

CameraX的ImageCapture默认输出格式就是JPEG，这种场景下ImageProxy内已经存储了编码完成的JPEG数据，不需要二次转码，直接提取字节即可使用：

// Kotlin中使用use扩展函数，会在作用域结束后自动调用ImageProxy.close()，避免资源泄漏
imageProxy.use { image ->
    // JPEG格式的图像数据全部存储在第0个Plane的缓冲区中
    val buffer = image.planes[0].buffer
    val jpegBytes = ByteArray(buffer.remaining())
    buffer.get(jpegBytes)
    
    // jpegBytes就是标准JPEG格式字节数组，可直接传给上传接口
    // 如果需要存本地，直接写入文件流即可
}

注意：这种方式拿到的JPEG字节自带原始EXIF信息，部分机型上旋转角度存在EXIF标记中，如果你的上传链路或后端服务不会自动解析EXIF旋转信息，可能出现图片方向错误，优先选择直接落盘的方案更稳妥。

场景2：需要输出PNG格式，或ImageProxy为YUV_420_888格式 #

如果需要输出PNG，或者你是从Analysis用例拿到的YUV格式ImageProxy，需要先将图像数据转成Bitmap，处理旋转后再编码为目标格式，可直接复用以下扩展函数：

import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.graphics.ImageFormat
import android.graphics.Matrix
import android.graphics.YuvImage
import java.io.ByteArrayOutputStream

fun ImageProxy.toCompressedBytes(
    format: Bitmap.CompressFormat,
    quality: Int = 90
): ByteArray {
    return use { image ->
        // 根据原始图像格式转成Bitmap
        val sourceBitmap = when (image.format) {
            ImageFormat.JPEG -> {
                val buffer = image.planes[0].buffer
                val bytes = ByteArray(buffer.remaining())
                buffer.get(bytes)
                BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
            }
            ImageFormat.YUV_420_888 -> {
                val yBuffer = image.planes[0].buffer
                val uBuffer = image.planes[1].buffer
                val vBuffer = image.planes[2].buffer
                val ySize = yBuffer.remaining()
                val uSize = uBuffer.remaining()
                val vSize = vBuffer.remaining()
                val nv21Bytes = ByteArray(ySize + uSize + vSize)
                // 按NV21格式拷贝YUV通道数据
                yBuffer.get(nv21Bytes, 0, ySize)
                vBuffer.get(nv21Bytes, ySize, vSize)
                uBuffer.get(nv21Bytes, ySize + vSize, uSize)
                val yuvImage = YuvImage(nv21Bytes, ImageFormat.NV21, image.width, image.height, null)
                val yuvOut = ByteArrayOutputStream()
                yuvImage.compressToJpeg(android.graphics.Rect(0, 0, image.width, image.height), 100, yuvOut)
                BitmapFactory.decodeByteArray(yuvOut.toByteArray(), 0, yuvOut.size())
            }
            else -> throw IllegalArgumentException("不支持的图像格式: ${image.format}")
        }

        // 根据ImageProxy自带的旋转信息修正Bitmap方向
        val rotationDegrees = image.imageInfo.rotationDegrees
        val resultBitmap = if (rotationDegrees != 0) {
            val rotateMatrix = Matrix().apply { postRotate(rotationDegrees.toFloat()) }
            Bitmap.createBitmap(sourceBitmap, 0, 0, sourceBitmap.width, sourceBitmap.height, rotateMatrix, true)
        } else {
            sourceBitmap
        }

        // 按目标格式压缩输出
        val outputStream = ByteArrayOutputStream()
        resultBitmap.compress(format, quality, outputStream)
        // 回收临时Bitmap，避免内存泄漏
        if (resultBitmap != sourceBitmap) resultBitmap.recycle()
        sourceBitmap.recycle()

        outputStream.toByteArray()
    }
}

// 调用示例
// 转JPG/JPEG
val jpegBytes = imageProxy.toCompressedBytes(Bitmap.CompressFormat.JPEG, 85)
// 转PNG
val pngBytes = imageProxy.toCompressedBytes(Bitmap.CompressFormat.PNG, 100)

更高效的实现方案 #

如果不需要对图片做内存层面的二次处理（比如加滤镜、人脸裁剪、自定义水印），以下方案性能远高于手动转ImageProxy：

• 优先调用带OutputFileOptions的takePicture重载，直接将照片写入本地临时文件，拍照完成后直接拿文件上传。这个过程CameraX会自动处理格式编码、旋转角度修正、EXIF写入，完全跳过内存中转的开销，还能避免大分辨率照片导致的OOM。
  实现示例：

  // 创建临时上传文件
  val tempUploadFile = File(externalCacheDir, "upload_${System.currentTimeMillis()}.jpg")
  val outputOptions = ImageCapture.OutputFileOptions.Builder(tempUploadFile).build()
  
  imageCapture.takePicture(
      outputOptions,
      ContextCompat.getMainExecutor(context),
      object : ImageCapture.OnImageSavedCallback {
          override fun onImageSaved(result: ImageCapture.OutputFileResults) {
              // 直接使用tempUploadFile上传即可，无需额外转码
              uploadService.upload(tempUploadFile)
          }
          override fun onError(exception: ImageCaptureException) {
              // 处理拍照错误
          }
      }
  )
  

• 不要随意修改ImageCapture的默认输出格式：默认的JPEG输出格式已经做了硬件编码加速，性能远高于YUV_420_888格式输出后手动转码，没有特殊需求不要改配置。
• 上传时使用流式请求体，不要把整个图片的字节数组一次性加载到内存：大分辨率照片的字节体积可能达到10MB以上，直接用文件流做分块上传，能大幅降低内存峰值，减少OOM概率。
• 及时释放资源：Java场景下要把ImageProxy的close操作放在finally块中，Bitmap使用完成后及时调用recycle()，避免CameraX帧队列被未释放的资源堵塞，导致后续拍照失败。

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