HarmonyOS 鸿蒙Next求助：OpenHarmony 5.0.3.135 上硬件解码 YUV 数据花屏，参考官方 AVCodec 示例时遇到 API 版本不匹配问题

OpenHarmony 5.0.3.135 对应 API 12，compileSdkVersion 应为 12，你看到的 26 是 HarmonyOS NEXT 的 SDK 版本号，二者不兼容。从 applications_app_samples 仓库切换到 OpenHarmony-5.0-Release 分支，就能取到正确的 AVCodec 示例，编译不会报错。

花屏的直接原因：硬件解码输出 buffer 的 YUV（通常 NV12）存在内存对齐，stride（行跨距）通常大于图像宽，且 slice_height 可能也大于高。你如果按宽×高连续拷贝，UV 平面会错位，必定花屏。软解内部做了对齐转换，所以正常。

解决方法：解码器回调拿到 OH_AVBuffer 或 OH_AVMemory 后，先通过 OH_AVFormat 获取实际 stride（OH_MD_KEY_VIDEO_STRIDE / "STRIDE"）、slice_height、pixel_format，然后逐行 memcpy。下面以 NV12 buffer 模式为例，给出核心拷贝逻辑（无需 surface）：

// 回调中获取 OH_AVBuffer *buffer
OH_AVFormat *format = OH_AVBuffer_GetFormat(buffer);
int32_t width, height, stride, sliceHeight, pixelFmt;
OH_AVFormat_GetIntValue(format, OH_MD_KEY_WIDTH, &width);
OH_AVFormat_GetIntValue(format, OH_MD_KEY_HEIGHT, &height);
OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_STRIDE, &stride);
OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_SLICE_HEIGHT, &sliceHeight);
OH_AVFormat_GetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, &pixelFmt); // 预期 NV12:2

uint8_t *srcData = OH_AVBuffer_GetAddr(buffer);
size_t ySize = stride * sliceHeight;           // Y 平面大小
uint8_t *uvSrc = srcData + ySize;              // UV 交叉平面
int uvStride = stride;                         // UV 通常与 Y 一致

// 拷贝到你的连续 YUV planar buffer (yBuf, uvBuf 预分配 width*height 大小)
for (int i = 0; i < height; i++) {
    memcpy(yBuf + i * width, srcData + i * stride, width);
}
for (int i = 0; i < height / 2; i++) {        // NV12 UV 高度为 1/2
    memcpy(uvBuf + i * width, uvSrc + i * uvStride, width); // UV 交叉: u、v 交替
}
// 用完释放 buffer
OH_VideoDecoder_FreeOutputBuffer(decoder, bufferIndex);

关键点：配置解码器时设置 OH_MD_KEY_PIXEL_FORMAT = PIXEL_FORMAT_NV12(2)，不绑定 surface。校验 stride 是否与硬件对齐相关（常为 64 或 16 的倍数），按 stride 逐行搬数据，丢弃 padding 部分，即可得到正常的 YUV 数据。