javascript如何操作音频和视频_有哪些常用的媒体控制API?

JavaScript 通过 HTMLMediaElement 接口实现音视频控制,支持 play()、pause()、currentTime 等基础操作,配合 loadedmetadata、timeupdate 等事件及 playbackRate、pictureInPicture 等进阶功能。

JavaScript 操作音视频主要通过 HTMLMediaElement 接口( 元素的基类)实现,浏览器原生提供了一套稳定、跨平台的媒体控制 API,无需额外库即可完成播放、暂停、音量调节、时间跳转等核心操作。

基础播放控制 API

这些是最常用、最直接的控制方法:

  • play():开始或恢复播放;可能返回 Promise(尤其在需用户交互触发时),需处理拒绝情况
  • pause():暂停当前播放
  • load():重载媒体资源(例如切换 src 后调用,确保元数据更新)
  • canPlayType(type):检查浏览器是否支持某 MIME 类型(如 "video/mp4"),返回 "probably""maybe" 或空字符串

状态与属性读写

通过属性实时获取或设置播放状态和参数:

  • currentTime:获取或设置当前播放时间(单位:秒),常用于进度条同步或跳转
  • duration:媒体总时长(秒),注意加载初期为 NaN,需监听 loadedmetadata 事件后才可用
  • pausedendedreadyState:判断播放状态(如 readyState === 4 表示已可播放)
  • volume:音量值(0.0–1.0),设为 0 即静音;配合 muted 属性更可靠地实现静音切换
  • playbackRate:设置播放速率(如 0.52.0),支持倍速播放

关键事件监听

响应用户操作或媒体生命周期变化:

  • play / pause:播放或暂停时触发
  • timeupdate:播放时间变化时频繁触发(适合更新进度条)
  • loadedmetadata:元数据(时长、尺寸等)加载完成
  • canplay / canplaythrough:表示可开始播放 / 可连续播放不卡顿
  • error:加载或解码失败时触发,可通过 error.code 判断具体错误类型

进阶能力与注意事项

部分功能需结合现代 API 或注意兼容性:

  • 自动播放策略:多数浏览器禁止无用户交互的音频自动播放(autoplay 失效),建议用 play().catch(e => console.log("自动播放被阻止")) 容错
  • 画中画(Picture-in-Picture):通过 videoElement.requestPictureInPicture() 触发,需用户手势启动
  • 全屏控制:使用 requestFullscreen()(注意各浏览器前缀差异),配合 fullscreenchange 事件监听状态
  • 音轨与字幕:通过 video.textTracksvideo.audioTracks 管理轨道,支持动态启用/禁用