BiliAudio

基于 Android 的哔哩哔哩音乐播放器项目。

当前版本聚焦于把 B 站视频中的音乐内容以移动端播放器形态整理出来，已经完成扫码登录、首页推荐、收藏/历史/稍后再看、搜索、播放器、后台播放、下载等主链路。

当前功能

• 扫码登录 B 站账号并持久化登录态
• 首页推荐模块
• 全站音乐榜
• 推荐 UP 主
• 新歌速递
• 搜索视频并直接播放
• 我的关注、稍后再看、历史记录、我的收藏
• 收藏、点赞、下载音频
• 迷你播放器与全屏播放器
• 后台播放、锁屏控制、通知栏上一首/暂停/下一首
• 离线检测与本地下载音频播放

技术栈

• Kotlin
• Jetpack Compose
• Material 3
• Navigation Compose
• Hilt
• Retrofit
• OkHttp
• Gson
• AndroidX DataStore
• Media3 ExoPlayer
• Foreground Service + MediaSession
• Coil
• ZXing

项目结构

• app/src/main/java/com/biu/android/app/ui
  • 应用入口与导航壳层
• app/src/main/java/com/biu/android/app/feature/home
  • 首页推荐、UP 空间入口
• app/src/main/java/com/biu/android/app/feature/search
  • 搜索页与搜索结果播放
• app/src/main/java/com/biu/android/app/feature/mine
  • 关注、收藏、历史、稍后再看、下载记录
• app/src/main/java/com/biu/android/app/feature/player
  • 播放器 UI、播放队列、播放器状态
• app/src/main/java/com/biu/android/app/feature/player/data
  • 音频解析、ExoPlayer、后台播放服务、通知控制
• app/src/main/java/com/biu/android/app/core/network
  • B 站接口定义、网络模块、连接状态监测

参考项目

本项目在产品结构、交互方向和部分接口梳理上参考了以下项目：

• wood3n/biu
  • GitHub: https://github.com/wood3n/biu
  • 本地参考目录: E:\biu_Android\biu

开发环境

• Android Studio 2024.2.1.1 或更高版本
• JDK 17
• Android SDK 35
• 最低支持 Android 8.0 API 26

构建

$env:JAVA_HOME='C:\Program Files\Android\Android Studio\jbr'
.\gradlew.bat :app:assembleDebug

生成的 APK 默认位于：

app/build/outputs/apk/debug/app-debug.apk

当前发布版本

• 应用名：BiliAudio
• 版本号：1.0.0