设置视图匹配无效：YouTubePlayerView仅播音频无画面

问题根源 #

你遇到的核心问题是视图层级管理错误：

• 你的playerView是通过IBOutlet关联到Storyboard/XIB的视图，它已经被自动添加到当前控制器的视图层级里。
• 当你执行playerView = Djay.shared.youTubePlayer时，只是把代码里的playerView变量指向了共享播放器实例，但这个共享实例并没有被添加到当前控制器的视图树中——它仅在内存中运行（所以能播放音频），但没有被渲染到屏幕上，自然看不到画面。
• 你设置的Djay.shared.youTubePlayer.frame = playerView.frame只是修改了共享播放器的尺寸，却漏掉了“添加到视图”这个关键步骤。

修复方案 #

如果你必须使用共享的YouTubePlayerView实例实现后台播放，不要直接替换IBOutlet变量，而是手动管理视图层级：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 1. 移除原来通过IBOutlet关联的视图（我们要替换成共享实例）
    playerView.removeFromSuperview()
    
    // 2. 获取共享播放器实例并配置基础属性
    let sharedPlayer = Djay.shared.youTubePlayer
    sharedPlayer.frame = playerView.frame // 复用原来的位置和尺寸
    sharedPlayer.delegate = self
    
    // 3. 把共享播放器添加到当前控制器的视图层级中
    view.addSubview(sharedPlayer)
    
    // 4. 常规播放器设置保持不变
    let playerVars = ["controls": "1", "playsinline": "1", "autohide": "1", "showinfo": "1", "autoplay": "1", "fs": "1", "rel": "0", "loop": "0", "enablejsapi": "1", "modestbranding": "1"]
    sharedPlayer.playerVars = playerVars as YouTubePlayerView.YouTubePlayerParameters
    sharedPlayer.loadVideoID("\(Djay.shared.songs[0].songId!)")
    
    // 其他原有代码无需修改
    NotificationCenter.default.addObserver(self, selector: #selector(appEnteredBackgound), name: Notification.Name.UIApplicationDidEnterBackground, object: nil)
    view.addSubview(activity)
    activity.center = sharedPlayer.center
    activity.hidesWhenStopped = true
    activity.activityIndicatorViewStyle = .gray
    activity.startAnimating()
}

额外注意点 #

• 确保Djay.shared.youTubePlayer没有被其他视图控制器持有并添加到别的视图层级里——一个UIView实例同一时间只能属于一个父视图，重复添加会导致显示异常。
• 如果你不需要跨控制器共享播放器，其实可以保留原来的IBOutlet写法，只需要配置后台播放的音频会话权限（比如在AppDelegate或当前控制器中设置AVAudioSession的类别为.playback），也能实现后台播放音频的需求，这样就不会出现视图显示问题。

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