# ezuikit-flv

> ![Download](https://img.shields.io/npm/dm/ezuikit-flv.svg) ![Version](https://img.shields.io/npm/v/ezuikit-flv.svg)

Latest version **2.1.1** (published 2026-03-03) · 0 weekly downloads

## Install

```sh
npm install ezuikit-flv
pnpm add ezuikit-flv
yarn add ezuikit-flv
bun add ezuikit-flv
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 2.1.1 |
| Published | 2026-03-03 |
| First published | 2023-08-28 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 52 |
| Author | Ezviz-OpenBiz |
| Maintainers | freeshine, ezviz-openteam, ezviz-jzy |

## Links

- npm: https://www.npmjs.com/package/ezuikit-flv
- Repository: https://github.com/Ezviz-OpenBiz/EZUIKit-flv
- Issues: https://github.com/Ezviz-OpenBiz/EZUIKit-flv/issues
- npm.io page: https://npm.io/package/ezuikit-flv

## Recent versions

- 2.1.1 (latest) — 2026-03-03
- 2.1.2-beta.2 (beta) — 2026-09-20
- 2.0.3-alpha.2 (alpha) — 2025-11-14
- 2.1.2-beta.1 — 2026-07-22
- 2.1.1-beta.1 — 2026-03-03
- 2.1.0 — 2026-01-22
- 1.0.3-beta.6 — 2025-12-24
- 2.0.3 — 2025-11-14
- 2.0.3-beta.1 — 2025-11-14
- 2.0.3-alpha.1 — 2025-11-14
- 1.0.3-beta.5 — 2025-11-13
- 1.0.3-beta.4 — 2025-10-29
- 1.0.3-beta.3 — 2025-10-29
- 2.0.2 — 2025-10-16
- 2.0.2-beta.1 — 2025-10-16
- … 44 more at https://npm.io/package/ezuikit-flv/versions

## README

## Ezuikit-flv

![Download](https://img.shields.io/npm/dm/ezuikit-flv.svg) ![Version](https://img.shields.io/npm/v/ezuikit-flv.svg)

ezuikit-flv 是一款开源的纯 H5 直播流播放器，通过 Emscripten 将音视频解码库编译成 js（wasm) 运行于浏览器之中。兼容几乎所有浏览器，可以运行在 PC、手机、微信中，无需额外安装插件。

## 功能

- 支持解码 H.264 视频
- 支持解码 H.265 视频（flv id == 12）
- 支持 2K 视频
- 支持解码 AAC 音频
- 可设置播放缓冲区时长，可设置 0 缓冲极限低延迟（网络抖动会造成卡顿现象）
- 可创建多个播放实例
- 手机浏览器内打开长时间不会息屏
- 支持填充，等比，等比缩放 3 种视频缩放模式
- 支持 0，90，180，270 度画面旋转
- 支持 MediaSourceExtensions 硬件解码
- 支持 MediaSourceExtensions 硬解码失败的情况下自动切换到 wasm 软解码

### npm 使用

```bash
npm install ezuikit-flv
```

```js
import "ezuikit-flv/style.css"; // @since 2.0.1
import EzuikitFlv from "ezuikit-flv";

const player = new EzuikitFlv({
  url: "play url", // https://play.com/9999.flv
  id: "id", // support element id
  decoder: "decoder.js", // 自定义解码库加载地址， 默认放置在服务器根目录下
  autoPlay: true,
  // downloadRecord: true, // 默认为 true, 录制完成后会自动下载， 设置为 false 后， 需要用户手动处理录制文件
  // themeData: null // 忽略主题
});

// player.play(); // 由于解码资源异步加载的问题 不推荐
```

### umd 使用

```html
<div id="container-id">
  <!-- ezuikit-flv css file  `node_modules/ezuikit-flv/style.css`-->
  <link rel="stylesheet" href="./style.css" />
  <!-- ezuikit-flv umd file  `node_modules/ezuikit-flv/index.js`-->
  <script src="./index.js"></script>
  <script>
    const player = new EzuikitFlv({
      url: "play url", // https://play.com/9999.flv
      id: "container-id", // support element id or element
      decoder: "decoder.js", // 自定义解码库加载地址， 默认放置在服务器根目录下
      autoPlay: true,
      // downloadRecord: true, // 默认为 true, 录制完成后会自动下载， 设置为 false 后， 需要用户手动处理录制文件
      // themeData: null // 忽略主题
    });

    // player.play(); // 由于解码资源异步加载的问题 不推荐
  </script>
</div>
```

注意： 暂不提供 CDN 地址， decoder 静态资源需要放置在自己的服务器下（`node_modules/ezuikit-flv`下 `decoder.wasm` 和 `decoder.js` 文件， 这两个文件需要在同一个文件夹下）

注意： 暂不提供 CDN 地址，decoder 静态资源需要放置在自己的服务器下（`node_modules/ezuikit-flv`下 `decoder.wasm` 和 `decoder.js` 文件， 这两个文件需要在同一个文件夹下）

注意： 暂不提供 CDN 地址，decoder 静态资源需要放置在自己的服务器下（`node_modules/ezuikit-flv`下 `decoder.wasm` 和 `decoder.js` 文件， 这两个文件需要在同一个文件夹下）

### 配置

[options](https://ezviz-openbiz.github.io/EZUIKit-flv/global.html#FlvOptions)

### api

[api](https://ezviz-openbiz.github.io/EZUIKit-flv/EzuikitFlv.html)

### examples

[base-app](https://github.com/Ezviz-OpenBiz/EZUIKit-flv/tree/master/examples/base-app)

[react-app](https://github.com/Ezviz-OpenBiz/EZUIKit-flv/tree/master/examples/react-app)

[vue3.3-app](https://github.com/Ezviz-OpenBiz/EZUIKit-flv/tree/master/examples/vue3.3-app)

[vue2.5-app](https://github.com/Ezviz-OpenBiz/EZUIKit-flv/tree/master/examples/vue2.5-app)

---
_Source: https://npm.io/package/ezuikit-flv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._