iOS SwiftUI中从缓存播放M3U8视频失败问题求助

核心问题：旧方案不适用于M3U8流媒体 #

你用的旧Stack Overflow方案应该是针对**单个视频文件（如MP4）**的缓存逻辑，但M3U8是HLS流媒体的播放列表文件，本身只是一段文本，记录了多个分片TS文件的远程地址。你的CacheManager大概率只下载了M3U8文件本身，没有处理里面的分片缓存，也没有修改M3U8中的分片路径为本地地址——这就导致AVPlayer加载本地M3U8时，依然尝试请求远程分片，自然无法正常播放。

代码实现的问题 #

当前代码的逻辑是直接用缓存后的M3U8文件URL初始化AVPlayer，但忽略了两个关键：

• 缓存的M3U8文件内的分片地址还是原远程URL，本地环境下AVPlayer无法直接访问这些远程资源（或因缓存逻辑未覆盖分片导致请求失败）
• 没有处理HLS流媒体的分片缓存、路径重写逻辑

旧方案是否过时？ #

不是过时，是场景不匹配。该方案针对的是完整视频文件的缓存，而M3U8属于流媒体分片播放模式，需要专门的缓存策略，和单个文件缓存逻辑完全不同。

替代解决方案 #

方案1：自定义AVAssetResourceLoaderDelegate（原生实现） #

通过拦截AVPlayer的资源请求，实现分片缓存与本地路径重写：

1. 创建自定义ResourceLoaderDelegate，实现AVAssetResourceLoaderDelegate协议，拦截M3U8和TS分片的请求
2. 对M3U8请求：下载后修改其中的分片URL为自定义的scheme（如cached://），再返回给AVPlayer
3. 对TS分片请求：先检查本地缓存，存在则返回本地文件；不存在则下载缓存后再返回
4. 在SwiftUI中使用AVPlayerItem加载带自定义资源加载器的AVURLAsset

示例代码片段：

class ResourceLoaderDelegate: NSObject, AVAssetResourceLoaderDelegate {
    // 实现资源拦截与缓存逻辑，这里省略具体缓存细节（可结合FileManager实现分片缓存）
    func resourceLoader(_ resourceLoader: AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVAssetResourceLoadingRequest) -> Bool {
        // 处理M3U8和TS请求，修改路径或返回本地缓存
        // 具体实现需解析请求URL，判断是M3U8还是TS，处理缓存逻辑
        return true
    }
}

// 在SwiftUI视图中使用
struct VideoView: View {
    let videoURL: URL
    private let resourceLoaderDelegate = ResourceLoaderDelegate()
    @State private var player: AVPlayer?
    
    var body: some View {
        VideoPlayer(player: player)
            .onAppear {
                let asset = AVURLAsset(url: videoURL)
                asset.resourceLoader.setDelegate(resourceLoaderDelegate, queue: DispatchQueue.global())
                let playerItem = AVPlayerItem(asset: asset)
                player = AVPlayer(playerItem: playerItem)
                player?.play()
            }
    }
}

方案2：使用成熟第三方库 #

直接用专门处理HLS缓存的库，避免自己造轮子：

• AlamofireVideoCache：基于Alamofire实现的视频缓存，支持HLS分片缓存
• CachePlayerKit：专门针对iOS视频缓存的库，支持HLS和普通视频文件
• HLSCache：轻量的HLS缓存库

以CachePlayerKit为例，SwiftUI中使用示例：

import CachePlayerKit

struct VideoView: View {
    let videoURL: URL
    @State private var player: AVPlayer?
    
    var body: some View {
        VideoPlayer(player: player)
            .onAppear {
                let cachePlayer = CachePlayer(url: videoURL)
                cachePlayer.cacheConfig.maxCacheSize = 1024 * 1024 * 500 // 500MB缓存上限
                player = cachePlayer.player
                player?.play()
            }
    }
}

方案3：使用AVFoundation的离线播放API #

iOS 10+支持HLS离线下载，可通过AVAssetDownloadTask下载整个HLS流到本地，之后直接播放本地离线资源：

struct VideoView: View {
    let videoURL: URL
    @State private var player: AVPlayer?
    
    var body: some View {
        VideoPlayer(player: player)
            .onAppear {
                let asset = AVURLAsset(url: videoURL)
                // 检查是否已下载离线资源
                if let offlineURL = UserDefaults.standard.url(forKey: "OfflineVideoURL") {
                    player = AVPlayer(url: offlineURL)
                    player?.play()
                    return
                }
                
                // 下载HLS离线资源
                let downloadTask = AVAssetDownloadTask(asset: asset, assetTitle: "MyVideo", assetArtworkData: nil, options: nil)
                downloadTask.resume()
                
                // 监听下载完成
                NotificationCenter.default.addObserver(forName: .AVAssetDownloadTaskDidFinishDownloading, object: downloadTask, queue: .main) { notification in
                    guard let url = notification.userInfo?[AVAssetDownloadTaskURLKey] as? URL else { return }
                    UserDefaults.standard.set(url, forKey: "OfflineVideoURL")
                    player = AVPlayer(url: url)
                    player?.play()
                }
            }
    }
}

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