直接使用标签即可实现基础播放,无需JS或额外库;需提供浏览器支持的格式(如mp4),添加controls属性显示控件,注意autoplay限制、资源路径、MIME类型、CORS及本地file://协议问题。

用 标签实现基础播放模块
直接写 标签就能跑起来,不需要 JS 或额外库。浏览器原生支持,兼容性从 IE9+ 开始(mp4 格式),现代项目基本无门槛。
关键点在于:必须提供至少一种浏览器能解码的格式(推荐 mp4,H.264 + AAC);src 属性可直接写路径,也可以用 多格式 fallback:
<video controls width="640" height="360"><source src="demo.mp4" type="video/mp4"><source src="demo.webm" type="video/webm"> 您的浏览器不支持 video 标签。 </source></source></video>
注意:controls 是开关——不加就看不到播放/音量/进度条;autoplay 在多数移动端和 Chrome 77+ 会被静音拦截,不能依赖它自动响。
常见播放异常:黑屏、卡顿、报错 ERR_BLOCKED_BY_RESPONSE
不是代码写错了,大概率是资源加载问题:
-
src路径错误或文件不存在(检查浏览器 Network 面板里该请求是否返回 404) - 服务器没配好 MIME 类型,比如
.mp4返回了text/plain(Nginx 需确保有types { video/mp4 mp4; }) - 跨域资源没开
CORS(如视频放在 CDN 或另一域名,需服务端响应头含Access-Control-Allow-Origin: *) - 本地双击打开 HTML 文件(
file://协议)时,Chrome 会禁掉加载,必须起个本地服务(npx serve或 VS Code Live Server)
控制播放行为:用 JS 操作 play()、pause() 和事件
用户点击按钮触发播放、监听播放结束、静音自动播放等,都得靠 JS。但注意:所有 play() 调用必须由用户手势(click/tap)触发,否则会被浏览器拒绝并抛出 NotAllowedError。
典型写法:
const video = document.querySelector('video');
document.getElementById('playBtn').addEventListener('click', () => {
video.play().catch(e => console.warn('播放被阻止:', e));
});
常用事件:
-
loadedmetadata:元信息加载完成(可读取video.duration) -
timeupdate:播放时间变化(适合做进度条同步) -
ended:播放自然结束 -
error:加载失败(检查video.error码,如MediaError.MEDIA_ERR_NETWORK)
移动端适配与自动播放的现实约束
iOS Safari 和 Android Chrome 对自动播放极其严格:除非满足「用户交互后 + 静音」,否则 play() 必失败。所以不要试图绕过,而是接受这个事实:
- 去掉
autoplay,改用大尺寸播放按钮覆盖视频封面图(poster属性) - 首次点击时调用
video.muted = true; video.play(),再后续才允许用户点音量按钮取消静音 - 避免在
DOMContentLoaded或load事件里调用play(),毫无意义
另外,iOS 上 默认全屏播放(尤其竖屏时),加 webkit-playsinline playsinline 可启用内联模式,但需 App 配置或 iOS 10+ 且页面添加 才稳定生效。











