AM++
简体中文 | English
Apple Music 的 Android 增强模块：平板双栏、歌词定制与液态玻璃。
无需 LSPosed 的npatch 嵌入版也可直接安装。
目录
1. [项目简介](#项目简介)
2. [功能](#功能)
3. [效果展示](#效果展示)
4. [安装](#安装)
5. [使用](#使用)
6. [从源码构建](#从源码构建)
7. [项目结构](#项目结构)
8. [路线图](#路线图)
9. [贡献](#贡献)
10. [隐私与权限](#隐私与权限)
11. [许可证与致谢](#许可证与致谢)
## 项目简介
安装后，在 Apple Music → 设置 → **AM++ 模块设置** 中管理功能。模块无独立启动图标。
支持导入 ZIP 插件扩展功能，详见 [插件开发手册](docs/plugin-development.md)。
## 功能
| 功能 | 默认 | 说明 |
| --- | --- | --- |
| 平板双栏播放器 | 开启 | 横屏时并排显示播放控件与实时歌词。 |
| 强制显示蜂窝数据入口 | 关闭 | 在设置中显示原生蜂窝数据选项。 |
| 双向歌词模糊 | 开启 | 当前歌词保持清晰，前后歌词渐变模糊，支持调节强度（Android 12+）。 |
| CJK 长尾歌词动画 | 开启 | 为中日韩歌词加入长音扫光动画。 |
| 歌曲名显示修正 | 关闭 | 按歌曲原地区、中国大陆或日本显示歌曲名与相关信息。 |
| 自定义歌词 | 关闭 | 导入、编辑 TTML 歌词，支持在线获取与 ZIP 备份恢复。 |
| 自动实时补全 | 开启 | 启用自定义歌词后，为缺词、非逐字或缺翻译的歌曲自动查找歌词。 |
| 歌词字体 | 关闭 | 导入 TTF/OTF 字体，随时恢复原字体。 |
| 液态玻璃底栏 | 关闭 | 为导航栏和迷你播放器加入液态玻璃效果（Android 13+）。 |
| 随滚动收缩 | 开启 | 手机端随页面滚动收缩或展开玻璃底栏，实时生效。 |
## 效果展示
### 自定义歌词注入
### MiSans 字体替换
### 平板双栏播放器与歌词模糊
### 液态玻璃底栏
## 安装
### Xposed 模块（推荐）
需要 Apple Music 和支持 libxposed API 102 的 Xposed 框架。
1. 从 [Releases](https://github.com/Zennmn/AM-plus-plus/releases/latest) 下载并安装 AM++ APK。
2. 在 LSPosed 或兼容的 Xposed 管理器中启用 **AM++**。
3. 作用域只勾选 Apple Music（`com.apple.android.music`）。
4. 强制停止并重新打开 Apple Music。
5. 打开 Apple Music → 设置 → “AM++ 模块设置”。
### npatch 嵌入版
直接安装 [npatch 嵌入版](https://github.com/Zennmn/AM-plus-plus/releases/tag/embedded-2026.08.10-r1)，无需 LSPosed，无法与官方版共存。
## 使用
部分设置需强制停止并重新打开 Apple Music 后生效。
### 自定义歌词
1. 打开“自定义歌词”，启用“自定义歌词替换”。
2. 点“获取 ID”读取当前歌曲，或手动填写 Apple Music ID。
3. 粘贴或导入 TTML，也可从 AMLL、AM-Lyrics、Lunabeat 在线获取。
4. 保存并启用该歌曲的歌词。
5. 强制停止并重新打开 Apple Music。
歌词支持搜索、编辑、删除和 ZIP 备份恢复；恢复时可选择覆盖或保留已有歌词。手动编写 TTML 可参考 [格式说明](docs/apple-music-ttml-format.md)。
### 歌词字体
1. 在“歌词字体”中选择 TTF 或 OTF 文件。
2. 导入完成后，强制停止并重新打开 Apple Music。
3. 点“恢复原字体”并重开 Apple Music 即可还原。
字体仅应用于播放器歌词。
### 液态玻璃底栏
打开“液态玻璃底栏”，强制停止并重新打开 Apple Music，即可为导航栏和迷你播放器应用玻璃效果。
可调节背景模糊强度；手机端还可开启“随滚动收缩”，让底栏随页面滚动自动收起、展开。
### 歌曲名显示修正
打开“歌曲名显示修正”，选择地区模式后重开 Apple Music。关闭时跟随 Apple Music 账号地区。
## 从源码构建
环境：JDK 17、Android SDK 37、Build Tools 37.0.0，使用项目自带的 Gradle Wrapper。
Windows：
```powershell
.\gradlew.bat test :app:lintDebug :app:lintVitalRelease :app:assembleRelease
```
Linux 或 macOS：
```bash
chmod +x gradlew
./gradlew test :app:lintDebug :app:lintVitalRelease :app:assembleRelease
```
生成的 Release APK 位于：
```text
app/build/outputs/apk/release/app-release.apk
```
构建 Release 前，将 `keystore.properties.example` 复制为 `keystore.properties` 并填写签名信息；无需签名配置可构建 Debug APK。
## 项目结构
```text
app/src/main/java/ 模块入口、设置页与功能装配
app/src/main/resources/ libxposed 模块元数据
core/ 配置、歌词、网络来源与布局策略
host-api/ 宿主能力与事件接口
hook-runtime/ Xposed 封装与日志
host-applemusic/ Apple Music 版本适配
glass/ 液态玻璃渲染
backdrop/ 上游 Backdrop 库
docs/ 使用与开发文档
scripts/ 开发辅助脚本
```
## 路线图
- [x] 平板横屏双栏播放器
- [x] 双向歌词模糊
- [x] 自定义歌词注入与备份恢复
- [x] 歌词字体导入与恢复
- [x] 液态玻璃底栏与迷你播放器
- [x] 歌曲名显示修正
- [ ] 持续适配后续 Apple Music 版本
## 贡献
欢迎提交 Issue 和 Pull Request。代码改动请通过测试与构建；反馈界面问题时，请附设备型号、系统及 Apple Music 版本、截图或录屏。
开发与适配请参阅 [文档目录](docs/README.md) 和 [宿主适配手册](docs/host-adaptation-guide.md)。
## 隐私与权限
- 仅声明 `INTERNET` 权限，用于歌词获取、翻译补全和歌曲信息查询。
- 不申请存储或通知运行时权限，本地文件通过系统文件选择器导入。
- 不含分析服务，也没有独立启动图标。
- 设置、歌词与字体保存在 Apple Music 私有目录。
## 许可证与致谢
本项目以 [GNU General Public License v3.0](LICENSE) 开源。第三方许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
- [AMLyricBlur](https://github.com/a23bc/amlyricblur)：歌词模糊。
- [AndroidLiquidGlass / Backdrop](https://github.com/Kyant0/AndroidLiquidGlass)：液态玻璃效果与交互。
(返回顶部)