必须在用户手势回调中调用play()并捕获Promise失败,pause()可随时调用;currentTime单位为秒但受缓冲和关键帧影响;volume(0–1)、muted(推荐静音)、playbackRate(影响音调)可实时修改;应监听loadedmetadata、timeupdate、ended等事件而非轮询。

怎样用 play() 和 pause() 控制播放状态
直接调用 play() 或 pause() 是最基础的控制方式,但现代浏览器对自动播放有严格限制:没有用户手势(如点击)触发时,play() 很可能被拒绝并抛出 NotAllowedError。
- 必须在用户交互回调中调用,例如
button.addEventListener('click', () => video.play()) -
play()返回 Promise,应始终用.catch()捕获失败:video.play().catch(e => console.warn('播放失败:', e.name)); -
pause()不返回 Promise,可随时调用,但若元素尚未加载完成,调用后状态仍为paused,实际暂停时机取决于加载进度
如何读取和设置播放进度(currentTime)
currentTime 单位是秒,支持小数,但受媒体缓冲和编码关键帧影响,设置后不一定精确跳转到该时间点。
- 读取当前播放位置:
const sec = video.currentTime; - 设置播放位置:
video.currentTime = 120.5;(跳到第 120.5 秒) - 设置前建议检查
video.readyState >= HTMLMediaElement.HAVE_FUTURE_DATA,否则可能无效或触发重新加载 - 频繁设置
currentTime(如拖拽进度条)时,应防抖,避免连续 seek 导致卡顿或请求风暴
音量、静音与播放速率怎么改(volume、muted、playbackRate)
这三个属性可实时修改,但行为有差异:
-
volume取值范围是0.0到1.0,设为0不等于静音——仍可能有音频输出(取决于系统),推荐优先用muted -
muted = true会真正屏蔽所有音频输出,且不受系统音量影响,适合“一键静音”场景 -
playbackRate默认为1.0,可设为0.5(慢放)或2.0(快放),但部分浏览器对非标准倍率(如1.75)支持不稳定,且会影响音调(除非启用preservesPitch: false的 Web Audio 处理) - 修改这些属性不会触发
canplay等事件,但可能触发ratechange(playbackRate)或volumechange(其他两个)
监听加载与播放状态变化(loadedmetadata、timeupdate、ended)
靠轮询判断状态既低效又不可靠,应使用原生事件。关键事件不是全都有默认冒泡行为,注意绑定时机。
立即学习“Java免费学习笔记(深入)”;
-
loadedmetadata:元数据(宽高、时长等)加载完成时触发,此时duration才可靠,适合初始化进度条最大值 -
timeupdate:播放过程中高频触发(通常每 200–250ms 一次),适合更新进度条 UI;但不要在里面做重操作,避免阻塞渲染 -
ended:自然播放完毕时触发,注意它不会在loop = true时触发 - 监听前确认元素已挂载 DOM,否则事件绑定无效;若动态替换
src,需手动移除旧监听器再重新绑定
play() 的 Promise 拒绝不报错但也不提示,不加 .catch() 就会静默失败;还有 currentTime 设置后立即读取,可能还是旧值——得等 seeking → seeked 流程走完才真正就位。**











