About this project
这是一个面向 Web 前端的歌词播放组件库,目标是呈现接近 iPad 版 Apple Music 的歌词页面效果。项目以 monorepo 形式组织,主要模块包括:
- core:使用原生 DOM 编写的核心组件库,提供歌词显示组件与动态流体背景组件。
- react:React 绑定,以 React 组件形式提供歌词显示与动态流体背景。
- vue:Vue 绑定,以 Vue 组件形式提供同样的能力。
- lyric:歌词解析模块,支持 LyRiC、YRC、QRC、Lyricify Syllable 等多种歌词格式的解析与序列化。
浏览器兼容性方面,最低要求为 Chromium/Edge 91+、Firefox 100+、Safari 9.1+;若要完整渲染全部组件效果,则需要 Chromium 120+、Firefox 100+、Safari 15.4+。README 中给出的性能参考称,近五年主流 CPU 可以 30FPS 运行歌词组件,60FPS 建议 CPU 频率 3.0GHz 以上,144FPS 及以上建议 4.2GHz 以上;GPU 方面 1080p 满 60fps 建议 NVIDIA GTX 10 系列及以上,2160p 建议 RTX 2070 及以上。
开发与构建需要 Node.js 与 pnpm。克隆仓库后执行 pnpm install 安装依赖,pnpm run build:libs 进行全部库包的生产构建;也可用 pnpm nx run <包名>:build 单独构建某个包,例如 @applemusic-like-lyrics/core,或用 build:dev 做开发构建。
项目属于 AMLL 系列生态,同系列还有 TTML 音节歌词数据库、TTML 音节歌词编辑器、本地音乐播放器与网页音乐播放器等。README 提到目前仅有一位活跃维护者,正在招募共同维护者,并提供贡献指南、QQ 群与 Discord 作为沟通渠道。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.