IUnify Player多格式 Web 播放器与插件体系

一套 API，原生 / React / Vue 通用，自动选择合适的播放引擎。

🎥

一键播放

传入

🔀

自动引擎选择

内置多套引擎，按优先级自动选择，失败时继续尝试直到找到可用方案。

🧩

即插即用插件

Analytics、Watermark、Ad、Playlist 已内置导出，按需调用 player.use(new Plugin())。

🛡️

错误可控

PlayerError + error/engine-error/fatal-error 事件，便于兜底提示与切源。

💻

多框架一致

原生、React、Vue 以同样的 Player API 操作，示例代码可直接复制运行。

适用场景

直接在 Web 页面或桌面 WebView 播放多格式媒体。
在 React / Vue 中快速内嵌自定义播放器 UI。
需要广告、水印、播放列表等功能时，用插件快速叠加。

支持的使用方式

Vanilla TypeScript：直接 createPlayer(videoEl, options)。
React：使用 useRef 获取 <video>，在 useEffect 中创建 Player。
Vue 3：ref 绑定 <video>，在 onMounted 中创建 Player。

快速入口

入门：/guide/getting-started
主要 API：/guide/basic-usage
事件：/guide/events
错误处理：/guide/errors
Demo：/demos/vanilla / react / vue