media_proxy 0.0.4

A Flutter package that provides a local HTTP proxy for caching and prefetching media files to improve playback performance.

0.0.4

• 新增功能：支持 Http 请求头透传 (Header Pass-through)。现在可以在 getProxyUrl 和 preload 中传入自定义 Headers（如 Authorization, Referer 等），用于访问受保护的云存储资源。
• 智能缓存隔离：基于 URL + Headers 生成唯一的缓存 Key，确保不同鉴权信息的媒体资源物理隔离，防止缓存污染。
• 全链路 Header 注入：Headers 将自动应用于媒体元数据探测（HEAD/GET）及后续所有分片下载请求。
• 最终稳定性审计：完成了全项目的鲁棒性加固，修复了潜在的并发竞态及死锁隐患。

0.0.3+1

• 修复代码格式符合 pub.dev 标准。
• 规范化公开 API 的文档注释。

0.0.3

• 重磅优化：实现首屏起播独占模式 (Startup Exclusive Mode)。在视频起播的关键瞬间，自动锁定全局带宽，优先保障首个分片和 MP4 元数据（moov）的下载，显著降低黑屏起播时间。
• 增强调度安全性：引入计数锁机制（Counter Lock），支持多媒体、多会话并发起播时的精准带宽调度。
• 修复潜在死锁：重构下载队列的清理逻辑，确保任务在取消或失败时 100% 释放调度锁。
• 优化优先级算法：允许关键元数据（moov）与首帧分片共享独占期带宽，兼顾加载速度与播放器初始化稳定性。

0.0.2

• 修复网络切换后下载卡死：增加响应流读超时，网络中断或切换后任务能及时失败并重试。
• 修复视频末尾几秒无法播放：分片下载完整性校验、末尾分片强制预加载，数据不足时触发重新下载。
• 修复并发下载冲突：入队去重、分片完成时的并发处理，避免多任务同时处理同一分片导致文件冲突。

0.0.1

• Initial release.