17370845950

video标签需用source多格式fallback（如mp4+webm）并设muted、playsinline才能移动端自动播放；poster失效常因路径错、尺寸不匹配或MIME类型错误；play()须在用户手势中调用且处理跨域与Promise异常。

video 标签必须包含 src 或 source 才能播放

很多旧项目直接把 Flash 的 .swf 路径塞进 ，结果页面空白—— 不解析 Flash，只支持原生视频格式。浏览器会静默失败，控制台也不报错，容易误判为“样式遮挡”或“JS 未执行”。

正确做法是提供至少一种浏览器支持的编码格式：

• H.264 + AAC（.mp4）：Safari、Chrome、Edge 全支持，iOS/iPadOS 必须用这个
• VP9 + Opus（.webm）：Firefox、Chrome、Edge 支持，压缩率高，但 iOS 完全不认
• AV1（.mp4 或 .mkv）：新标准，Chrome 109+、Firefox 110+ 支持，体积更小，但兼容性仍弱

单靠一个 mp4 文件无法覆盖所有设备，必须用 多格式 fallback：

autoplay 在移动端默认被禁用，且需满足静音条件

加了 autoplay 属性却没自动播？这不是 bug，是浏览器策略。iOS Safari 和 Android Chrome 要求同时满足：

• muted 属性存在（哪怕视频本身没声音，也得显式写上）
• playsinline 存在（防止 iOS 强制全屏）
• 用户已与页面有过交互（如点击），否则首次加载仍可能被拦截

常见错误写法： —— 这在 iPhone 上必然失败。正确写法：

注意：muted 是布尔属性，不能写成 muted="false"，写了就等价于 true。

poster 图片不显示？检查路径、尺寸和 MIME 类型

poster 属性指定首帧占位图，但经常出现“空白+黑边”或完全不渲染。原因通常是：

• 图片路径 404（尤其用相对路径时，poster="img/thumb.jpg" 在子目录页可能失效）
• 图片尺寸远大于 容器，又没设 object-fit: cover，导致裁剪异常
• 服务器返回的图片 MIME 类型不是 image/jpeg 或 image/png（比如 Nginx 默认对无扩展名文件返回 text/plain）

建议统一用 .jpg 或 .png 扩展名，并在 CSS 中加固显示逻辑：

video {
  width: 100%;
  height: 300px;
  object-fit: cover;
}
video::before {
  content: "";
  position: absolute;
  background: #000;
}

自定义控件时，play() 调用失败多数因跨域或用户手势缺失

想用按钮触发播放？别直接写 video.play()。现代浏览器要求：

• 调用必须发生在用户手势事件内（click、touchstart，不能是 setTimeout 或 Promise

  

  .then）
• 若视频跨域（如 CDN 域名不同），需服务端返回 Access-Control-Allow-Origin: *，否则 play() 抛 DOMException: The request is not allowed by the user agent
• 部分安卓 WebView 对 play() 返回 Promise，需 .catch(e => console.warn(e)) 避免未捕获异常

安全写法示例：

播放

真正麻烦的不是语法，是每个平台对“可播放”的定义不同：iOS 要静音，Android 要用户点过，桌面 Chrome 允许有声自动播但仅限用户最近交互过的标签页。适配的本质，是接受这些限制，而不是绕过它们。