如何抑制AVPlayerViewController的布局错误？附使用代码示例

我来帮你解决AVPlayerViewController的布局错误问题，结合你给出的代码，咱们一步步来排查和修复：

首先，你当前的代码片段里，布局问题通常出在控制器的展示方式、容器视图约束配置，或者PlayerViewController的状态管理上，下面是针对性的解决办法：

1. 确保子控制器的正确添加流程（最常见的坑） #

如果你是把AVPlayerViewController作为子控制器嵌入到父视图里，一定要严格遵循iOS的子控制器生命周期规范，同时给视图设置正确的自动布局约束：

func play(url: URL, parent: UIViewController) { 
    let player = AVPlayer(url: url) 
    // 先清理之前的观察者（如果是复用全局playerController的话）
    if let oldPlayer = playerController.player {
        NotificationCenter.default.removeObserver(self, name: .AVPlayerItemDidPlayToEndTime, object: oldPlayer.currentItem)
    }
    // 添加新的播放完成监听
    NotificationCenter.default.addObserver(self, selector: #selector(didFinishPlaying(note:)), name: .AVPlayerItemDidPlayToEndTime, object: player.currentItem) 
    
    // 如果你是全局复用playerController，这里要重置状态；如果是临时创建就直接实例化
    let playerController = AVPlayerViewController()
    playerController.player = player 
    playerController.allowsPictureInPicturePlayback = false 
    playerController.showsPlaybackControls = true 
    playerController.delegate = self 

    // 关键：正确嵌入子控制器并设置约束
    parent.addChild(playerController)
    // 假设你有一个专门的容器视图来承载播放器，没有的话也可以直接用parent.view
    let containerView = UIView()
    parent.view.addSubview(playerController.view)
    // 必须禁用自动调整掩码，避免和自动布局冲突
    playerController.view.translatesAutoresizingMaskIntoConstraints = false
    // 给播放器视图设置铺满容器的约束
    NSLayoutConstraint.activate([
        playerController.view.topAnchor.constraint(equalTo: containerView.topAnchor),
        playerController.view.leadingAnchor.constraint(equalTo: containerView.leadingAnchor),
        playerController.view.trailingAnchor.constraint(equalTo: containerView.trailingAnchor),
        playerController.view.bottomAnchor.constraint(equalTo: containerView.bottomAnchor)
    ])
    // 完成子控制器生命周期绑定
    playerController.didMove(toParent: parent)

    player.play()
}

如果你是用present(_:animated:completion:)弹窗展示播放器，一定要确保在父控制器的视图已经加载完成后再调用（比如viewDidAppear方法里），避免视图层级未就绪导致的布局错乱。

2. 避免复用播放器时的状态污染 #

如果你的playerController是全局实例，每次播放前一定要重置状态：

• 移除旧的播放完成观察者
• 暂停旧播放器并置空
• 重置控制器的布局相关属性（比如showsPlaybackControls）

3. 解决自动布局冲突 #

如果控制台出现Unable to simultaneously satisfy constraints类的日志，可以这么处理：

• 给AVPlayerViewController的视图设置较低的约束优先级，或者调整父视图的约束规则，避免冲突
• 确保已经设置playerController.view.translatesAutoresizingMaskIntoConstraints = false，禁用系统自动调整的掩码
• 不需要自定义布局的话，直接用present方式展示，系统会自动处理全屏布局，基本不会有错误

4. 适配屏幕旋转（如果需要） #

如果你的APP支持屏幕旋转，要确保父控制器和AVPlayerViewController的旋转设置一致，避免旋转时布局错乱：

extension YourPlayerManager: AVPlayerViewControllerDelegate {
    func playerViewControllerShouldAutorotate(_ playerViewController: AVPlayerViewController) -> Bool {
        return true // 根据你的业务需求调整
    }
    
    func playerViewControllerSupportedInterfaceOrientations(_ playerViewController: AVPlayerViewController) -> UIInterfaceOrientationMask {
        return .all // 或者指定你需要的方向，比如.portrait
    }
}

最后，别忘了在合适的时机移除观察者，比如在管理器的deinit方法里：

deinit {
    NotificationCenter.default.removeObserver(self)
}

内容的提问来源于stack exchange，提问作者Gardner von Holt