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 已于 Phase 8 建立独立 Git。

• Phase 8 UI：主 App ../Velix 已初始化独立 Git，提交 058c7a8；HomeSource、Discovery/Media Provider 边界、Mock/TMDB skeleton、RemoteImage/cache、Source Capsule/Sheet、Floating Navigation、Home/Detail、Player token integration 已完成。默认 TMDB Discovery 无服务器可用，TMDB live credentials pending；Core 未修改。

• Phase 8 模拟器：127.0.0.1:5555 已安装主 App HAP；首页远程图片、来源 Sheet、Hero → Detail、PlayerPage 本地 MP4 均已回归。截图见 ../Velix/design-qa.md。

• VUI1：主 App 沉浸式视觉重构已完成；AmbientPalette 驱动全屏 Hero/页面氛围色，浮层共用 1–4 级 MaterialSurface，底部导航使用 HDS HdsTabs immersive material。Pura 90 Pro Max 已回归首页、Sheet、详情、播放器自动隐藏和深色；MatePad Pro 13 已回归宽屏首页与详情分栏。Core 未修改，主 App 等待提交。

• VUI1 修正：首页的来源胶囊、搜索与个人入口已从 Scroll 抽离，与底部导航一样作为固定浮层；Pura 90 Pro Max 上滑回归通过。

• VUI1 首页重构：首页改为 Full-Bleed Immersive Home；Hero 的 backdrop/transition/ambient browsing surface 三层连续，环境色改用语义 Ambient Palette，顶部与 HDS 底栏统一使用动态氛围材质；Pura 90 Pro Max 初始态与滚动回归通过，主 App 待提交。

• VUI1 底栏修正：保留 HDS 沉浸光感底材，Tab 前景保持不透明，选中图标继续使用当前影片的环境取色；Pura 90 Pro Max 回归通过。

• VUI1 Scene Continuity：首页背景重构为跨 Hero 与第一分区的单一 Background Scene；Backdrop 长尾衰减至正文，正文 Column 透明，Hero 轮播时背景 URL 与环境色同步刷新；Pura 90 Pro Max 已回归。

• VUI1 Motion Handoff：保留双层 artwork 复用；Hero visual 底部加入纵向渐隐交接区，背景仅在原生 Swiper settle 后以 420ms 固定位置过渡；拖动/回弹/快速 flick 已在 127.0.0.1:5555 回归。

• VUI1 VUI3：Hero 顶部保持原生 100% 跟手，底部 160–220vp 以 smoothstep 位移渐衰 + Alpha 交接固定同图背景；静止、30/50% 中帧、回弹、flick 与 settle 已回归。

• VUI1 TMDB：生产首页已移除 Mock fallback，接入 API key/Bearer、统一 DTO/Mapper、内存+Preferences 缓存、详情/TV season/搜索；模拟器已验证无 key 与 401 错误态不崩溃，真实 key 待本地填入后做 live feed 回归。

• VUI1 TMDB edge：详情等待凭据初始化，Hero 过滤 person，保存 imdbId/tvdbId，详情入口不再伪装播放，演员可展开查看全部；应用提交 c975fb2。

• 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/网络字幕/鉴权/重定向运行验证待补。