快速开始

IUnify Player 是一个框架无关的多格式播放器，基于 @iunify/player 提供的 createPlayer 与 Player API 工作。

安装

# 任选其一
npm i @iunify/player
pnpm add @iunify/player
bun add @iunify/player

最小可运行示例

import { createPlayer } from '@iunify/player'

const video = document.querySelector('video') as HTMLVideoElement

const player = createPlayer(video, {
  autoplay: false,
  muted: true
})

await player.setSource('https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4')
await player.play()

要点：

• 传入已有的 <video> 元素即可。
• setSource 支持字符串或 { src, format?, type? }。
• 调用 play 返回 Promise，建议 await 以捕获浏览器的播放限制错误。

播放一个视频（完整 HTML）

<video id="player" playsinline></video>
<script type="module">
  import { createPlayer } from 'https://cdn.skypack.dev/@iunify/player'

  const video = document.getElementById('player')
  const player = createPlayer(video, { muted: true })
  player.setSource('https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8')
  player.play()
</script>

下一步：

• 查看基础控制：/guide/basic-usage
• 了解事件：/guide/events
• 遇到异常：/guide/errors