基于 SPlayer 移植与重做的 Android 音乐播放器。保留原版精华，针对手机与平板彻底重构交互——一个能装进口袋的 SPlayer 🎶
| 📱 手机 | 💻 平板 |
 |
 |
 |
 |
 |
| 分类 | 描述 |
|---|---|
| 🎨 双端 UI | 手机 / 平板自适应布局，沉浸式全屏，状态栏可切换 |
| 🎵 播放引擎 | 基于 HTMLAudioElement，WebView 下长时间后台稳定 |
| 📝 逐字歌词 | 毫秒级插值高亮，翻译 / 罗马音，拖动吸附最近行 |
| 🪟 桌面歌词 | WindowManager 悬浮窗，逐字动画、锁定穿透、拖拽、播控 |
| 🔔 通知栏 | 原生 MediaSession，完整播控，支持桌面歌词一键开关 |
| 🎚️ 精细控制 | 渐入渐出、进度吸附歌词、允许与其他应用同时播放 |
| 🌐 在线音乐 | 网易云 + Jellyfin / Navidrome / Emby / Subsonic / Last.fm |
| 🧩 内置 API | nodejs-mobile-cordova 嵌入网易云 API，离线可用 |
| 📦 分架构打包 | arm64-v8a / armeabi-v7a / x86_64 / x86 独立 APK |
前往 Releases 选择对应 CPU 架构的 APK：
| ABI | 适用设备 | 推荐度 |
|---|---|---|
arm64-v8a |
绝大多数现代手机 / 平板 | ⭐⭐⭐⭐⭐ |
armeabi-v7a |
2015 年前的老旧 32 位 ARM 设备 | ⭐⭐ |
x86_64 |
Intel 平板、Android 模拟器 | ⭐ |
x86 |
极少数 32 位 Intel 设备 | ⭐ |
💡 不清楚自己设备架构？装个 CPU-Z，或者无脑选
arm64-v8a——99% 都是它。
- 🔄 修复 横竖屏切换 时部分界面布局错乱
- 📱 修复 手机小屏 下文字挤压成一团的问题
- ⬆️ 调整 "回到顶部"按钮 位置，不再遮挡其他控件
- 🎨 修复 桌面歌词 在未开启文本背景遮罩时、锁定状态下仍显示背景的 bug
- 📦 GitHub Actions 构建改为 分架构打包，单包体积更小
| 工具 | 版本 |
|---|---|
| Node.js | >= 20 |
| pnpm | >= 10 |
| JDK | 21 |
| Android SDK / NDK | 最新 |
pnpm install
pnpm build:android
cd android && ./gradlew assembleDebug产物：android/app/build/outputs/apk/debug/（按 ABI 分包）
pnpm build:web # 前端 Vite 构建
pnpm build:android:node # 内置 Node API Bundle
pnpm prepare:android:embedded # 准备嵌入资源
npx cap sync android # 同步 Capacitor 工程
npx cap open android # Android Studio 打开🔑 桌面歌词打不开，提示需要权限？
需要授予 SYSTEM_ALERT_WINDOW（显示在其他应用上层） 权限。首次启用会自动引导，如果拒绝过，可以去 系统设置 → 应用 → SPlayer → 权限 里手动开启。
🎧 想和其他应用同时播放？
进入 设置 → 播放 → 允许与其他应用同时播放。
⚠️ 注意：当前 Android 播放走HTMLAudioElement，该选项的实际效果依赖 WebView 版本与系统音频焦点策略，部分设备上行为可能不完全一致。
📦 我该下载哪个 APK？
无脑选 arm64-v8a。只有极老的设备（通常 2015 年前）才需要 armeabi-v7a。x86 / x86_64 几乎只用于模拟器。
🔕 通知栏控制器不显示？
- 设置 → 播放 里打开 "通知栏音乐控制器"
- 系统设置里允许 SPlayer 发送通知（Android 13+ 首次启用会弹权限框）
🌙 支持后台播放吗？
支持。通知栏控制器启用后，应用进入后台仍会继续播放，不会被系统快速回收。
|
SPlayer for Android 交流群 群号： 602750631一键加群：https://qm.qq.com/q/AjIqKftqgM 群内可讨论使用问题、交流经验，也欢迎反馈 Bug。 |
手动触发 Android Release 工作流即可分架构构建 & 发布 APK。
签名所需 Secrets：
| Secret | 说明 |
|---|---|
ANDROID_KEYSTORE_BASE64 |
Keystore 的 Base64 编码 |
ANDROID_KEYSTORE_PASSWORD |
Keystore 密码 |
ANDROID_KEY_ALIAS |
Key 别名 |
ANDROID_KEY_PASSWORD |
Key 密码 |
详细说明见 .github/ANDROID_RELEASE_SECRETS.md。
欢迎提 Issue 与 PR！提交前请先阅读 CONTRIBUTING.md，了解 Issue / PR / Commit 规范。
- 🐞 提交 Bug
- ✨ 提交功能建议
- 📮 发起 Pull Request
感谢每一位为本项目付出时间与代码的伙伴 ❤️
图片由 contrib.rocks 自动生成，随 GitHub 贡献图谱更新。
本项目基于 SPlayer 移植，向原作者 @imsyy 与所有贡献者致以最诚挚的感谢 ❤️
AGPL-3.0 —— 与上游保持一致