现象
活动页放了背景视频,写了 autoplay、muted、loop、playsinline 四个属性,桌面端能自动播放,iOS 上一直黑屏。控制台报 NotAllowedError: play() failed because the user didn't interact with the document first,安卓部分机型也是同样的报错。
原因
浏览器都有自动播放策略:有声视频必须由用户手势触发,静音视频才允许自动播放。iOS 还要求 playsinline 才内联播放,否则会全屏接管。用 JS 调 play() 返回的是 Promise,失败时抛出 NotAllowedError,不 catch 就会在控制台留下未处理异常。
解决步骤
第一步,属性写全,并用 Promise 兜底。失败时不要反复重试,先显示封面图,再绑定首次点击或触摸事件触发播放。
const video = document.querySelector(".bg-video");
video.muted = true;
video.playsInline = true;
const p = video.play();
if (p) {
p.catch(() => {
poster.classList.add("show");
bindFirstTapToPlay(video);
});
}
第二步,检查视频编码。Safari 对 H.265 和部分封装支持有限,统一转成 H.264 加 AAC 的 mp4,并把 moov 盒子移到文件头部,首帧才出得快,否则要等整个文件下载完。
第三步,注意低电量模式。iOS 开启低电量模式时会禁止自动播放,这是系统级限制,前端只能展示封面和播放按钮,不要把它当成代码 bug 反复排查。
验证
在 iOS 低电量模式下打开页面,确认看到的是封面而不是黑屏,点一下能播放;再用 Chrome 无痕窗口测试静音自动播放是否正常,两种场景都通过才算兼容到位。
小结
自动播放失败多半是策略限制,不是属性没写。静音加 playsinline 是基础,Promise catch 加首次手势补播是兜底,编码统一成 H.264 才能覆盖全部机型。
