iOS Safari及WKWebView默认禁止有声视频自动播放，必须同时满足muted、playsinline和用户手势触发（或配置mediaTypesRequiringUserActionForPlayback）三条件；视频还须无音频轨、含关键帧且用H.264编码。
为什么 iOS 上 video 的 autoplay 属性总是不生效
iOS Safari（包括 WKWebView）从 iOS 10 起默认禁止有声音的视频自动播放，这是硬性策略，和 HTML 是否加 autoplay、muted、playsinline 都无关——除非满足静音前提。常见现象是：页面一打开视频黑屏、play() 报错 NotAllowedError: The request is not allowed by the user agent，或直接静音但不播放。
关键判断点：只要视频轨道含音频（哪怕音量为 0），且未显式声明 muted，iOS 就拒绝自动播放。
必须同时满足的三个条件才能触发自动播放
缺一不可，否则即使代码写对了也无效：
-
video元素必须设置muted属性（布尔值，不是字符串） -
video元素必须设置playsinline（否则全屏强制跳转，且 iOS 10+ 会禁播） - 调用
play()必须发生在用户手势（如click、touchend）触发的上下文中；但若已满足前两条，autoplay属性本身就能在页面加载时触发（无需手动play()）
示例正确写法：
立即学习“前端免费学习笔记（深入）”；
<video autoplay muted playsinline> <source src="video.mp4" type="video/mp4"> </video>
WKWebView 中自动播放失效的特殊处理
在 iOS 原生 App 内嵌 WKWebView 时，即使 HTML 写对了，仍可能失败，因为 WebView 默认禁用媒体自动播放策略：
- 必须在原生层开启允许自动播放：
configuration.mediaTypesRequiringUserActionForPlayback = [] - 如果使用
WKWebView初始化时未传入自定义WKWebViewConfiguration，需显式构造并配置 - 注意：该配置仅影响当前 WebView 实例，不能全局修改系统行为
Swift 示例片段：
let config = WKWebViewConfiguration() config.mediaTypesRequiringUserActionForPlayback = [] let webView = WKWebView(frame: .zero, configuration: config)
音频已静音但仍有“无声”请求被拒？检查编解码与元数据
即使加了 muted 和 playsinline，部分 MP4 视频仍无法自动播放，常见原因：
- 视频容器含隐藏音频轨（如 AAC 音频流未真正移除），可用
ffprobe video.mp4检查是否输出Stream #0:1(und): Audio - MP4 文件缺少关键帧（moov atom 在文件末尾），导致 iOS 无法快速解析并启动播放；用
ffmpeg -i in.mp4 -c copy -movflags +faststart out.mp4修复 - 某些 H.265（HEVC）编码在旧 iOS 版本上不被支持，优先用 H.264 编码
最稳妥做法：导出视频时彻底删除音频轨（而非仅静音），再用 faststart 优化。
