事件

Player 使用统一的事件系统封装了媒体事件、源切换事件与错误事件。推荐使用 player.on/player.once 订阅，并在组件卸载或销毁时移除。

const off = player.on('play', () => console.log('playing'))
player.once('ended', () => console.log('finished'))
off() // 取消监听

事件列表与触发时机

播放控制
- play：调用 play() 成功后触发
- pause：调用 pause() 或媒体暂停后触发
- ended：媒体自然播放完毕
时间与进度
- timeupdate：当前时间变更（已做 requestAnimationFrame 合帧）
- progress：缓冲进度更新（合帧后触发）
- durationchange：总时长变化
定位
- seeking：调用 seek() 或用户拖动开始
- seeked：拖动结束
加载
- loadstart：开始加载
- loadeddata：首帧可用
- loadedmetadata：元数据可用
- canplay：可开始播放（同时清除 loading/stalled 状态）
- canplaythrough：估算可无缓冲播放
- waiting：缓冲中
- stalled：数据请求停滞
音量与速率
- volumechange：音量或静音状态变化
- ratechange：播放速率变化
源切换
- sourcechange-start：调用 setSource 开始尝试新源
- sourcechange：引擎附加成功并切换完成
- sourcechange-failed：所有可用引擎均失败
引擎
- engine-attach-failed：某个引擎的 attach 失败
- engine-error：引擎在播放过程中报错
全屏
- enterfullscreen：进入全屏
- exitfullscreen：退出全屏
错误
- error：统一错误事件（包含媒体、引擎、核心错误）
- fatal-error：fatal=true 的严重错误（通常需要切源或提示用户）

示例：收集关键事件

import type { PlayerEventType, PlayerError } from '@iunify/player'

const watchEvents: PlayerEventType[] = [
  'play', 'pause', 'ended',
  'timeupdate', 'progress',
  'sourcechange', 'sourcechange-failed',
  'fatal-error'
]

const disposers = watchEvents.map(evt =>
  player.on(evt, (payload) => {
    if (evt === 'fatal-error') {
      const err = payload as PlayerError
      console.error('Fatal', err.code, err.message)
    }
    console.log(evt, payload)
  })
)

// 清理
disposers.forEach(off => off())

事件 ​

事件列表与触发时机 ​

推荐监听方式 ​

示例：收集关键事件 ​

事件

事件列表与触发时机

推荐监听方式

示例：收集关键事件