发表于

神马笔记 版本2.12.0——字幕笔记

新增字幕笔记功能。

支持2种格式字幕文件——ASS和SRT。

请将字幕文件保存到Download或者Documents文件夹，或者使用RE文件管理器解压字幕压缩文档。

添加字幕笔记与歌词笔记完全相同。

在字幕列表界面长按列表项可以预览字幕内容。

歌词解析使用了以下开源项目

发表于

神马笔记 版本2.11.0——歌词笔记

终于实现歌词笔记的第一版本了。

支持从网易云音乐和酷狗音乐导入歌词文件。

需要首先安装这2款音乐APP，之后在音乐APP听过的歌曲可以将歌词添加到神马笔记中。

添加歌词到笔记后，即可在笔记中查看歌词。

第一个版本主要实现的是导入歌词的功能。

查看歌词只是普通的文本形式。

未来将实现自动关联歌词，并且在查看歌词的可以播放音乐。

下一个版本将会实现添加字幕的功能。

字幕与歌词非常相似，前者对应视频，后者对应音频。

当把音轨从视频中分离出来后，与歌曲在本质上没有太大差别。

一、目标

『神马笔记』添加歌词到对话笔记中。

二、下载地址

神马笔记最新版本下载：【神马笔记 版本2.11.0——歌词笔记.apk】

三、功能介绍

与图片、音乐、视频、……保持着一贯的使用方式。

四、开发过程回顾

阶段 描述
获取歌曲信息 音乐APP的离线歌词，大多以ID作为文件名进行保存。
将音乐ID呈现给用户是毫无意义的。
首先要解决的问题便是根据音乐ID获取歌曲详情。
Android实现歌词笔记构思
Android获取歌曲详细信息
Android获取网易云音乐歌曲详细信息
Android获取酷狗音乐歌曲详细信息
Android获取歌词汇总
添加歌词笔记 获取歌曲信息完成后，即可将歌词添加到笔记中。
另外一个常规的添加过程。
查看歌词笔记 歌词添加后，自然是查看歌词内容。
Android歌词文件格式
Android解析歌词文件

获取歌曲信息和解析歌词时，花费了不少时间。

结果还算满意。

五、遇到的问题

因为获取歌曲信息存在很多无法确定的因素，前期没有进行版本规划。

整个开发过程有点失控，好在后期回到控制中。

六、Finally

须菩提。于意云何。 须陀洹。能作是念。 我得须陀洹果不。 须菩提言。 不也。世尊。

发表于

Android解析歌词文件

上一篇文章《Android歌词文件格式》中，介绍了几种不同的歌词格式。

现在着手开始解析。

一、目标

设计数据结构，并实现解析歌词文件。

二、开源项目

项目 描述
zhangliangming / HPLyrics 非常强大的歌词解析项目。
支持lrc、krc、ksc、网易云音乐歌词、……
非常完美！

写完了歌词解析功能才发现这么好的开源项目。

可惜重新造了一次轮子！

三、设计思路

1. 歌词

歌词由2个部分组成，Lyric和SongLyric。前者是独立的歌词，后者由多个Lyric组成，包括逐行歌词、卡拉OK歌词、翻译歌词、音译歌词等。

数据结构 描述
Lyric 歌词
SongLyric 歌曲歌词

2. Lyric

歌词由2个部分组成，标签属性和歌词内容。

标签属性存放在Map结构中，歌词还包括逐行歌词。

数据结构 描述
LyricRow 歌词行
LyricCell 逐行歌词的基本单位

3. Builder

Builder用来解析歌词。

有2种不同形式的歌词语法结构，分别为逐行和卡拉OK。

数据结构 描述
LyricBuilder Builder基类
LineBuilder 逐行歌词解析类
KalaokBuilder 逐字歌词解析类

4. KalaokTransformer

考拉OK逐字歌词的实现方式各不相同，网易云音乐和酷狗音乐的逐字歌词结构不同。

KalaokTransformer用来实现每行的具体解析。

数据结构 描述
KugouTransformer 酷狗音乐
NeteaseTransformer 网易云音乐

5. Parser

用来解析对应的格式。

四、代码地址

稍做整理后，会上传到GitHub，请稍候。

五、Finally

