我来帮你捋一捋这个问题的排查思路和正确实现步骤，毕竟在tvOS上折腾PIP功能，确实容易在细节上踩坑。首先得明确：AVPictureInPictureController.isPictureInPictureSupported()返回true只是说明系统本身支持PIP，但isPictureInPicturePossible返回false，意味着当前你的应用环境没满足所有触发PIP的必要条件。

核心排查方向：为什么isPictureInPicturePossible会是false？ #

这个属性返回false，通常和以下几个关键因素有关：

• AVPlayer/AVPlayerItem的状态不达标
• 视频内容未完成渲染
• 视图层级或AVPlayerLayer配置错误
• 音频会话或权限配置有遗漏
• PIP控制器的初始化时机或方式不对

一步步调试排查的方法 #

1. 检查AVPlayerItem的核心状态 #

先确认你的自定义AVPlayer加载的是有效的视频资源：

• 打印player.currentItem?.status，确保它是.readyToPlay（而不是.unknown或.failed）
• 检查player.currentItem?.hasVideo是否为true（如果只有音频轨道，PIP肯定不可用）
• 查看player.currentItem?.error，如果有错误信息，直接定位资源加载问题

示例代码：

print("Player Item Status: \(player.currentItem?.status.rawValue ?? -1)")
print("Has Video Track: \(player.currentItem?.hasVideo ?? false)")
if let error = player.currentItem?.error {
    print("Item Error: \(error.localizedDescription)")
}

2. 确认视频已完成第一帧渲染 #

tvOS要求视频必须在屏幕上渲染过至少一帧，才允许进入PIP。你可以通过监听通知来确认：

NotificationCenter.default.addObserver(
    self,
    selector: #selector(onVideoFirstFrameRendered),
    name: .AVPlayerItemNewPresentationSize,
    object: player.currentItem
)

@objc func onVideoFirstFrameRendered() {
    // 此时再检查isPictureInPicturePossible
    print("PIP Possible After Render: \(pipController?.isPictureInPicturePossible ?? false)")
}

3. 验证AVPlayerLayer的视图层级 #

确保你的AVPlayerLayer已经正确添加到可见的视图层级中：

• 检查playerLayer.superlayer是否存在，且所属的视图当前是可见的（不是hidden、alpha为0或者不在窗口层级）
• 确认playerLayer.frame不是空的，视频视图有实际的尺寸

4. 重新核对音频会话配置 #

虽然你说已经设置好了，但再仔细检查一遍：

• 音频会话类别必须是.playback（不能是.ambient或其他类别）
• 已经调用try audioSession.setActive(true)激活会话，且没有激活失败的情况
• 没有其他应用抢占了音频会话（可以在调试时关闭其他后台音频应用）

示例音频会话配置：

do {
    let audioSession = AVAudioSession.sharedInstance()
    try audioSession.setCategory(.playback)
    try audioSession.setActive(true)
} catch {
    print("Audio Session Error: \(error.localizedDescription)")
}

5. 检查Info.plist的权限配置 #

tvOS上PIP需要两个关键配置：

• 添加UIBackgroundModes数组，包含picture-in-picture值（允许应用在后台运行PIP）
• 添加NSPictureInPictureUsageDescription键，填写一段说明文字（告知用户应用使用PIP的原因，虽然tvOS不是强制，但缺失可能导致异常）

6. 启用AVFoundation调试日志 #

在Xcode的Scheme设置中，添加环境变量AVFoundation_DEBUG_LOG_LEVEL并设置为4，这样系统会输出详细的PIP相关日志，包括为什么判定PIP不可用的具体原因。

自定义AVPlayer下PIP的正确实现流程 #

1. 初始化并配置AVPlayer与PlayerLayer #

class VideoPlayerViewController: UIViewController {
    private var player: AVPlayer!
    private var playerLayer: AVPlayerLayer!
    private var pipController: AVPictureInPictureController!

    override func viewDidLoad() {
        super.viewDidLoad()
        setupPlayer()
        setupPIPController()
    }

    private func setupPlayer() {
        guard let videoURL = URL(string: "你的视频URL") else { return }
        player = AVPlayer(url: videoURL)
        playerLayer = AVPlayerLayer(player: player)
        playerLayer.frame = view.bounds
        view.layer.addSublayer(playerLayer)
        
        // 监听第一帧渲染通知
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(onVideoFirstFrameRendered),
            name: .AVPlayerItemNewPresentationSize,
            object: player.currentItem
        )
    }
}

2. 正确初始化AVPictureInPictureController #

必须在主线程初始化，且要保持强引用：

private func setupPIPController() {
    DispatchQueue.main.async { [weak self] in
        guard let self = self, let playerLayer = self.playerLayer else { return }
        self.pipController = AVPictureInPictureController(playerLayer: playerLayer)
        self.pipController.delegate = self
    }
}

3. 触发PIP的时机 #

必须在视频渲染第一帧之后，且isPictureInPicturePossible为true时，才显示PIP按钮或触发PIP：

@objc func onVideoFirstFrameRendered() {
    guard let pipController = pipController else { return }
    if pipController.isPictureInPicturePossible {
        // 显示自定义PIP按钮，或者自动触发PIP
        // pipController.startPictureInPicture()
    }
}

4. 实现PIP代理方法（可选但建议） #

处理PIP进入、退出等状态变化：

extension VideoPlayerViewController: AVPictureInPictureControllerDelegate {
    func pictureInPictureControllerWillStartPictureInPicture(_ controller: AVPictureInPictureController) {
        // 进入PIP前的准备，比如暂停其他UI动画
    }

    func pictureInPictureControllerDidStopPictureInPicture(_ controller: AVPictureInPictureController) {
        // 退出PIP后的恢复，比如恢复播放或调整视图
        player.play()
    }
}

最后几个容易忽略的坑 #

• 必须保持AVPlayer、AVPlayerLayer和AVPictureInPictureController的强引用，否则会被提前释放，导致PIP不可用
• 不要在视频还没加载完成时就初始化PIP控制器，一定要等playerItem状态变为.readyToPlay之后
• tvOS上PIP不支持某些特殊的视频编码格式，如果你的视频编码不兼容，也会导致isPictureInPicturePossible为false（可以用系统自带的AVPlayerViewController测试一下，如果它能PIP，说明编码没问题）

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