Swift 5 类短视频Feed场景下AVPlayer无法播放本地缓存视频怎么办
直接导致播放失败的核心Bug
- 本地URL初始化逻辑完全错位
你获取到的newUrl本身就是带file://协议头的有效本地沙盒路径,代码中uri = URL(fileURLWithPath: newUrl.absoluteString)的写法,相当于把带file://前缀的整串字符串当做沙盒内的相对路径重新拼接,最终生成的路径会多出无效前缀,直接生成你日志里看到的-- file:///这类乱码后缀,系统根本定位不到实际的缓存文件,AVPlayer自然加载失败。
修正后的基础逻辑:CacheManager.shared.getFileWith(stringUrl: vUrl) { [weak self] result in guard let self = self else { return } switch result { case .success(let localURL): // 直接使用返回的原生URL,无需通过absoluteString二次转译 let asset = AVURLAsset(url: localURL) let playerItem = AVPlayerItem(asset: asset) self.player = AVPlayer(playerItem: playerItem) self.playerLayer = AVPlayerLayer(player: self.player) self.playerLayer?.frame = self.postImageView.frame self.contentView.layer.addSublayer(self.playerLayer!) case .failure(_): guard let remoteURL = URL(string: vUrl) else { return } let asset = AVURLAsset(url: remoteURL) let playerItem = AVPlayerItem(asset: asset) self.player = AVPlayer(playerItem: playerItem) } } - 容易被忽略的格式识别问题
从你打印的缓存文件名来看,落盘的时候没有给视频文件加上格式后缀(比如.mp4),AVPlayer会因为无法自动识别编码格式导致解码失败。这种情况需要在缓存写入环节给文件补上对应格式的后缀,要么在创建AVURLAsset的时候显式传入格式提示参数,避免自动识别失败。
适配TikTok类短视频Feed的优化方向
- Cell复用时不要频繁重建AVPlayer与AVPlayerLayer实例,当视频滑出屏幕不可见时,主动调用
player?.pause(),移除闲置的playerItem引用,避免多个短视频解码进程同时驻留内存导致的卡顿、内存暴涨问题。 - 不要直接用
AVPlayer(url:)的快捷初始化方法,改用AVURLAsset+AVPlayerItem的组合,配合监听资源加载状态,提前预加载即将进入屏幕的视频资源,避免滑动时出现首帧黑屏。 - 缓存有效性校验不要只判断文件是否存在,要对比缓存文件大小与网络请求返回的文件总大小是否一致,避免把下载中断的半截文件当做有效缓存返回。
内容的提问来源于stack exchange,提问作者Zash__
相关产品推荐
相关产品推荐

