BILIBILIAS 中文文档 下载 App

文件命名变量自定义

为什么要自定义命名

默认情况下,BILIBILIAS 下载的视频文件会用 BV 号作为文件夹名、视频标题作为文件名。但你可能希望有更个性化的组织方式——比如按 UP 主分文件夹、加上发布日期、或者用更短的文件名方便在文件管理器中浏览。命名规则功能就是为这个需求设计的。

命名规则配置页面

可用变量清单

点击命名规则配置区域,会弹出变量选择弹窗,列出所有可用的变量和简短说明。以下是完整的变量清单:

变量含义示例值
{BV}BV 号BV1wFJhzWE2e
{P}集数(默认 1)3
{P_TITLE}子集标题(可能不是视频标题)因为上了 ban 位,所以数值乱填
{CID}视频唯一 ID1234567890
{FILE_TYPE}文件格式后缀mp4 / mp3 / m4a / xml
{UP_NAME}UP 主昵称某UP主
{UP_UID}UP 主数字 ID675059275
变量选择弹窗,列出所有可用变量

默认规则解析

BILIBILIAS 的默认命名规则是:

{BV}/{FILE_TYPE}/{P}_{P_TITLE}_{CID}.{FILE_TYPE}

这个规则里有两个 / 字符,代表创建两层文件夹:

以视频 BV1wFJhzWE2e 为例,实际落盘路径是:

Download/BILIBILIAS/BV1wFJhzWE2e/mp4/1_因为上了ban位_xxxx.mp4

注意:{P_TITLE} 可能导致下载失败

官方文档特别提醒:{P_TITLE} 变量偶尔会引起视频下载失败——因为视频名称可能含有系统不允许的特殊字符(如 \、:、*、?、"、<、>、| 等),或者标题太长超出 Android 文件系统的单文件名长度上限。

如果你遇到下载失败(不是网络问题的那种),第一反应应该是去命名规则里看看是不是包含了 {P_TITLE},可以先把它删掉试试。

自定义示例

想要的效果:按 UP 主分文件夹,文件名用短 BV 号。

自定义规则:

{UP_NAME}/{BV}.{FILE_TYPE}

落盘示例:某UP主/BV1wFJhzWE2e.mp4