Files
Velix-MPV-Core/DOCS/BUFFERING_MODEL.md

843 B

Buffering Model

buffering 是 MPV cache-buffering 属性与网络状态的边沿诊断,不是 UI 的瞬时文案。进入时记录 bufferingEnterCount 和起始 monotonic 时间;退出时累加 bufferingTotalMs,并更新 bufferingMaxSingleMs。重复的同值属性通知不会重复计数。

网络快照同时保留 protocol、host、HTTP status、redirect count、cache duration/bytes、current bitrate、range support 和最近 seek result。networkWaitMs 只计算已观察到的 network-open 到 first-byte/file-loaded 间隔;file:// 输入为 -1。

本地短片通常在首帧后很快 EOF,因此 buffering 计数为 0 不代表网络流在真实设备上不会重缓冲。受控 HTTP Range fixture 已在 Phase 5 验证;HTTPS/HLS、鉴权和弱网重缓冲应在实体设备用固定服务端脚本复测。