Velix-MPV-Core/DOCS/PHASE4_STATUS.md

Phase 4 状态

结论

Phase 4 CODE COMPLETE / DEVICE VALIDATION PENDING

GPU interop：BLOCKED（见 OHCODEC-BLOCKER-001）。

代码完成了 MPV 识别 FFmpeg OHCodec、H.264/HEVC decoder selection、能力检查、 direct-surface 实验接入、软件回退、诊断和构建矩阵。当前没有实体设备，因此 不能写成 hardware decode complete、zero-copy complete 或 HDR complete。

验证矩阵

项目	状态
AV_PIX_FMT_OHCODEC → IMGFMT_OHCODEC	COMPILE VERIFIED
AV_HWDEVICE_TYPE_OHCODEC 独立 backend	COMPILE VERIFIED
H.264 / HEVC selection guard	COMPILE VERIFIED；DEVICE TEST REQUIRED
API24 OHCodec capability 查询	COMPILE VERIFIED；设备返回值待验
Direct Surface plumbing	COMPILE VERIFIED；需独占窗口
GPU interop mapper	BLOCKED：上游无可导入 non-surface output contract
Software decode / OHAudio	CLEAN BUILD VERIFIED
OHCodec-enabled / software / GL-probe	AArch64 BUILD VERIFIED
Playback Lab HAP	BUILD VERIFIED；unsigned
Emulator	APP START + EGL SMOKE VERIFIED；不是硬解验证
Physical device	PENDING

产物与审计

• build/ohos-arm64/prefix/lib/libmpv.so.2.5.0 为 AArch64 ELF，保留 OHCodec、 OHAudio 及诊断符号。
• scripts/build-mpv-ohos-software.sh 使用独立 build 目录关闭 OHCodec，避免 软件回退配置与硬解构建互相污染。
• FFmpeg 保持锁定 upstream commit，未复制 SDK/第三方实现；许可证审计见 LICENSE_AUDIT.md。
• 当前 blocker、NativeBuffer 生命周期、EGL/fence/crop/stride 待验证项见 DOCS/OHCODEC_GPU_INTEROP_DESIGN.md 与 DOCS/HDR_PIPELINE_NOTES.md。
• Phase 4.5 FFmpeg export contract 独立维护于 ../Velix-FFmpeg-Harmony；MPV 只提供 scripts/build-mpv-ohos-ffmpeg-harmony.sh 前缀切换，未接入 mapper。

下一阶段最大风险

实体设备上的 codec capability、surface recreate、output buffer ownership、 acquire/release fence、crop/stride/color metadata，以及如何在不修改 FFmpeg surface contract 的前提下把硬件帧交给 MPV GPU composition。