须菩提。 所谓佛法者。即非佛法。

发表于

Android歌词文件格式

上一个开发阶段《Android获取歌词汇总》实现了获取歌词的功能。

现在着手解析歌词。

一、目标

选择合适的歌词格式。

二、歌词格式

  • 歌词形式
形式 描述
逐行歌词 早期的歌词形式，以行为单位显示歌词，类似于字幕。
逐字歌词 卡拉OK形式的歌词，精确到每个字。
  • 歌词组成

歌词按行进行排序，每一行以[开始，以]结束。

组成 描述
属性 用于描述歌词的信息，比如：
ti：标题
ar：艺术家
language：酷狗音乐的翻译歌词
……等其他信息，并且以:分隔名值。
歌词 以数字开始的内容，有2种格式分别对应逐行歌词和逐字歌词。
[mi:se.mmm]：逐行歌词，分钟:秒数:毫秒数
[begin,duration]：逐字歌词，开始毫秒数,持续毫秒数
需要注意的是，一行中可以包含多个时间戳。
文本 不包含:分割符的属性，出现在酷狗音乐的翻译歌词部分。
  • 翻译歌词

针对外文歌词（如英语、日语、……等）翻译成中文歌词。

翻译歌词通常为逐行形式的歌词（可能也只能逐行吧）。

翻译歌词有2种形式。

形式 描述
有时间戳 与逐行歌词一致，带有时间戳，可以独立使用。
网易云音乐使用该种形式。
无时间戳 没有时间戳，以文本形式存在，必须配合逐行歌词使用，按索引位置一一对应。
酷狗音乐使用该形式。

三、歌词容器

歌词格式描述的是歌词内容的语法结构。

歌词容器描述的是歌词文件的存储结构。

不同的云音乐平台采用的歌词容器也不相同。

同一个云音乐平台，不同的使用场景，采用的歌词容器也不相同。

音乐平台 使用场景 描述
网易云音乐 Android离线歌词 同时包行逐行、逐字、翻译三种形式歌词，但是可选。
纯音乐歌曲，不存在歌词。
Android在线歌词 与离线歌词一致，但组织方式略有差别。
酷狗音乐 Android离线歌词 krc形式，包含逐字和翻译歌词，同样为可选。
目前没有发现逐行歌词。
猜想逐行和逐字为二选一，不会同时存在krc文件中。
Android在线歌词 krc格式，包含在json数据中。

四、回顾

歌词格式相对比较固定，无论是网易云音乐还是酷狗音乐，语法结构都比较固定。

麻烦的是歌词容器的结构，不同音乐平台采用的结构都不尽相同。

同一音乐平台也会有多种存储结构。

五、接下来

不同的歌词容器需要不同的加载器。

不同的歌词格式需要不同的解析器。

需要编写一堆的加载器和解析器，然后输出为统一的数据格式。

六、遗留问题

将不同的歌词容器统一成单一的歌词容词。

还是保持分散呢？

虽然不能减少编写加载器和解析器的工作量。

但至少文件格式是一致的，未来不需要查找各家的歌词容器结构。

未来或许有必要统一一下，可以降低代码管理的成本。

导入歌词时，使用原生格式。

加载歌词时，转换成标准格式。

七、Finally

何以故。 须菩提。 一切诸佛。及诸佛阿耨多罗三藐三菩提法。 皆从此经出。

发表于

Android获取歌词汇总

经历了几个开发阶段

  1. Android实现歌词笔记构思
  2. Android获取歌曲详细信息
  3. Android获取网易云音乐歌曲详细信息
  4. Android获取酷狗音乐歌曲详细信息

实现了从网易云音乐和酷狗音乐获取歌曲详情的功能。

接下来获取歌词内容。

一、目标

实现获取歌词功能。

二、网易云音乐

  • 私有API
名称 描述
接口地址 http://music.163.com/api/song/lyric?os=iphone&id={歌曲id}&lv=-1&kv=-1&tv=-1
说明 http://www.360doc.com/content/18/0318/21/30583588_738243092.shtml
示例 http://music.163.com/api/song/lyric?os=iphone&id=93666&lv=-1&kv=-1&tv=-1
返回值 JSON格式。
lrc：逐行歌词，可能不存在；
klyric：逐字歌词，可能不存在；
tlyric：翻译歌词，可能不存在；
测试结果 成功获取歌词内容。
  • imjad cn
