如何让AVPlayerViewController与AVPictureInPictureController协同工作？

问题核心原因 #

你遇到的isPictureInPictureActive返回false、控制方法失效的问题，本质是AVPlayerViewController本身已经内置了一个AVPictureInPictureController实例，你手动创建的第二个控制器会和它的内部实例产生冲突，导致状态不同步、控制失效。

解决方案 #

根据你的需求（回到应用时画面返回原视图），分两种场景处理：

场景1：直接使用AVPlayerViewController内置的PiP功能（推荐） #

放弃手动创建AVPictureInPictureController，直接利用AVPlayerViewController的原生PiP支持，这样状态和控制逻辑会自动同步：

// 初始化AVPlayerViewController
let playerVC = AVPlayerViewController()
playerVC.player = yourAVPlayer
// 开启内置PiP支持
playerVC.allowsPictureInPicturePlayback = true
// 设置代理
playerVC.delegate = self

// 实现AVPlayerViewControllerDelegate代理方法，处理PiP结束后的逻辑
extension YourViewController: AVPlayerViewControllerDelegate {
    func playerViewController(_ playerViewController: AVPlayerViewController, didStopPictureInPictureWith stopReason: AVPlayerViewController.PictureInPictureStopReason, error: Error?) {
        // 当PiP停止（比如从后台返回应用），将画面切回原视图
        view.addSubview(playerVC.view)
        playerVC.view.frame = view.bounds
        playerVC.didMove(toParent: self)
    }
}

场景2：必须自定义AVPictureInPictureController #

如果一定要手动管理PiP控制器，必须先禁用AVPlayerViewController的内置PiP功能，确保只有一个控制器在工作：

// 第一步：禁用AVPlayerViewController的内置PiP
videoController.allowsPictureInPicturePlayback = false

// 第二步：正确初始化自定义PiP控制器（确保在主线程执行）
if AVPictureInPictureController.isPictureInPictureSupported() {
    DispatchQueue.main.async {
        self.pipController = AVPictureInPictureController(playerLayer: self.playerLayer)
        self.pipController?.delegate = self
        // 监听PiP激活状态变化
        self.pipActiveObservation = self.pipController?.observe(\.isPictureInPictureActive, options: [.initial, .new]) { [weak self] _, change in
            guard let isActive = change.newValue else { return }
            print("PiP 激活状态：\(isActive)")
            if !isActive {
                // PiP停止，恢复原视图
                self?.restoreVideoView()
            }
        }
    }
}

// 实现AVPictureInPictureControllerDelegate代理方法
extension YourViewController: AVPictureInPictureControllerDelegate {
    func pictureInPictureControllerDidStopPictureInPicture(_ pictureInPictureController: AVPictureInPictureController) {
        // PiP停止时的视图恢复逻辑
        restoreVideoView()
    }
    
    private func restoreVideoView() {
        // 将playerLayer重新关联到原视图的layer上
        playerLayer.removeFromSuperlayer()
        yourVideoContainerView.layer.addSublayer(playerLayer)
        playerLayer.frame = yourVideoContainerView.bounds
    }
}

关键注意事项 #

• 永远不要同时使用AVPlayerViewController的内置PiP和自定义AVPictureInPictureController，两者互斥。
• 所有PiP相关的操作（初始化、状态监听、控制）必须在主线程执行，否则会导致状态异常。
• 确保playerLayer的关联视图在PiP激活期间没有被销毁，否则会导致控制器状态丢失。

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