微信H5视频不能自动播放是因浏览器策略限制：iOS需静音且用户交互触发，Android部分机型连静音也不行；autoplay+muted在X5内核下常失效，因播放须在用户手势后500ms内触发；稳定方案是用uni.createVideoContext绑定点击事件并$nextTick调用play()。
微信H5里视频不能自动播放，不是你代码写错了，而是浏览器策略卡死的——iOS必须静音+用户交互触发，Android部分机型连静音都不行。靠autoplay和muted属性硬上，90%会失败。
为什么autoplay + muted在微信里经常失效
微信X5内核对“自动播放”的判定比标准浏览器更严：它不仅看HTML属性，还会检查播放时机是否发生在用户手势（click/touchstart）之后的500ms窗口期内。单纯页面加载时设置autoplay，哪怕加了muted，iOS微信直接忽略；Android则可能因网络类型（4G下更保守）或内核版本随机拒绝。
- 常见错误现象：
video元素渲染完成但play()抛出DOMException: The request is not allowed by the user agent - 使用场景：首页开场视频、活动页引导动效、监控类H5的预览流
- 关键差异：iOS要求
play()必须由用户事件回调同步触发；Android部分机型允许延迟调用，但不能超过1秒
必须用uni.createVideoContext + 手动play()
绕过HTML属性限制，用uni-app提供的原生上下文控制播放，是目前最稳定的做法。但要注意：不能在onLoad或onShow里直接调，必须绑定到用户点击动作上。
ReadGZH -- 微信公众号文章 AI 阅读器
下载
让 AI 读懂微信公众号。自研 7 阶段提取管道，穿透反爬率 99.89%，Token 消耗降低 50%–87%。支持 ChatGPT、Claude、Perplexity、Gemini 等平台无缝引用。
- 把播放逻辑放在按钮
@click或封面图@touchstart里，哪怕这个动作只是“显示视频容器” -
video标签要提前挂载（v-if设为true），但src可延迟赋值，避免预加载浪费流量 - 调用
play()前加this.$nextTick，确保DOM已更新 - 示例：
onReady() { this.videoContext = uni.createVideoContext('myVideo', this) }, handlePlayClick() { this.$nextTick(() => { this.videoContext.play() }) }
多视频页面切换时的坑：iOS第二个视频播不了
iOS微信有个隐藏机制：同一WebView实例中，首个video持续占用媒体资源，后续video即使满足条件也无法触发播放。这不是bug，是WebKit的资源锁策略。
- 常见错误现象：从首页跳转到详情页，第二个视频始终黑屏或报错
- 解决方案不是停止第一个视频，而是重置WebView上下文——用
window.location.reload()强制刷新目标页 - 不要用
uni.navigateTo后直接play()，要在新页面onReady里再等一次用户交互 - 如果必须单页多视频，每次切换前手动调用
this.videoContext.pause()并清空src，再重新赋值
微信JS-SDK不是万能钥匙，但能提升成功率
初始化jweixin.config本身不提供播放权限，但它能让微信环境识别你的页面“可信”，从而放宽部分策略限制（尤其在Android X5内核上）。不配它，成功率直接掉30%以上。
- 签名用的
url必须是当前页面完整URL，且不含#及后面hash部分 -
jsApiList里不用填播放相关接口，但config失败会导致ready事件不触发，整个流程卡死 - 调试时
debug: true必须开启，否则看不到签名失败的具体原因 - 注意：
jweixin-module包要npm安装，不能直接引入官方jsapi文件，uni-app里会冲突
真正麻烦的从来不是怎么写那几行play()，而是判断“此刻能不能播”——iOS要等点击，Android要看网络，微信还要验签名。所有方案都得围绕“用户交互”这个锚点展开，任何脱离它的优化都是空中楼阁。
