---

[!IMPORTANT] 📢 我们正在寻找共同维护者！
项目目前仅有 1 位活跃维护者，精力有限，如果你对项目和维护工作感兴趣，欢迎加入！ 详见 招募维护者 / Looking for Maintainers 和 贡献指南。 你还可以加入 QQ 群 (678038548) 或 Discord 服务器 进一步交流！

---

[!Warning]

AMLL Player 迁移提示：

致 AMLL Player 的开发/使用者，AMLL Player 已迁移至 独立仓库

仓库链接已更新为 https://github.com/amll-dev/amll-player

---

AMLL 生态及源码结构

主要模块

• ：AMLL 核心组件库，以 DOM 原生方式编写，提供歌词显示组件和动态流体背景组件
• ：AMLL React 绑定，提供 React 组件形式的歌词显示组件和动态流体背景组件
• ：AMLL React 完整播放器组件库，提供可组合的播放页面组件
• ：AMLL Vue 绑定，提供 Vue 组件形式的歌词显示组件和动态流体背景组件
• ：AMLL 歌词解析模块，提供对 LyRiC, YRC, QRC, Lyricify Syllable 各种歌词格式的解析和序列化支持
• ：AMLL TTML 处理模块，提供 TTML 的结构化解析、生成，以及与 AMLL 歌词数据的互转能力

浏览器兼容性提醒

本组件框架最低要求使用以下浏览器或更新版本：

• Chromium/Edge 91+
• Firefox 100+
• Safari 9.1+

完整呈现组件所有效果需要使用以下浏览器或更新版本：

• Chromium 120+
• Firefox 100+
• Safari 15.4+

参考链接：

• https://caniuse.com/mdn-css_properties_mask-image
• https://caniuse.com/mdn-css_properties_mix-blend-mode_plus-lighter

性能配置参考

经过性能基准测试，五年内的主流 CPU 处理器均可以以 30FPS 正常带动歌词组件，但如果需要 60FPS 流畅运行，请确保 CPU 频率至少为 3.0Ghz 或以上。如果需要 144FPS 以上流畅运行，请确保 CPU 频率至少为 4.2Ghz 或以上。

GPU 性能在以下状况下能够以预期尺寸下满 60 帧运行：

• 1080p (1920x1080): NVIDIA GTX 10 系列及以上
• 2160p (3840x2160): NVIDIA RTX 2070 及以上

开发/构建/打包流程

前置依赖

• Node.js
• pnpm

构建组件库

克隆本仓库后，在项目根目录执行以下指令：

# 安装依赖
pnpm install

# 生产构建所有库包
pnpm run build:libs

构建单个包

# 示例：仅构建 @applemusic-like-lyrics/core
pnpm nx run @applemusic-like-lyrics/core:build

# 示例：开发构建 @applemusic-like-lyrics/lyric
pnpm nx run @applemusic-like-lyrics/lyric:build:dev

鸣谢

• woshizja/sound-processor
• FFmpeg
• 还有很多被 AMLL 使用的框架和库，非常感谢！

特别鸣谢