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事件后才可用 -
paused、ended、readyState:判断播放状态(如readyState === 4表示已可播放) -
volume:音量值(0.0–1.0),设为 0 即静音;配合muted属性更可靠地实现静音切换 -
playbackRate:设置播放速率(如0.5、2.0),支持倍速播放
关键事件监听
响应用户操作或媒体生命周期变化:
媒体包提供了可管理各种媒体类型的类。这些类可提供用于执行音频和视频操作。除了基本操作之外,还可提供铃声管理、脸部识别以及音频路由控制。本文说明了音频和视频操作。 本文旨在针对希望简单了解Android编程的初学者而设计。本文将指导你逐步开发使用媒体(音频和视频)的应用程序。本文假定你已安装了可开发应用程序的Android和必要的工具,同时还假定你已熟悉Java或掌握面向对象的编程概念。感兴趣的朋友可以过来看看
立即学习“Java免费学习笔记(深入)”;
-
play/pause:播放或暂停时触发 -
timeupdate:播放时间变化时频繁触发(适合更新进度条) -
loadedmetadata:元数据(时长、尺寸等)加载完成 -
canplay/canplaythrough:表示可开始播放 / 可连续播放不卡顿 -
error:加载或解码失败时触发,可通过error.code判断具体错误类型
进阶能力与注意事项
部分功能需结合现代 API 或注意兼容性:
-
自动播放策略:多数浏览器禁止无用户交互的音频自动播放(
autoplay失效),建议用play().catch(e => console.log("自动播放被阻止"))容错 -
画中画(Picture-in-Picture):通过
videoElement.requestPictureInPicture()触发,需用户手势启动 -
全屏控制:使用
requestFullscreen()(注意各浏览器前缀差异),配合fullscreenchange事件监听状态 -
音轨与字幕:通过
video.textTracks和video.audioTracks管理轨道,支持动态启用/禁用










