首页背景视频在安卓上自动播,iPhone 上是一片黑。iOS 16.7 的 Safari 控制台报 NotAllowedError: The request is not allowed by the user agent,muted 和 autoplay 两个属性明明都写了。
先确认属性真的落到 DOM 上。项目用 ReaCt 渲染,muted 属于受控属性,写在 JSX 里不会反映到元素上,得用 ref 手动赋 video.muted = true。这个差异在桌面 Chrome 上看不出来,那边策略松,所以一直没暴露。
<video id="v" muted playsinline webkit-playsinline
preload="auto" src="/media/bg.mp4"></video>
<script>
const v = document.getElementById("v");
v.muted = true;
v.play().catch((err) => {
console.warn("autoplay blocked", err.name);
v.controls = true;
});
</script>
补上 muted 之后还是不行,换一台 iOS 17 的手机却能播。差别在那台 16.7 的机器开着低电量模式,系统会拦掉所有自动播放,静音视频也不例外,设置里没有任何说明。这个坑查了快两个小时。
playsinline 也别漏。不写这个属性,iOS 会强制全屏播放,视觉上跟没播一样。webkit-playsinline 是给老版本留的,一起写不亏。
play() 返回 Promise,一定要接 catch。被拦时 err.name 是 NotAllowedError,属于策略拒绝;加载被打断是 AbortError,两者处理方式完全不同。我的做法是失败就把 controls 打开,让用户自己点一下。
安卓微信内置浏览器是另一套脾气,X5 内核上 autoplay 只在页面可见时生效,切后台再回来会停。监听 visibilitychange 重新 play 一次,比在 onload 里死等靠谱。
最后在低电量那台机器复测,仍然不自动播,但封面图和播放按钮都在,点了能播。这个结果可以接受,视频只是装饰,不值得为了它去骗用户手势。
