Mini Player

本地离线音乐播放器，面向 Android 设备，使用 Kotlin、Material 3 和 AndroidX Media3 构建。

Mini Player 不需要登录、不依赖服务器，音乐文件始终保存在用户自己的设备上。项目当前版本为 v0.2，APK 发布在 GitHub Releases。

功能

• 本地音乐扫描：MediaStore、文件夹和 SAF 目录扫描
• 音乐库：全部歌曲、专辑、歌手、文件夹、收藏和最近播放
• 播放器：播放队列、上一首/下一首、单曲循环、随机播放、列表循环
• 全局 Mini Player 和全屏播放器
• Material 3 风格的“音乐 / 我的”底部导航
• 均衡器：预设、自定义调节和本地保存
• 主题与壁纸：支持自定义背景、模糊和文字可读性设置
• 播放状态恢复：应用重启后恢复队列和进度，不自动强制播放
• 删除保护：可选择仅从音乐库移除，或同时删除本地文件
• 歌单管理：新建私密歌单、批量加入或移出歌曲
• 完整状态反馈：空状态、加载骨架、扫描进度与失败重试
• 主题模式：跟随系统、浅色、深色与 AMOLED
• Android 13+ 通知权限和后台播放通知

界面预览

技术栈

• Kotlin
• Android SDK 34 / minSdk 26
• Material Components 3
• AndroidX Media3
• Room
• Kotlin Coroutines
• ViewBinding

构建

使用 Android Studio 打开项目，或在 Windows 环境执行：

.\gradlew.bat assembleDebug lintDebug

APK 输出位置：app/build/outputs/apk/debug/app-debug.apk

开发文档

• 开发与验收说明
• 数据层模块说明
• 扫描模块说明
• 播放器模块说明
• UI 模块说明

隐私

Mini Player 是本地离线播放器，不上传音乐文件、播放历史或个人信息。应用只在用户授权后读取本地音频，并将音乐库和播放状态保存在设备本地。

许可证

本项目使用 MIT License。