@100mslive/hls-stats

中文文档
0.7.3发布于 2026/10/01ISCTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 4.2万

一个为您的hls流提供统计的简单库

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 初始化
  4. 订阅到 Stats
  5. 已曝光点

@ 100mslive/hms-stats (英语)

Lint, Test and Build Bundle Size License Tree shaking

HLS stats 用于 Hls.js 的简单库.

安装

yarn add @100mslive/hls-stats

或者说

npm install --save @100mslive/hls-stats

使用量

初始化


import Hls from "hls.js";

/**
 * Initialize Hls.js and attach the video element.
 */
const hlsInstance = new Hls();
hlsInstance.loadSource(hlsUrl);
hlsInstance.attachMedia(videoEl);

/**
 * initialize HlsStats
 */
const hlsStats = new HlsStats(hlsController.getHlsJsInstance(), videoEl);

订阅到 Stats

hlsStats 有个 subscribe 函数需要两个参数。 (单位:千美元) callbackFn 还有一个 interval (单位:毫秒). 这个 interval 告诉你,你有多频繁地想要hls -stats 向你报告。 默认为 2000ms

const unsubscribe = hlsStats.subscribe(state => {
    // ...
});

页:1 subscribe() 返回引用 unsubscribe() 函数,日后可用于取消订阅 从您的订阅

已曝光点

hls-stats目前披露以下数据

名称说明单位使用量
带宽玩家看到的当前带宽位数每秒用于显示当前用户的网络速度
位速率服务器显示当前hls流层的比特率位数每秒用于了解当前图层所需的比特率
缓冲期限从当前位置缓冲的持续时间分钟这可用于显示从当前位置缓冲多少数据( 前向缓冲)
从LiveEdge 的距离离生命边缘的距离分钟曾经知道目前缓冲持续时间
丢入的花纹丢掉的相框数量直到现在用于计算被丢帧的总数
视频Size.width视频Size.hight视频的宽度和高度ưμ㼯a曾经知道该决议正在播放
监视期限总观察时间分钟用于了解整个监视时间(而非流长)

版本与发布记录

@100mslive/hls-stats 共发布 537 个版本,首次发布于 2022/11/10;过去 12 个月发布了 82 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.3latest2026/10/011 个月前
0.7.3-alpha.1alpha2026/10/011 个月前
0.7.3-alpha.02026/09/291 个月前
0.7.22026/09/221 个月前
0.7.2-alpha.62026/09/221 个月前
0.7.2-alpha.52026/09/221 个月前

其他发布通道:experimental → 0.0.6-alpha.0,alpha → 0.7.3-alpha.1。

关于 @100mslive/hls-stats 的常见问题

@100mslive/hls-stats 是什么?

一个为您的hls流提供统计的简单库

如何安装 @100mslive/hls-stats?

在项目目录运行 npm install @100mslive/hls-stats,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:hls.js(1.4.12)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@100mslive/hls-stats 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@100mslive/hls-stats 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@100mslive/hls-stats 可以商用吗?

@100mslive/hls-stats 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@100mslive/hls-stats 的下载量有多少?

根据 npm 官方下载统计,@100mslive/hls-stats 在 2026/10/04 – 2026/11/02 这 30 天内被下载 41,959 次,日均约 1,399 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@100mslive/hls-stats 还在维护吗?

最新版本 0.7.3 发布于 2026/10/01(1 个月前);至今共发布 537 个版本,其中过去 12 个月发布了 82 个;首次发布于 2022/11/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。