微信内置浏览器中play()需用户手势触发，安卓必须监听WeixinJSBridgeReady后调用并捕获Promise错误，iOS需muted+autoplay+playsinline；格式推荐MP4/H.264/AAC，必加muted、playsinline、x5-video-player-type属性。
play() 在微信内置浏览器里能用，但大概率静默失败
能调，不等于能播。微信（尤其是安卓版）对 play() 施加了严格的用户手势触发限制：没经过用户真实点击/触摸，直接 JS 调用 play() 会抛 NotAllowedError 或完全无反应——这不是 bug，是策略。
- iOS 微信相对宽松，只要
muted+autoplay+playsinline三者齐备，且页面加载后立即调用，有一定概率成功 - 安卓微信几乎 100% 拦截首次 JS 自动播放，哪怕加了
muted，也必须等WeixinJSBridgeReady事件后再试 -
play()返回的是 Promise，记得.catch(e => console.log(e))，否则错误被吞掉，你根本不知道它挂了
必须监听 WeixinJSBridgeReady 才有机会播
这是安卓微信里绕过 autoplay 限制的唯一可靠入口。它本质是微信注入的全局桥接对象就绪信号，不是标准 API，不能用 DOMContentLoaded 或 load 替代。
- 必须在
或元素已插入 DOM、src已设好、且处于muted状态下监听 - 监听后应立刻调用
play()，并移除监听器防止重复触发 - 部分旧版 Yixin（易信）也需兼容
YixinJSBridgeReady，但当前已基本可忽略
document.addEventListener('WeixinJSBridgeReady', () => {
const video = document.getElementById('myVideo');
if (video && video.paused) {
video.play().catch(e => console.warn('Play failed:', e));
}
}, { once: true });
格式支持和属性组合比函数本身更重要
play() 不决定能不能播，真正卡脖子的是容器格式、编码、以及 HTML 属性是否满足微信“信任链”。光写 video.play() 没用，得先让浏览器觉得“这视频可以放”。
- 推荐用
.mp4容器 + H.264 Baseline/Main Profile 视频 + AAC-LC 音频；WebM/VP9 在安卓微信里支持不稳定 - 必加属性：
muted（静音）、playsinline（iOS 小窗）、x5-video-player-type="h5"（安卓强制 H5 播放器） - 避免依赖
preload="auto"，微信里常被忽略；改用preload="metadata"更稳妥
Vue/React 项目里容易漏掉的时机问题
框架的异步渲染节奏会让 play() 调用过早：DOM 还没挂载完、src 还没绑定、甚至元素还没生成，你就去 el.play() —— 必然失败。
- Vue 中不要在
mounted立即调play()，加个this.$nextTick(() => el.play()) - React 中用
useEffect，且确保 ref 已绑定、src已设置完成，再调用 - 更保险的做法：监听
canplaythrough事件，在它触发时再play()，同时兜底WeixinJSBridgeReady
最麻烦的不是怎么写，而是微信不同版本、不同机型、不同网络环境下的行为差异——建议把 play() 当作“尽力而为”，失败后提供一个显眼的手动播放按钮，别硬刚。
