我之前在做iOS Swift项目时，也碰到过几乎一模一样的YouTube直播内嵌WebView的问题，折腾了好一阵子才搞定。结合我的实践经验，给你几个核心的排查和解决方向：

1. 检查YouTube iframe的嵌入参数（重中之重） #

iOS对媒体自动播放的限制非常严格，而且YouTube的iframe参数必须完全匹配才能生效：

• 必须添加 playsinline=1：这是内联播放的核心参数，没有它视频默认会强制全屏
• 必须添加 autoplay=1：明确开启自动播放触发逻辑
• 必须添加 mute=1：这是iOS系统的硬性要求——非静音的媒体内容无法自动播放，除非用户之前已经和WebView有过交互（比如点击过页面元素）
• 必须设置 allow 属性：明确授予autoplay、fullscreen等必要权限

正确的iframe示例：

<iframe 
  src="https://www.youtube.com/embed/你的直播ID?playsinline=1&autoplay=1&mute=1" 
  allow="autoplay; fullscreen; picture-in-picture"
  width="100%"
  height="300"
  frameborder="0"
></iframe>

2. 完善WebView的配置（兼容新旧iOS版本） #

你已经设置了部分参数，但要注意iOS 10+推荐使用新的API，建议用兼容写法覆盖全版本：

// 首先确保JavaScript开启，YouTube的播放逻辑完全依赖JS运行
localWebView.configuration.preferences.javaScriptEnabled = true

// 配置媒体播放权限：关闭用户手动触发要求
if #available(iOS 10.0, *) {
    localWebView.configuration.mediaTypesRequiringUserActionForPlayback = []
} else {
    localWebView.mediaPlaybackRequiresUserAction = false
}

// 强制开启内联播放支持
localWebView.allowsInlineMediaPlayback = true

// 如果需要画中画功能，也可以一并开启（可选）
localWebView.allowsPictureInPictureMediaPlayback = true

3. 排查网站的Content Security Policy (CSP) #

如果你的自有网站设置了CSP安全策略，很可能会拦截YouTube的媒体资源或自动播放行为。需要在CSP规则中添加：

• 允许YouTube的媒体源：media-src 'self' https://www.youtube.com https://*.youtube.com;
• 允许YouTube的脚本资源：script-src 'self' https://www.youtube.com https://*.youtube.com https://*.ytimg.com;
• 确保政策中没有限制autoplay的规则

4. 针对直播流的特殊处理 #

YouTube直播和普通视频的播放逻辑有差异，额外注意两点：

• 确保直播处于正在进行中的状态：如果直播还未开始，自动播放逻辑不会触发
• 可以尝试在WebView加载完成后，主动通过JS调用播放（作为兜底方案）：

// 页面加载完成后执行主动播放逻辑
localWebView.evaluateJavaScript("""
    const iframe = document.querySelector('iframe');
    if (iframe) {
        iframe.contentWindow.postMessage('{"event":"command","func":"playVideo","args":[]}', '*');
    }
""") { result, error in
    if let error = error {
        print("主动播放失败: \(error.localizedDescription)")
    }
}

5. iOS版本兼容性验证 #

不同iOS版本的WebKit对媒体播放的限制不同：

• iOS 14+：对跨域媒体的权限要求更严格，务必确保iframe的allow属性和WebView配置完全匹配
• iOS 13及以下：旧APImediaPlaybackRequiresUserAction仍然有效，但建议优先用新API做全版本兼容

按照上面的步骤逐一排查，应该能解决自动播放和内联播放的问题。我当时就是漏加了mute=1参数，折腾了半天😂

内容的提问来源于stack exchange，提问作者Seyyid Tiryaki