新功能 桌面歌词：双击悬浮窗播放/暂停，三击切换下一首歌曲。 歌词缩放：设置面板新增调节按钮，支持 0.5x - 2.5x 字号调节 需要打开app里的设备广播状态和通知使用权 使用技巧： 点击标题显示与隐藏播放控件 点击右下角打开设置面板 点击屏幕进入全部歌词模式

Lyrics Plus Android 一个基于 Android 的歌词同步显示原型应用。本项目受 PC 端 Spicetify 的 lyrics-plus 自定义应用启发，通过监听 Spotify 的本地媒体广播，在安卓设备上实现高颜值、丝滑过渡的歌词同步滚动与特效显示。 ✨ 核心特性 🎵 多源歌词切换： 🇯🇵 日语假名标注： 🎨 极佳的视觉特效： ⏱️ 高精度本地同步： ⚙️ 手机端配置指南 为了让 App 能够完美接收 Spotify 的播放状态与歌词进度，请在手机上进行以下设置： 1. 开启 Spotify 设备广播 在 Spotify Android 客户端中，依次点击： 设置与隐私 -> 播放 -> 开启“设备广播状态” (Device Broadcast Status)。 (注：这是 Spotify 系统的安全机制，必须手动开启后，其他应用才能监听到当前的歌曲切换) 2. 授予通知栏监听权限 首次打开 App 时，点击通知栏访问权（Notification Access）进行授权。 或者手动设置，在系统的特殊权限设置中： 读取、回复和控制通知 -> 允许“Lyrics Plus”读取通知。 为什么需要这个权限？： Spotify 本身的本地广播只在歌曲切换或播放状态改变时触发，不会频繁广播微秒级的当前进度。 授权后，App 可以读取 Spotify 活跃媒体会话（Media Session）的播放位置。即使您刚打开 App、刷新应用或手机息屏锁屏后返回，歌词进度也能瞬间对齐，无需等待下一首歌。 🛠️ 编译与安装 直接安装： 在本仓库的 Releases 页面中，直接下载打包好的最新版本正式包 app-release.apk 在您的 Android 手机上安装。 自行编译： 用 Android Studio 打开项目 直接运行 app 配置，或者在终端运行以下命令： # 编译 Debug 包 ./gradlew.bat assembleDebug # 编译 Release 发行包（默认读取 scripts/official-build.env 中的公开统计端点） ./gradlew.bat assembleRelease 官方发布构建（包含匿名统计公开端点）： powershell -ExecutionPolicy Bypass -File .\scripts\assemble-official-release.ps1 📊 匿名统计 Debug 构建默认不会发送统计事件，因为统计端点为空。Release 构建默认读取 scripts/official-build.env 中的公开端点：https://lyrics.artria.dpdns.org/v1/events。 因此本地 assembleRelease / installRelease 与 GitHub Actions tag 触发的 Release APK 使用同一个统计端点。 统计只包含匿名安装 ID、App 版本、Android SDK、系统语言、功能开关与歌词源成功率等摘要信息，不收集歌曲名、歌手名、Spotify 账号或设备唯一标识。详情见 docs/telemetry.md。 ⚖️ 开源协议 本项目采用 GNU General Public License v3.0 (GPL-3.0) 协议开源。 协议选择依据： 由于本项目在设计理念与功能逻辑上深度参考了 PC 端著名的 Spicetify lyrics-plus 自定义应用（其所属的 Spicetify 整个生态采用 GPL-3.0 协议），根据开源协议的传染性与合规性要求，本项目同样采用 GPL-3.0 开源，以促进开源社区的健康发展与二次创作。 https://github.com/Artriai/lyrics-plus-android