iOS中YouTubePlayer加载及转屏时白视图问题解决方案咨询

针对YouTubePlayer加载&横竖屏切换白视图的解决方案 #

兄弟，我之前在集成YouTubePlayer的时候也踩过一模一样的白屏坑！结合你已经试过的操作，给你几个亲测有效的解决方案：

1. 解决加载阶段的就绪前白屏 #

除了单纯设置背景色，最稳妥的方式是给播放器加一个占位过渡视图，在播放器完全就绪前显示（可以放加载动画、视频封面图或者深色背景），等播放器准备好再隐藏：

• 第一步：在Storyboard里给YouTubePlayer的容器加一个UIView作为占位视图（和播放器视图重叠），关联IBOutlet命名为placeholderView，给它设置深色背景或者加载动画。
• 第二步：监听播放器的就绪状态，回调时隐藏占位：

import YouTubePlayer

class YourViewController: UIViewController, YouTubePlayerDelegate {
    @IBOutlet weak var playerView: YouTubePlayerView!
    @IBOutlet weak var placeholderView: UIView!

    override func viewDidLoad() {
        super.viewDidLoad()
        playerView.delegate = self
        // 初始显示占位视图
        placeholderView.isHidden = false
        placeholderView.backgroundColor = .black // 和深色主题匹配
    }

    // 播放器就绪时触发
    func playerReady(_ videoPlayer: YouTubePlayerView) {
        placeholderView.isHidden = true
    }

    // 也可以监听播放状态，比如开始播放后再隐藏
    func playerStateChanged(_ videoPlayer: YouTubePlayerView, playerState: YouTubePlayerState) {
        if playerState == .playing {
            placeholderView.isHidden = true
        }
    }
}

2. 解决横竖屏切换时的白视图 #

这个问题大多是旋转时布局重绘延迟、容器视图背景未同步或者约束失效导致的，试试这几个方法：

• 方法一：旋转时强制同步背景色并刷新布局
  在ViewController里重写旋转回调，确保播放器和容器的背景色及时更新，同时强制布局：

override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
    super.viewWillTransition(to: size, with: coordinator)
    coordinator.animate(alongsideTransition: { _ in
        // 强制设置播放器及其父视图的背景色
        self.playerView.backgroundColor = .black
        self.playerView.superview?.backgroundColor = .black
        // 强制刷新布局，避免留白
        self.playerView.setNeedsLayout()
        self.playerView.layoutIfNeeded()
    }, completion: nil)
}

• 方法二：检查并修正Auto Layout约束
  确保YouTubePlayer的约束是leading/trailing/top/bottom完全绑定父视图，没有设置固定宽高，这样旋转时能自动铺满容器，不会出现空隙。同时把playerView.clipsToBounds = true，防止子视图溢出留白。

3. 优化你尝试的Dark主题设置 #

如果用theme: "dark"没生效，检查一下playerVars的设置格式是否正确，并且确保在视图布局完成后再加载视频：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    let playerVars: [String: Any] = [
        "theme": "dark",
        "color": "white",
        "playsinline": 1, // 适配移动端内联播放
        "disablekb": 1 // 可选：禁用键盘，减少布局变动
    ]
    playerView.loadVideoID("your_video_id_here", playerVars: playerVars)
}

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