如何基于OpenGL纹理/AHardwareBuffer同步创建android.media.Image实例？

核心思路 #

Android 12（API 31）及以上提供了直接同步创建Image的API，低版本则需要通过内存拷贝结合临时ImageReader实现同步获取。关键是利用HardwareBuffer与Image的底层关联，绕开异步回调的ImageReader监听机制。

步骤1：将NDK的AHardwareBuffer转换为Java层HardwareBuffer #

首先把NDK中创建的AHardwareBuffer指针转换为Java层的HardwareBuffer对象（API 26+支持）：

// 从NDK传递的AHardwareBuffer指针（long类型）
long aHardwareBufferPtr = ...;
HardwareBuffer hardwareBuffer = HardwareBuffer.createFromAHardwareBuffer(aHardwareBufferPtr);

步骤2：API 31+ 同步创建Image实例 #

Android 12及以上提供的Image.wrapHardwareBuffer()方法可同步直接生成Image实例，完全匹配你的需求：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 第二个参数为ColorSpace，第三方API无特殊要求可传null
    Image image = Image.wrapHardwareBuffer(hardwareBuffer, null);
    
    // 直接将image传入第三方帧处理API（如人脸检测）
    yourFaceDetectionApi.process(image);
    
    // 必须手动关闭Image，避免内存泄漏
    image.close();
}

步骤3：API 26-30 低版本同步兼容方案 #

低版本无直接wrap方法，需通过临时ImageReader创建空Image，再将AHardwareBuffer的像素数据同步拷贝进去：

1. 创建与AHardwareBuffer同尺寸、格式的ImageReader：

// 假设你的AHardwareBuffer格式为YUV_420_888，尺寸为width x height
ImageReader tempReader = ImageReader.newInstance(width, height, ImageFormat.YUV_420_888, 1);
// 同步获取空Image实例（无需等待回调）
Image image = tempReader.acquireNextImage();

2. 在NDK层完成内存拷贝：
   将AHardwareBuffer映射后的数据，拷贝到Image各平面对应的Direct ByteBuffer中：

// NDK代码示例
AHardwareBuffer* ahwb = ...; // 已有的AHardwareBuffer指针
void* mappedData;
// 锁定缓冲区以获取可访问的内存指针
AHardwareBuffer_lock(ahwb, AHARDWAREBUFFER_USAGE_CPU_READ_OFTEN, -1, nullptr, &mappedData);

// 通过JNI获取Java层Image各平面的Direct ByteBuffer地址，执行内存拷贝
// （需根据YUV_420_888的平面布局分别拷贝Y、Cb、Cr分量）
// 示例：拷贝Y平面
jobject yPlaneBuffer = ...; // 从Image.getPlanes()[0].getBuffer()获取
void* yBufferAddr = env->GetDirectBufferAddress(yPlaneBuffer);
memcpy(yBufferAddr, mappedData, yPlaneSize);

// 拷贝完成后解锁缓冲区
AHardwareBuffer_unlock(ahwb, nullptr);

3. 使用并清理资源：

// 传入第三方API处理
yourFaceDetectionApi.process(image);

// 关闭Image和临时ImageReader
image.close();
tempReader.close();

关键注意事项 #

• 格式匹配：确保AHardwareBuffer的格式（如AHARDWAREBUFFER_FORMAT_Y8Cb8Cr8_420）与第三方API要求的Image格式（如ImageFormat.YUV_420_888）完全一致。
• 权限设置：创建AHardwareBuffer时需指定正确的使用权限，如AHARDWAREBUFFER_USAGE_CPU_READ_OFTEN（用于内存拷贝）或AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE（用于OpenGL纹理）。
• 资源释放：所有Image、HardwareBuffer、ImageReader实例必须在使用后手动关闭，避免内存泄漏。

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