17370845950

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()）

示例正确写法：

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 优化。