DFPlayer缓存机制全解析分账户缓存、缓存大小统计与一键清除实现原理【免费下载链接】DFPlayer(已不维护)简单灵活的iOS音频播放组件。基于AVPlayer支持本地和远程音频播放具有缓存、耳机线控、锁屏和控制中心信息展示、单曲顺序随机播放、倍速播放、歌词同步等音频播放器功能DFPlayer封装了缓冲条、进度条、播放暂停按钮、下一首按钮、上一首按钮、播放模式按钮、歌词同步的tableview等UI控件一行代码布局即可实现相应功能。项目地址: https://gitcode.com/gh_mirrors/df/DFPlayerDFPlayer 是一款简单灵活的 iOS 音频播放组件基于 AVPlayer 封装支持本地与远程音频播放。本文深入讲解它的DFPlayer 缓存机制——分账户缓存如何隔离、缓存大小如何统计、一键清除缓存背后的实现原理帮助新手快速看懂这套音频缓存方案。一、缓存核心思路先写临时文件再移入缓存DFPlayer 的远程音频播放遵循「边下边播 落盘缓存」的思路整套流程由四个协作模块完成模块职责DFPlayerRequestManager.m发起网络请求边下载边把数据写入临时文件DFPlayerResourceLoader.m拦截 AVPlayer 的取数据请求优先从本地文件喂给播放器DFPlayerFileManager.m管理临时文件、缓存目录、缓存大小与清除DFPlayerFileManager.h 中的归档管理器记录 ETag / Last-Modified用于缓存有效性校验关键流程分三步 下载时每收到一段网络数据就追加写入沙盒临时目录下的MusicTemp.mp4临时文件同时喂给播放器实现「边下边播」下载完成后把临时文件整体移动move到对应音频的缓存目录从此本地播放不再消耗流量播放时AVAssetResourceLoaderDelegate拦截 AVPlayer 的每次取数请求已缓存部分直接从本地文件按 offset 读取未缓存部分才发起网络请求。移动失败时还有安全兜底——删除归档中对应的键值对避免「有记录、无文件」的脏状态见 DFPlayerFileManager.m#L82-L84。二、分账户缓存一个 userId 一个缓存目录很多 App 有多个用户共用一个沙盒DFPlayer 用目录隔离实现了分账户缓存。初始化播放器时传入 userId[[DFPlayer sharedPlayer] df_initPlayerWithUserId:userId];这条调用会触发 DFPlayer.m#L82-L83 中的df_saveUserId:把 userId 存入 NSUserDefaults不传则默认为public。而缓存目录的构造逻辑在 DFPlayerFileManager.m#L14-L28根目录沙盒 Library/Caches/DFPlayerCache/按用户分子目录DFPlayerCache/user_userId/目录不存在时自动递归创建也就是说每个用户的音频缓存物理上互相隔离用户 A 的缓存不会被用户 B 看到或误删这也为后面「一键清除当前用户缓存」打下了基础。三、缓存大小统计遍历目录累加文件体积想知道缓存占了多少空间DFPlayer 提供了df_cacheSize:接口一个 BOOL 参数即可区分「当前用户」和「所有用户」- (CGFloat)df_cacheSize:(BOOL)currentUser; // YES:当前用户 NO:所有用户实现原理非常直白DFPlayerFileManager.m#L100-L109根据currentUser参数取到对应的缓存根目录用subpathsAtPath:拿到目录下所有子项逐项读取fileSize属性并累加转换为 MB 返回。在 Demo 中可以直接看到效果DFCacheViewController.m#L45-L48_currL.text [NSString stringWithFormat:当前用户缓存:%.2lfM, [[DFPlayer sharedPlayer] df_cacheSize:YES]]; _allL.text [NSString stringWithFormat:所有用户缓存:%.2lfM, [[DFPlayer sharedPlayer] df_cacheSize:NO]];四、一键清除缓存单条清除 按用户批量清除DFPlayer 在 DFPlayer.h#L301-L332 中暴露了缓存相关的四个 API构成完整的「查询 → 清除」闭环API作用说明df_cachePath:获取某条音频的本地缓存路径无缓存时返回 nildf_cacheSize:统计缓存大小MB支持当前用户 / 所有用户df_clearAudioCache:清除单条音频缓存如某条音频源更新df_clearUserCache:一键清除整份用户缓存YES 当前用户NO 所有用户实现上对应 DFPlayerFileManager.m#L111-L118单条清除是删除对应缓存文件用户级清除则是直接移除整个user_userId目录传 NO 时移除整个 DFPlayerCache 根目录。由于文件都在沙盒 Cache 目录系统本身也可能在空间紧张时自动清理双保险更稳妥。在设置页里做一个「清除缓存」按钮只需一次调用即可[[DFPlayer sharedPlayer] df_clearUserCache:YES]; // 一键清除当前用户缓存五、缓存有效性校验ETag 与 Last-Modified光有缓存还不够还要确认缓存没过期。DFPlayer 用了一套轻量方案首次下载成功HTTP 200时从响应头取出Last-Modified和Etag通过DFPlayerArchiverManager归档到当前用户缓存目录下的DFPlayer.archiver文件DFPlayerRequestManager.m#L140-L148下次播放同一音频时若开启isObserveFileModifiedTime请求头自动带上If-None-Match和If-Modified-SinceDFPlayerRequestManager.m#L95-L100服务端文件没变就返回 304省流量变了就重新下载覆盖缓存。此外还配合Range请求头实现了断点续传网络中断恢复后从已缓存的长度处继续下载DFPlayerRequestManager.m#L104-L114。六、快速上手缓存功能使用清单✅ 初始化时设置 userIddf_initPlayerWithUserId:✅ 用df_cacheSize:在设置页展示缓存占用 ✅ 用df_clearUserCache:实现一键清除 ✅ 源文件更新时用df_clearAudioCache:精确失效 ✅ 需要校验源文件变化时开启isObserveFileModifiedTime更完整的接口说明可以参考 Document.md缓存相关 API 文档集中在 Document.md#L133-L147 的「缓存相关」小节。总结DFPlayer 的缓存机制可以概括为四句话 临时文件承接下载、userId 目录隔离账户、遍历累加统计大小、整目录移除实现一键清除。这套设计不依赖第三方缓存库仅用 Foundation 的文件管理 API 就同时做到了分账户隔离、空间统计、精确清除和断点续传非常适合作为学习 iOS 音频缓存方案的入门样本。【免费下载链接】DFPlayer(已不维护)简单灵活的iOS音频播放组件。基于AVPlayer支持本地和远程音频播放具有缓存、耳机线控、锁屏和控制中心信息展示、单曲顺序随机播放、倍速播放、歌词同步等音频播放器功能DFPlayer封装了缓冲条、进度条、播放暂停按钮、下一首按钮、上一首按钮、播放模式按钮、歌词同步的tableview等UI控件一行代码布局即可实现相应功能。项目地址: https://gitcode.com/gh_mirrors/df/DFPlayer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考