APlayer 支持的 LRC 歌词时间戳格式

标准 LRC 时间戳语法

LRC（LyRiCs）是一种纯文本歌词格式，用方括号包裹时间戳。APlayer 支持以下六种时间戳写法：

基本格式

[mm:ss]歌词文本

分钟和秒各是两位数字，秒不带小数。

带百分之一秒

[mm:ss.xx]歌词文本

秒后面加一个小数点和两位小数（百分之一秒）。

带千分之一秒

[mm:ss.xxx]歌词文本

秒后面加一个小数点和三位小数（千分之一秒）。

多个时间戳同一行

一行歌词可以对应多个时间点——APlayer 会在每个时间点高亮这行歌词：

[mm:ss.xx][mm:ss.xx]同一行歌词出现在两个时间点

尖括号时间戳

部分播放器也用尖括号包裹时间戳：

[mm:ss.xx]<mm:ss.xx>这种写法也被支持

歌词内嵌入时间戳

时间戳可以嵌在正文中间：

[mm:ss.xx]第一段歌词[mm:ss.xx]第二段歌词

APlayer 会在到达第一个时间戳时显示从开头到第一个时间戳之间的文字，然后到达第二个时间戳时切换到第二个时间戳之后的文字。

时间精度对比

时间戳的约束

• 分钟：0 ~ 99（两位数字，不支持超过 99 分钟）
• 秒：0 ~ 59（两位数字，不支持 60 秒）
• 小数部分：最多三位数字，多余的会被忽略

实际上，APlayer 只做基本的数字解析，不会严格校验范围。但 LRC 标准要求分钟不超过 99、秒不超过 59。

完整 LRC 文件示例

[ti:歌曲标题]
[ar:艺术家名称]
[al:专辑名称]
[by:歌词制作者]
[00:00.00]歌曲标题
[00:02.00]艺术家 - 歌曲名
[00:05.50]第一行歌词内容
[00:10.25]第二行歌词内容
[00:15.00]第三行歌词内容[00:18.00]第三行的后半部分
[00:22.00][00:28.00]这行歌词在两个时间点高亮
[00:35.00]
[00:37.50]空行可以用来表示间奏
[00:45.00]继续……

元数据行

开头的 [ti:]、[ar:]、[al:]、[by:] 等是 LRC 的元数据字段：

APlayer 会忽略这些元数据行——它们不会显示在歌词区域，也不会影响播放。如果你需要显示歌曲标题和艺术家，通过 audio.name 和 audio.artist 参数传入。

排序建议

APlayer 不对时间戳做排序——它按 LRC 文件中的出现顺序依次处理。如果时间戳是乱序的，可能导致歌词跳跃或不显示。

最佳实践：按时间升序排列每一行：

✅ 正确：
[00:05.00]第一行
[00:10.00]第二行
[00:15.00]第三行

❌ 有问题：
[00:15.00]第三行
[00:05.00]第一行
[00:10.00]第二行

与其他播放器的兼容性

APlayer 支持的时间戳语法覆盖了绝大多数主流 LRC 编辑器（如 LRC Generator、EasilyEdit、LRC Editor 等）的输出格式。从 QQ 音乐、网易云音乐、酷狗等平台下载的 LRC 文件通常可以直接使用。

如果遇到歌词不显示的情况，首要排查 LRC 文件的时间戳格式——把文件内容贴出来看是否符合上面列出的语法。