Velix-MPV-Core/MEMORY.md

Velix-MPV-Core Memory

• 项目：独立 HarmonyOS MPV 播放内核，禁止混入 Velix 主应用源码。
• 当前阶段：Phase 5 CODE COMPLETE / emulator-network validation pending；GPU INTEROP MAPPER 未进入；默认软件解码与网络播放公共 API 已构建验证。
• 基线：MPV 182fa6ca49f455cadb884858f386e2f00540aeb7，分支 harmony-port。
• SDK：OpenHarmony API 24 / 6.1.1.125 / aarch64-linux-ohos / Clang 15.0.4。
• 关键结论：首版 GLES+EGL+libmpv Render API；OHAudio AO；官方 FFmpeg OHCodec 路线。
• Phase 1 产物：build/ohos-arm64/prefix/lib/libmpv.so.2.5.0，AArch64 ELF，OpenGL Render API symbols 完整；当前默认重建大小约 34.3 MB。
• 远程：origin 为私有 Gitea 仓库，默认分支 harmony-port；upstream 为 MPV 官方仓库。
• Phase 4.5：独立 ../Velix-FFmpeg-Harmony，分支 harmony-ohcodec-export，远程 tip 990614364f；MPV 通过 scripts/build-mpv-ohos-ffmpeg-harmony.sh 选择其 prefix。
• Phase 2：playback_lab/ 独立 HAP，XComponent/OHNativeWindow/EGL/libmpv/软件解码已通；实体设备待验。
• Phase 3：audio/out/ao_harmony.c + OHAudio pull callback、pause/flush/clock/metrics 已通；实体机路由/A-V sync/压力待验。
• Phase 4：IMGFMT_OHCODEC、hwdec=ohcodec、API24 capability adapter、direct-surface experimental driver、软件构建矩阵、Playback Lab 诊断已提交；FFmpeg 保持 upstream。
• Phase 4 边界：官方 OHCodec hwcontext/decoder 仅提供 surface 输出，NativeBuffer→EGL 仅做禁用默认 API probe，未宣称零拷贝/HDR/真实硬件帧；详见 DOCS/OHCODEC_GPU_INTEROP_DESIGN.md。
• Phase 4.5 边界：FFmpeg export 模式不调用 RenderOutputBuffer，NativeBuffer/accessor/refcount/build probes 已完成；crop/fence/真实硬解仍需设备验证，harmony-ohcodec-gl 继续 disabled。
• Phase 5：include/mpv/harmony_playback.h + player/harmony_playback.c 提供不暴露 mpv 类型的稳定 PlaybackRequest/Track/Media/Network/State/Error API；Playback Lab 已接入请求 headers、脱敏、轨道、字幕和诊断面板。
• Phase 5 构建：默认、software、FFmpeg-Harmony 三套 AArch64 libmpv 构建及 Native/ArkTS 编译通过；HAP PackageHap 因当前环境缺 Java Runtime 未完成，网络/HLS/实体设备运行待验证。
• 索引：memory/projects.md、memory/infra.md、memory/lessons.md、memory/2026-08-28.md。