media_proxy 0.0.5

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

0.0.5

• 新增可配置参数管理 (MediaProxyConfig)：提供统一的配置类，支持运行时调整分片大小、并发数、缓存策略、超时设置等 30+ 参数，无需修改源码即可定制代理行为。
• 配置热更新支持：通过 MediaProxyConfig.update() 方法可在运行时动态调整配置参数，支持部分更新。
• 默认值集中管理：所有配置参数均有合理的默认值，定义在 constants.dart 中，便于统一维护。
• 优化配置初始化：支持在应用启动时通过 MediaProxyConfig.init() 一次性配置所有参数，提升代码可维护性。

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.