tvOS中AVPlayerLooper循环视频出现卡顿问题排查求助

卡顿成因 #

• 无音轨导致时间同步缺失：AVPlayerLooper默认依赖音轨的时间戳作为同步锚点，无音轨视频缺少这个锚点，循环时播放器需要重新计算帧的起始解码位置，引发短暂卡顿。
• 资源重复初始化：当前代码在viewWillAppear中每次都重新创建AVQueuePlayer、AVPlayerLooper和AVPlayerItem实例，重复的资源加载与初始化会带来额外开销，加重卡顿。
• 视频帧衔接未优化：如果视频的最后一帧不是关键帧，循环时播放器需要解码过渡帧才能回到起始位置，这个过程会产生卡顿。

可行解决办法 #

1. 复用播放器资源，避免重复初始化 #

把视频资源的初始化逻辑移到init或viewDidLoad中，只在页面显示时控制播放/暂停，减少重复创建资源的开销。修改后的VideoVC示例：

class VideoVC:AVPlayerViewController {
    private var queuePlayer:AVQueuePlayer!
    private var videoLooper:AVPlayerLooper!
    private var videoName:String!
    private var playerItem: AVPlayerItem!
    
    init(videoName:String) {
        self.videoName = videoName
        super.init(nibName: nil, bundle: nil)
        setupVideoAsset()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
        self.player = queuePlayer
    }
    
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        queuePlayer.play()
        UIApplication.shared.isIdleTimerDisabled = true
    }
    
    override func viewWillDisappear(_ animated: Bool) {
        UIApplication.shared.isIdleTimerDisabled = false
        super.viewWillDisappear(animated)
        queuePlayer.pause()
    }
    
    private func setupVideoAsset() {
        guard let url = Bundle.main.url(forResource: videoName, withExtension: "mov") else { return }
        let asset = AVURLAsset(url: url)
        // 开启无限预加载，提前缓存视频数据
        asset.preferredForwardBufferDuration = TimeInterval.infinity
        
        playerItem = AVPlayerItem(asset: asset)
        queuePlayer = AVQueuePlayer(playerItem: playerItem)
        videoLooper = AVPlayerLooper(player: queuePlayer, templateItem: playerItem)
    }
}

2. 手动监听播放完成，替代AVPlayerLooper #

如果AVPlayerLooper的默认逻辑无法解决卡顿，可以手动监听播放完成事件，直接seek到视频起始位置，实现无缝循环：

class VideoVC:AVPlayerViewController {
    private var player: AVPlayer!
    private var videoName:String!
    private var playerItem: AVPlayerItem!
    
    init(videoName:String) {
        self.videoName = videoName
        super.init(nibName: nil, bundle: nil)
        setupManualLooping()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
    }
    
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        player.play()
        UIApplication.shared.isIdleTimerDisabled = true
    }
    
    override func viewWillDisappear(_ animated: Bool) {
        UIApplication.shared.isIdleTimerDisabled = false
        super.viewWillDisappear(animated)
        player.pause()
    }
    
    private func setupManualLooping() {
        guard let url = Bundle.main.url(forResource: videoName, withExtension: "mov") else { return }
        let asset = AVURLAsset(url: url)
        playerItem = AVPlayerItem(asset: asset)
        player = AVPlayer(playerItem: playerItem)
        self.player = player
        
        // 监听播放完成通知
        NotificationCenter.default.addObserver(self, selector: #selector(loopVideo), name: .AVPlayerItemDidPlayToEndTime, object: playerItem)
    }
    
    @objc private func loopVideo() {
        // 精准seek到起始位置，无延迟循环
        player.seek(to: .zero, toleranceBefore: .zero, toleranceAfter: .zero)
        player.play()
    }
    
    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

3. 优化视频编码，确保首尾帧为关键帧 #

用视频处理工具（如FFmpeg）重新编码视频，让视频的最后一帧和第一帧都是关键帧，命令示例：

ffmpeg -i input.mov -c:v libx264 -g 1 -c:a copy output.mov

-g 1表示每帧都是关键帧，这样播放器循环时可以直接跳转，无需解码过渡帧，彻底消除卡顿。

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