视频离线缓存下载 — 通勤路上无网也能看

为什么要缓存

把视频提前下载到本地的好处：

• 移动网络省流量：Wi-Fi 下缓存好，移动网络直接看本地文件
• 无网环境可用：地铁、飞机、偏远地区没有 Wi-Fi 也能看
• 离线听播客：配合听视频模式，缓存干货视频可以连续听一整天
• 画质稳定：不受实时网络波动影响

缓存步骤

单个视频

1. 进入视频详情页
2. 点击下载图标（向下箭头）
3. 弹出清晰度选择列表
4. 选择一个或多个清晰度
5. 开始下载

批量缓存

1. 在 UP 主的视频列表页或搜索结果页
2. 长按某个视频进入多选模式
3. 勾选多个视频
4. 底部弹出批量操作 → 选"缓存下载"
5. 统一选清晰度后开始下载

番剧批量缓存

在番剧详情页 → 长按某集 → "批量缓存整季" → 选清晰度 → 开始下载全部集数。

清晰度选择策略

缓存时怎么选清晰度取决于你的需求：

断点续传

BiliPai 的下载管理器完整支持断点续传：

• 下载中途手动暂停 → 再次点击下载图标继续
• 下载中途断网 → 网络恢复后自动继续
• 下载中途关闭 App → 下次打开自动检查未完成的下载并继续
• 系统杀进程 → 下次打开继续（下载记录存在 Room 数据库里）

音视频合并

B 站视频的 DASH 流其实是视频轨和音频轨分开的两个文件。BiliPai 下载时：

1. 分别下载视频轨和音频轨
2. 下载完成后在本地用 MediaCodec 合并成一个文件
3. 合并完成后自动清理临时文件

你在文件管理器里能看到的缓存是单个 .mp4 文件，可以用其他播放器打开。

缓存管理

路径：设置 → 存储与数据 → 缓存管理

可以查看：

• 当前缓存总大小
• 每个缓存视频占用的空间
• 单个删除 / 全部清理 / 按时间清理

⚠️ 清理后不可恢复，提前确认不需要再看。

存储位置

BiliPai 默认把缓存存到 Android 内部存储。路径通常是：/data/data/com.android.purebilibili/files/download/

这是一个应用私有目录，其他 App 无法访问。想把缓存移到 SD 卡：路径：设置 → 存储与数据 → 存储位置 → 选 SD 卡。

注意：Android 从 10 开始对外部存储做了严格限制，部分机型可能无法写入 SD 卡私有目录。

缓存和播放记录的关系

缓存下载的视频文件会自动出现在 BiliPai 的播放列表里。你不需要额外操作——缓存完成后，进入"我的 → 离线缓存"就能看到所有已缓存的视频，点击直接播放，不需要网络。

缓存常见问题

下载一直 0% 不动

• 检查网络连接
• 检查存储空间是否满了
• 尝试暂停后继续（有时 HTTP 连接会超时）
• 退出 BiliPai 后重新打开（下载管理器可能卡住）

缓存播放卡顿

• 选择更低清晰度缓存
• 可能是合并时的编码不兼容，更新 BiliPai 到最新版
• 清理该缓存后重新下载