使用AVPlayerViewController预览.flac音频文件时出现加载异常问题

问题现象 #

• 原有音频格式（如MP3）通过AVPlayerViewController播放完全正常
• 添加FLAC格式支持后，出现有时能正常加载、有时加载失败的随机问题
• 所有格式使用完全一致的播放逻辑

可能原因及解决步骤 #

1. FLAC文件兼容性与完整性问题 #

AVPlayer对FLAC的支持依赖标准编码规范，非标准或损坏的文件易引发加载异常：

• 用Audacity等工具将失败案例的FLAC文件重新编码为标准格式，测试是否仍有问题
• 先通过本地播放器（如QuickTime）验证FLAC文件能否稳定播放，排除文件本身损坏的可能

2. 资源加载时机的竞态问题 #

FLAC文件解析耗时通常比MP3长，直接用URL初始化AVPlayerItem后立即调用play，可能因资源未加载完成导致失败。建议通过AVAsset异步加载资源状态后再初始化播放项：

private lazy var _player = AVPlayer()
private lazy var _playerViewController = AVPlayerViewController()

func playAudio(correctUrl: URL) {
    // 先移除旧的通知监听，避免重复注册
    NotificationCenter.default.removeObserver(self, name: .AVPlayerItemDidPlayToEndTime, object: nil)
    NotificationCenter.default.removeObserver(self, name: .AVPlayerItemFailedToPlayToEndTime, object: nil)
    
    let asset = AVURLAsset(url: correctUrl)
    // 预加载关键状态
    asset.loadValuesAsynchronously(forKeys: ["playable", "hasProtectedContent"]) { [weak self] in
        guard let self = self else { return }
        var error: NSError?
        let status = asset.statusOfValue(forKey: "playable", error: &error)
        
        DispatchQueue.main.async {
            switch status {
            case .loaded:
                if asset.isPlayable {
                    let item = AVPlayerItem(asset: asset)
                    self._player.replaceCurrentItem(with: item)
                    self._playerViewController.player = self._player
                    self.registerForAVPlayerNotifications()
                    self._player.play()
                } else {
                    print("当前FLAC文件不可播放")
                }
            case .failed:
                print("FLAC资源加载失败: \(error?.localizedDescription ?? "未知错误")")
            default:
                break
            }
        }
    }
}

3. 重复注册通知引发的逻辑异常 #

每次调用playAudio都执行registerForAVPlayerNotifications，会导致重复监听通知，可能干扰播放流程：

• 修改通知注册逻辑，确保只注册一次；或在每次播放前先移除旧监听（如上代码所示）

4. 系统版本适配问题 #

AVPlayer对FLAC的支持在不同iOS版本上存在差异：

• 测试不同iOS版本设备，确认问题是否仅出现在特定版本
• 针对iOS 11及以下版本，系统原生FLAC支持有限，可考虑引入libFLAC等第三方解码库辅助处理

问题对比图 #

• 正常状态：
• 异常状态：

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