Skip to content

FAQ

为什么无法播放?

  • 检查地址是否可直连(CORS、鉴权)。
  • 确认格式被支持:mp4/webm/ogg/audio、HLS(.m3u8)、DASH(.mpd)、FLV、MPEG-TS、torrent。
  • 浏览器自动播放限制:调用 play() 建议 await 并在用户手势后触发,或设置 muted: true

切源的正确方式?

  • 使用 await player.setSource(newSrc),不要直接改 <video>src
  • 切源后会自动重置播放状态与错误状态;失败触发 sourcechange-failed

destroy 什么时候调用?

  • React/Vue 组件卸载时必须 player.destroy()
  • 长时间不用、要彻底释放资源或更换 <video> 元素时调用。

事件为什么没触发?

  • 确认使用了 player.on 而非原生 addEventListener
  • 高频事件已合帧,仅在状态变化时触发;如果视频未播放,timeupdate 不会持续触发。
  • 切源时会重置状态,如需追踪请重新订阅或检查当前源。
最近更新

基于 MIT 许可证发布