名称 描述
接口地址 https://api.imjad.cn/cloudmusic/?type=lyric&id={歌曲id}
说明 https://api.imjad.cn/cloudmusic.md
示例 https://api.imjad.cn/cloudmusic/?type=lyric&id=93666
返回值 与私有API返回值一致。
测试结果 成功获取歌词内容。
  • Mess API
名称 描述
接口地址 https://v1.itooi.cn/netease/lrc?id={歌曲id}
说明 https://messoer.github.io/mess-api-doc/#/music/netease
示例 https://v1.itooi.cn/netease/lrc?id=93666
返回值 文本格式。
混合了lrc和tlyric的文本。没有发现klyric逐字歌词
测试结果 成功获取歌词内容。

三、酷狗音乐

  • 私有API
名称 描述
接口地址 http://www.kugou.com/yy/index.php?r=play/getdata&hash={歌曲id}
说明 https://blog.csdn.net/qq_32551929/article/details/87256150
示例 http://www.kugou.com/yy/index.php?r=play/getdata&hash=4e3ef6b2c2a8e35e7e0f78b09c71ffa6
返回值 JSON格式。
歌词包含在lyrics字段中，为普通逐行歌词。
测试结果 成功获取歌词内容。
  • 私有API

首先搜索可用的歌词，然后根据列表下载歌词。

返回歌词中有个评分score，可以根据评分来选择下载最有歌词。

名称 描述
功能 搜索可用的歌词。
接口地址 http://krcs.kugou.com/search?ver=1&man=yes&client=mobi&keyword=&duration=&album_audio_id=&hash={歌曲id}
说明 https://blog.csdn.net/u011086331/article/details/83098919
示例 http://krcs.kugou.com/search?ver=1&man=yes&client=mobi&keyword=&duration=&album_audio_id=&hash=4e3ef6b2c2a8e35e7e0f78b09c71ffa6
返回值 JSON格式。
具体歌词文件，包含在candidates字段中。
测试结果 成功获取可用歌词列表。

搜索歌词可选的另外一个接口。

名称 描述
功能 搜索可用的歌词。
接口地址 http://lyrics.kugou.com/search?ver=1&man=yes&client=mobi&keyword=&duration=&hash={歌曲id}
说明 https://blog.csdn.net/u010752082/article/details/50810190
示例 http://lyrics.kugou.com/search?ver=1&man=yes&client=mobi&keyword=&duration=&hash=4e3ef6b2c2a8e35e7e0f78b09c71ffa6
返回值 与上一个接口一致。
测试结果 成功获取可用歌词列表。
名称 描述
功能 获取歌词
接口地址 http://lyrics.kugou.com/download?ver=1&client=iphone&fmt=&charset=utf8&id={上一步得到的id}&accesskey={上一步得到的accesskey}
说明 https://blog.csdn.net/u011086331/article/details/83098919
示例 http://lyrics.kugou.com/download?ver=1&client=iphone&fmt=&charset=utf8&id=35206918&accesskey=3EAE7B449FEF86E6359C303DABD599D7
返回值 JSON格式。
歌词包含在content中，并且进行了base64转码。
测试结果 成功获取歌词内容。

  1. http://lyrics.kugou.com

  2. http://krcs.kugou.com

两个域名返回的结果一致。

  • Mess API
名称 描述
接口地址 https://v1.itooi.cn/kugou/lrc?id={歌曲id}
说明 http://www.360doc.com/content/18/0318/21/30583588_738243092.shtml
示例 https://v1.itooi.cn/kugou/lrc?id=4e3ef6b2c2a8e35e7e0f78b09c71ffa6
返回值 文本格式。
普通逐行歌词。
测试结果 成功获取歌词内容。

四、过程回顾

从测试结果来看，接口的使用优先级为：

  1. 私有API最优

  2. imjad并列，与网易云音乐数据一致

  3. mess api次之，采用的是文本格式的逐行歌词。

五、接下来

目前暂时用不上，出于好玩的考虑，先封装一下接口。

六、Finally

若复有人。 于此经中受持，乃至四句偈等。为他人说。 其福胜彼。