Files
Velix-MPV-Core/DOCS/PERFORMANCE_METRICS.md
T

2.1 KiB

Phase 6 性能指标

所有时间均为单调时钟相对当前 load session 的毫秒数。-1 表示该事件没有发生或无法可靠观察;runner 会把负值转换为 null,不参与百分位统计。

类别 字段/来源 语义 模拟器可用性
启动 timeline.startupTotalMs / firstSwapMs load 到首个成功 EGL swap 可用
启动分段 create、initialize、load、START_FILE、FILE_LOADED、decoder reconfig、render context 各阶段首次事件 可用,缺失阶段为 -1
网络 firstByteMs、networkWaitMs、HTTP status、206/range 只记录观察到的请求/日志证据 HTTP fixture 可用,HTTPS/HLS pending
seek seekCommandLatencyMs、seekRecoveryMs、seekFirstSwapMs seek request/command 到恢复首帧/首 swap 相对 +10s 可用
buffering enter/exit 次数、累计时长、单次最大时长 cache-buffering 状态边沿 字段可用;本地短片通常为 0
音频 renderer start、首 callback、submitted/played、delay、starvation、flush/reset 首 callback 时间由诊断轮询观察,不冒充 callback 内精确时间 模拟器字段可用,设备路由 pending
视频 dropped、late、mistimed、decoder frames、render count MPV stats 或 renderer 计数 计数接口可用,部分 MPV 值可能为 -1
内存 /proc/<pid>/status VmRSS/VmSize 进程 RSS/虚拟地址空间 可用;PSS/精确 heap 为 null
CPU /proc/<pid>/stat utime+stime 原始 jiffies 原始值可用;未取得可靠 tick/采样归一化,不输出 permille
线程/资源 Threads、/proc/<pid>/fd 进程线程和 fd 快照 可用;fd=0 视为不可用
NAPI getState 次数、序列化微秒、估算 payload NAPI 状态导出成本 可用;payload 是上界估算,不是分配追踪
渲染诊断 render update/frame update、core sync/skipped 优化前后计数及合并效果 可用

NAPI 返回使用 Number 以保持 Inspector 可序列化;大整数仅用于内部原子计数。任何未被设备或 API 真实提供的数据都保持 unavailable,不由模型推断。