✨ 原生 Android 多源音频播放器 🎵
本项目的名称及图标灵感来源于《星空鉄道とシロの旅》中的角色「风又音理」。
项目采用原生 Android 开发，支持 Android 9 (API 28) 及以上设备，
围绕「多源探索、在线播放、本地可控」持续迭代。
🚧
Work in progress / 开发中
> [!WARNING]
> 本项目仅供学习与研究使用，请勿将其用于任何非法用途。
---
> [!NOTE]
> NeriPlayer 不提供公共云端曲库或媒体分发服务。
> 在线音频能力依赖用户在第三方平台上的账号授权，
> 会员或受限内容仍需遵循原平台规则。
---
## 项目简介 / About
NeriPlayer 是一个基于 **Jetpack Compose + Media3** 的原生 Android
音频播放器。它不构建公共云端服务，而是在用户具备第三方平台账号能力的前提下，
整合 **网易云音乐**、**Bilibili** 与 **YouTube Music** 的在线内容，
并提供本地播放、下载、缓存、歌单管理和多种同步/备份能力。
当前定位：
- **账号即能力**：通过第三方平台授权启用搜索、播放、歌单和收藏夹访问。
- **本地优先**：播放缓存、下载文件、歌单、历史记录、设置与授权信息默认保存在设备本地。
- **可选同步**：可将歌单、收藏、最近播放和播放统计同步到用户自己的
GitHub 私有仓库或 WebDAV 远端文件。
- **单 Activity + Compose 架构**：`MainActivity` 是唯一对外入口，
UI 由 Compose `NavHost`、动态底栏、Mini Player 与 Now Playing 覆盖层组织。
- **启动引导**：首次启动流程为 `Loading -> Disclaimer -> Onboarding -> Main`，
需先阅读免责声明，再完成语言、平台账号、同步和个性化设置引导。
---
## 快速体验 / Getting Started
### a. 下载 Release 版本（推荐）
1. 前往 [GitHub Releases](https://github.com/cwuom/NeriPlayer/releases)
2. 如何选择版本？
- 大部分手机请选择 `arm64-v8a`
- 老旧 32 位设备请选择 `armeabi-v7a`
- `x86` / `x86_64` 主要用于模拟器、英特尔设备或 Chromebook
> [!IMPORTANT]
> Release 渠道不是严格意义上的稳定通道。版本通常在完成一批功能后手动发布，
> 仍可能包含未充分暴露的问题。
### b. 下载 CI 版本
1. 前往 [GitHub Actions](https://github.com/cwuom/NeriPlayer/actions)
下载最近一次成功构建的 Artifacts 并解压。
2. 或访问 [NeriPlayer CI Builds](https://t.me/neriplayer_ci)。
> master 分支 CI 默认上传 `arm64-v8a` APK；手动 Release 流程会构建多 ABI APK。
### c. 本地构建
1. 克隆仓库并初始化子模块：
```bash
git clone --recursive https://github.com/cwuom/NeriPlayer.git
cd NeriPlayer
```
2. 使用 Android Studio 最新稳定版打开项目并同步依赖。
3. 构建调试版：
```bash
./gradlew :app:assembleDebug
```
4. 安装 APK：
```bash
adb install -r app/build/outputs/apk/debug/app-debug.apk
```
5. 首次启动时先阅读免责声明并完成启动引导；Android 13+ 会申请通知权限。
6. 如需调试工具，在设置页连续点击 **版本号** 7 次启用开发者模式，
底栏会出现独立 `Debug` 页面。
> DEBUG 构建仅用于测试，性能和体积不代表发布版。
发布版构建与签名流程请参阅
[CONTRIBUTING.md](./CONTRIBUTING.md#构建发布版--release-build)。
---
## 核心特性 / Key Features
- 🎧 **多源探索与播放**：
支持网易云音乐、Bilibili、YouTube Music 与本地音频播放。
- 🏠 **首页推荐与继续播放**：
首页支持最近常用歌单、推荐卡片；国际化模式下优先展示 YouTube Music
首页歌单与歌曲货架。
- 🔍 **分层搜索能力**：
`Explore` 使用网易云 / Bilibili / YouTube Music 按平台独立搜索；
播放页元数据补全使用网易云 / QQ 音乐，并接入 LRCLIB 外部歌词来源。
- 🧠 **Media3 播放核心**：
`PlayerManager` 管理音源解析、队列、随机/循环、状态恢复、失败重试、
YouTube 预取与平台特殊请求策略。
- 🔁 **网易云自动换源**：
网易云歌曲无权限、无可用直链或仅返回试听片段时，会先尝试降低音质，
再按歌曲名、歌手和时长匹配 Bilibili 音源兜底。
- 🎚️ **播放音效**：
Now Playing 内置倍速、音调、响度增强和均衡器预设/手动频段调节。
- 💾 **可配置流媒体缓存**：
使用 `SimpleCache + LRU` 缓存音频，默认上限 **1 GB**，
支持分别清理音频缓存和图片缓存。
- ⬇️ **应用内下载与管理**：
支持多平台音频下载、本地下载列表、任务进度、取消/重试，
并保存歌词、封面、元数据和音频标签。
- 📁 **可迁移下载目录**：
下载文件默认在应用管理目录，也可通过 SAF 选择自定义目录；
切换目录时会迁移已有下载，并支持自定义文件名模板。
- 🎵 **本地音频导入与扫描**：
支持系统 `VIEW / SEND / SEND_MULTIPLE` 的 `audio/*`，
也支持扫描设备本地音乐，并自动识别附近歌词与封面 sidecar 文件。
- 🩷 **本地歌单与收藏**：
内置「我喜欢的音乐」和「本地文件」系统歌单，普通本地歌单支持创建、
重命名、删除、排序和添加歌曲；「我喜欢的音乐」支持同步可识别歌曲到
网易云我喜欢的音乐。
- ☁️ **GitHub / WebDAV 同步**：
可选同步本地歌单、收藏歌单、最近播放、播放统计和删除记录，
使用 `WorkManager` 做延迟与周期同步。
- ♻️ **备份与恢复**：
支持歌单 JSON 导入/导出；也支持完整配置导入/导出，
可迁移设置、语言、平台授权、GitHub/WebDAV 配置与一起听设置。
- 🎧 **一起听**：
支持创建房间或加入他人房间，通过 WebSocket 实时同步播放状态，
支持房主/听众权限、邀请链接、深链加入、自定义服务端和房主离线检测。
- 🌈 **个性化与主题**：
支持浅色/深色/跟随系统、动态取色、种子色、主题风格、UI 缩放、
自定义背景图、歌词字号和首页卡片开关。
- ✨ **播放页动效与歌词**：
支持音频反应式动态背景、封面模糊背景、高级歌词、逐词歌词、翻译歌词、
歌词偏移、歌词编辑、歌词字体调节和 Lyrics 全屏页。
- 🔌 **外部歌词/设备联动**：
支持词幕适配（Lyricon Provider）、外部蓝牙歌词、蓝牙断连暂停和
USB 独占播放开关；词幕适配会同步当前歌曲、播放状态、进度、逐字歌词和翻译。
- 🛠️ **开发者模式与调试工具**：
设置页连续点击版本号 **7 次** 后，底栏出现 `Debug` 页，
包含 YouTube / Bili / Netease / Search / Listen Together 探针、
普通日志与崩溃日志查看器。
---
## 平台现状 / Platform Status
- **网易云音乐**：
登录、歌曲搜索、精选歌单、专辑、歌单/专辑列表搜索、播放、下载、歌词、播放页元数据补全，
无权限自动换源，以及本地收藏同步到网易云我喜欢的音乐。
- **Bilibili**：
登录、视频搜索、收藏夹、合集、收藏夹/合集列表搜索、分 P 转音频播放、下载；
当前不是完整视频发现流或评论区客户端。
- **YouTube Music**：
登录、首页/歌单浏览、歌单详情、搜索、播放、下载，
并包含 PoToken / JS Challenge 相关支持。
- **QQ 音乐**：
当前仅用于播放页元数据和歌词补全，未实现登录、播放和库页数据。
- **本地音频**：
支持外部分享/打开导入、设备扫描、本地文件播放、分享和本地歌单管理。
---
## 实现概览 / Implementation Notes
### 构建与版本
- `compileSdk = 36`
- `targetSdk = 36`
- `minSdk = 28`
- Java 17 / Kotlin JVM 17
- NDK `27.0.12077973`
- CMake `3.22.1`
- 版本名格式：`