iOS屏幕录制时YouTube视频黑屏及WebView加载异常问题求助

我之前在做iOS屏幕录制+WebView播放YouTube的功能时，也踩过几乎一模一样的坑！给你梳理几个实际有效的排查和解决方向：

一、先解决YouTube画面黑屏的核心问题 #

黑屏大概率是因为YouTube在iOS上的播放依赖硬件加速渲染，而系统录屏API默认抓不到硬件加速层的内容：

• 强制WebView使用软件渲染（牺牲一点性能换兼容性）：
  调整WKWebViewConfiguration的参数，关闭部分硬件加速相关的配置，让WebView的内容走软件渲染通道，这样录屏就能正常捕获画面了：

  let webConfig = WKWebViewConfiguration()
  webConfig.allowsInlineMediaPlayback = true
  webConfig.mediaTypesRequiringUserActionForPlayback = []
  // 关闭WebGL硬件加速，强制软件渲染
  webConfig.preferences.setValue(true, forKey: "webkitWebGLEnabled")
  let webView = WKWebView(frame: view.bounds, configuration: webConfig)
  

• 换用ReplayKit而非AVCaptureScreenInput：
  如果你之前用的是AVCaptureScreenInput做录屏，试试系统的ReplayKit框架，它对系统级的硬件加速内容捕获支持更好，尤其是媒体播放场景。初始化RPScreenRecorder时记得提前申请权限。

二、解决WebView传入录制逻辑后加载停滞的问题 #

把WebView传入录制逻辑后出现加载环，基本是主线程阻塞或者生命周期被干扰导致的：

• 所有WebView操作必须在主线程执行：
  录屏逻辑大概率会在后台线程跑，如果不小心在非主线程刷新或操作WebView，就会导致加载停滞。务必把WebView的加载、刷新操作包在主线程里：

  DispatchQueue.main.async {
      self.webView.reload()
      // 或者重新加载YouTube链接
      self.webView.load(URLRequest(url: youtubeURL))
  }
  

• 避免强引用导致的WebView生命周期异常：
  如果录制逻辑里强持有了WebView，会导致WebView无法正常响应系统的加载回调。改成弱引用持有：

  // 在录制逻辑类里用弱引用存WebView
  weak var targetWebView: WKWebView?
  
  // 初始化时传入
  func setupRecording(with webView: WKWebView) {
      self.targetWebView = webView
  }
  
  // 使用时先判断是否存在
  if let webView = targetWebView {
      // 执行相关操作
  }
  

• 调整权限申请顺序：
  先完成录屏权限的申请，再初始化WebView并加载YouTube视频。如果先加载视频再弹权限申请，会中断WebView的媒体加载会话，导致后续一直卡在加载环。

额外建议：试试YouTube官方SDK #

如果上述方法都不太行，推荐换用YouTubeiOSPlayerHelper官方SDK来播放视频，它专门针对iOS平台做了优化，对屏幕录制的兼容性比WebView好很多，能从根源上避免硬件加速层的捕获问题。

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