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不会持续触发。 - 切源时会重置状态,如需追踪请重新订阅或检查当前源。