Velix-MPV-Core/memory/projects.md

# Projects

## Velix-MPV-Core

- 当前状态：Phase 7 CODE COMPLETE / EMULATOR INTEGRATION VERIFIED / DEVICE VALIDATION PENDING；Core 提交 `14149854b8` 已推送 `origin/harmony-port`。
- Phase 7 产物：`include/velix/core.h`、`sdk/native/`、`scripts/package-velix-core-sdk.sh`、`scripts/verify-velix-core-sdk.sh` 与 `DOCS/CORE_*.md`/集成文档；SDK ABI 版本 `0x000100`，仅导出 3 个 `velix_core_get_*` C ABI 符号。
- 主 App：`../Velix` 已通过 `scripts/sync-velix-core-sdk.sh` 接入预编译 Core，新增 `PlaybackEngine`、`MpvPlaybackEngine`、`PlaybackController`、`PlayerPage`；release/debug HAP 均可打包，产物为 `Velix/entry/build/default/outputs/default/entry-default-unsigned.hap`。
- 模拟器验收：PlayerPage surface/EGL/mpv READY；打包 sample MP4 本地播放、暂停、seek、软件解码统计、release 通过；HTTP URL/headers 路径已接入但受控宿主 HTTP 试验未形成稳定成功证据，实体机与真实网络待补。主 App 目录无 Git 元数据。
- Phase 6 产物：`benchmark/runner/run_emulator.py` 与场景 manifest；启动 P50/P95 506/1150ms，seek recovery P50/P95 277/631ms；100 load/stop、200 play/pause 无错误，PSS/精确 heap/CPU permille unavailable。
- Phase 6 文档：`DOCS/PHASE6_STATUS.md`、`PERFORMANCE_METRICS.md`、`PERFORMANCE_CHANGES.md`、`BENCHMARK_METHODOLOGY.md`、`STARTUP_PIPELINE.md`、`SEEK_PIPELINE.md`、`BUFFERING_MODEL.md`。

- 状态：Phase 5 CODE COMPLETE / emulator HTTP Range verified；GPU INTEROP MAPPER 未进入；HTTPS/HLS、网络字幕、鉴权、重定向运行验证与实体机验收未完成。
- 已完成：远程闭环、固定依赖、隔离工具链、C/C++ 探针、FFmpeg/OpenSSL/字体栈/libplacebo、AArch64 `libmpv.so.2.5.0`、ABI/符号/污染/许可证审计。
- 产物：`build/ohos-arm64/prefix/lib/libmpv.so.2.5.0`，当前重建 34,346,792 bytes；软件构建位于 `build/ohos-arm64/build/mpv-software/libmpv.so.2.5.0`，FFmpeg-Harmony 构建位于 `build/ohos-arm64/build/mpv-ffmpeg-harmony/libmpv.so.2.5.0`；DT_NEEDED 含 `libohaudio.so`。
- 已完成：独立 HAP、XComponent/OHNativeWindow、EGL ES3、libmpv OpenGL Render、软件解码本地 MP4 首帧、播放控制与释放重入。
- 已完成：`ao_harmony` PCM float32→S16 fallback、采样率/mono-stereo 协商、pause/resume/stop/flush/release、timestamp epoch、starvation/flush metrics；Phase 5 HAP 已用 DevEco JBR 完成打包并安装模拟器。
- 已完成：OHCodec H.264/HEVC capability 查询、`hwdec=ohcodec` direct-surface 实验驱动、显式软件回退、Playback Lab requested/actual/metrics 诊断、软件/硬解/GL probe 构建矩阵；FFmpeg 未修改。
- 边界：官方 OHCodec 上游没有非 surface 的可导入硬件帧路径，EGL/NativeBuffer 仅保留禁用默认探针；无零拷贝、HDR 或硬件帧产出声明。
- Phase 4.5：`../Velix-FFmpeg-Harmony` branch `harmony-ohcodec-export` 已推送 tip `f3a036c695`；跨 origin 重定向丢弃敏感自定义头/cookie，`scripts/build-mpv-ohos-ffmpeg-harmony.sh` 已消费其 prefix 构建 MPV。
- 待办：实体机 H.264/HEVC capability、surface 生命周期/stride/crop/fence、真实 GPU 互操作与 A/V sync；报告见两个仓库的 `DOCS/OHCODEC_*.md` 与 `DOCS/PHASE4_5_STATUS.md`。
- Phase 5 已完成：稳定 C API、请求/headers 会话隔离、错误/状态、轨道/媒体/网络/字幕控制、Playback Lab 诊断 UI 与文档；C++ 外壳已统一委托 C API，默认/软件/FFmpeg-Harmony 构建及 HAP 打包通过；模拟器已完成本地 MP4 与宿主受控 HTTP Range MP4 播放，HTTPS/HLS/网络字幕/鉴权/重定向运行验证待补。