AVQueuePlayer修改待播放队列下一项时出现卡顿问题求助

你遇到的卡顿问题，本质是AVQueuePlayer的队列修改操作（插入/移除）触发了同步资源加载，或者操作线程与播放线程冲突导致的阻塞。以下是具体的解决思路和代码示例：

核心原因 #

1. 直接在主线程执行insert/remove操作，主线程的UI任务会和音频资源加载抢占资源，引发卡顿。
2. 插入未预加载的AVPlayerItem时，播放器会同步等待资源加载完成，打断当前播放流程。

解决方案 #

1. 用专用串行队列处理所有队列修改操作 #

AVFoundation的API不是线程安全的，所有针对AVQueuePlayer的修改操作都应该放在同一个串行队列中执行，避免多线程竞争导致的异常和卡顿。

2. 预加载AVPlayerItem再插入队列 #

在插入队列前，确保AVPlayerItem已经完成资源加载，处于readyToPlay状态，避免插入时触发同步加载。

示例代码 #

首先创建专用的串行队列：

private let queuePlayerOperationQueue = DispatchQueue(label: "com.yourapp.queueplayer.operations")

插入元素的优化实现 #

func insertItemAfterCurrent(_ newItem: AVPlayerItem) {
    queuePlayerOperationQueue.async { [weak self] in
        guard let self = self, let currentItem = self.queuePlayer.currentItem else { return }
        
        // 设置预缓冲时长，提前加载更多音频数据
        newItem.preferredForwardBufferDuration = 10
        
        // 监听item的加载状态，就绪后再插入队列
        let statusObserver = newItem.observe(\.status, options: [.initial, .new]) { [weak self] (item, change) in
            guard let self = self else { return }
            
            if item.status == .readyToPlay {
                // 在专用队列执行插入操作
                self.queuePlayerOperationQueue.async {
                    self.queuePlayer.insert(item, after: currentItem)
                    statusObserver.invalidate() // 移除观察者
                }
            } else if item.status == .failed {
                // 处理加载失败的情况
                statusObserver.invalidate()
            }
        }
    }
}

移除下一个元素的优化实现 #

func removeNextUpItem() {
    queuePlayerOperationQueue.async { [weak self] in
        guard let self = self, let currentItem = self.queuePlayer.currentItem else { return }
        
        // 获取当前播放项的下一个待播放项
        if let nextItem = currentItem.nextItem() {
            self.queuePlayer.remove(nextItem)
        }
    }
}

额外注意事项 #

• 不要在主线程直接调用queuePlayer.insert或queuePlayer.remove，所有修改操作都交给专用串行队列处理。
• 对于批量插入多个item的场景，可以批量预加载所有item，待全部就绪后再一次性插入队列，进一步减少卡顿。

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