1. 为什么浏览器禁止自动播放?
改善用户体验,节省用户流量。参考:
- Autoplay policy in Chrome
- Autoplay guide for media and Web Audio APIs
- Auto-Play Policy Changes for macOS
2. 自动播放策略
2.1 策略概述
- 视频:大部分情况允许视频静音自动播放,但
- iOS 低电量模式下,不允许自动播放;
- iOS 微信浏览器,不允许自动播放;
- ...(其他 case 欢迎补充)
- 音频:始终不允许自动播放音频。
2.2 如何捕获自动播放失败?
可以查看 play()
方法的 promise 状态,判断自动播放是否被阻止。
media.play().catch((e) => {
if (e.name === "NotAllowedError") {
// 自动播放被阻止
}
});
3. 如何应对自动播放策略?
3.1 规避方案
允许麦克风/摄像头权限
如果当前页面有麦克风/摄像头权限,浏览器允许自动播放。(可能这也是一种用户交互)
await navigator.mediaDevices.getUserMedia({ audio: true, video: true });
await media.play();
微信浏览器
微信浏览器有 WeixinJSBridge
,提供了类似用户交互的接口。
if (window.WeixinJSBridge) {
window.WeixinJSBridge.invoke?.("getNetworkType", {}, () => media.play()); // 恢复播放
}
document.addEventListener("WeixinJSBridgeReady", () => {
media.play(); // 恢复播放
window.WeixinJSBridge?.invoke?.("getNetworkType", {}, () => media.play()); // 恢复播放
});
Android 微信浏览器
- Android 微信浏览器不允许 HTMLAudioElement 自动播放,但允许 AudioContext 自动播放。
const audioContext = new AudioContext();
if (audioContext.state === "running") {
const source = audioContext.createMediaElementSource(media);
source.connect(audioContext.destination);
return audioContext.resume();
}
- Android 微信浏览器不允许 video.src 自动播放,但允许 video.srcObject 自动播放。(可能是 WebRTC 友好)
媒体互动指数(MEI)
浏览器自动计算,开发者无法干预。即该用户是否经常在网站上使用媒体,详见 Media Engagement Index
3.2 恢复播放
用户交互
绑定全局的 click
or mousemove
等事件,恢复自动播放失败的媒体标签。
- 特别注意,用户交互在 iOS 环境中要求严格,必须要在事件回调中同步执行
play()
才允许播放。 - 而在其他浏览器环境中,只需要用户与 当前域 有过交互,后续均可自动播放。(比如
window.open()
打开同样域的页面)
// 部分 iOS 设备中无法自动播放
document.addEventListener("click", () => {
Promise.then(() => media.play());
});
// iOS 中必须要同步执行 play
document.addEventListener("click", () => media.play());