NeriPlayer (音理音理!)最新版

NeriPlayer (音理音理!)是一个支持多平台音视频聚合搜索、在线播放的开源聚合类安卓流媒体音频播放器，支持多种在线音视频平台的聚合搜索、在线播放以及个性化数据管理。项目的名称及图标灵感来源于《星空鉄道とシロの旅》中的角色「风又音理」。

在当前流媒体平台版权割裂严重、App臃肿不堪的环境下，NeriPlayer另辟蹊径，通过一套统一的交互逻辑，将分散在不同平台（如网易云音乐、B站等）的音视频资源整合在一起。为Android用户提供一个极简、统一且功能强大的媒体聚合播放方案。它将原本分散在各个平台的音乐与视频资源重新整合，让用户在一个应用内就能跨平台搜索、收藏并享受流畅的视听体验，告别频繁切换App的烦恼。

项目简介 / About

NeriPlayer 是一个基于 Jetpack Compose + Media3 的原生 Android 音频播放器。当前实现重点不是构建公共云端服务，而是在用户已具备 第三方平台账号能力的前提下，整合 网易云音乐 与 Bilibili 的 在线内容，并提供 流媒体缓存、应用内下载、本地导入、本地歌单管理、 可选 GitHub 私有仓库同步 等能力。

• 账号即能力：通过用户在第三方平台的合法授权，启用在线播放、 搜索、歌单访问等能力。
• 默认本地存储：播放缓存、下载文件、歌单、历史记录、设置与授权 信息默认保存在设备本地。
• 可选自有仓库同步：可将歌单、收藏和历史等元数据同步到用户自己 的 GitHub 私有仓库。
• 单 Activity + Compose 架构：以 MainActivity 为唯一对外入口， 通过 Compose NavHost、Mini Player 与 Now Playing 覆盖层组织界面。

核心特性 / Key Features

• 🎧 多源探索与播放：Explore 页当前支持网易云精选歌单， 并提供 网易云 / Bilibili 搜索入口。
• 🔍 分层搜索能力：页面搜索与播放页元数据补全是两套链路。 Explore 使用 网易云 / Bilibili； SearchManager 用 网易云 / QQ 音乐 补全封面、歌词与曲目信息。
• 🧠 基于 Media3 的自定义播放管理层： PlayerManager 负责音源解析、播放队列、随机/循环、状态持久化、 失败重试与恢复。
• 💾 可配置流媒体缓存：播放器使用 SimpleCache + LRU 做音频缓存， 默认上限为 1 GB，支持在设置中手动清理缓存。
• ⬇️ 应用内下载与本地播放：支持将在线音源下载到应用专属目录， 同步保存歌词与封面，并在应用内查看进度、管理已下载歌曲。
• 📁 本地音频导入与扫描：支持系统 VIEW / SEND / SEND_MULTIPLE 的 audio/*，可从外部分享/打开音频后导入；也支持扫描设备本地音频。
• ☁️ GitHub 私有仓库同步：可选同步本地歌单、收藏歌单、最近播放与 删除记录，使用 WorkManager 进行延迟与周期同步。
• 🛠️ 开发者模式与调试工具：设置页连续点击版本号 7 次 后， 底栏会出现独立 Debug 页，内含 Bili / Netease / Search API 探针、 普通日志与崩溃日志查看器。
• 🌈 音频反应式动态背景：在 Android 13+ 的 Now Playing 页面， 可选启用基于 RuntimeShader 的音频反应式背景效果。
• ♻️ 本地备份与恢复：支持本地歌单与收藏数据的 JSON 导入/导出， 用于设备迁移或手工备份。