弥乐

MeloX Android 基于 lladlam/MeloX 的设计、交互与业务逻辑进行原生 Android 迁移。

项目目标不是使用 WebView 套壳，而是尽可能使用 Android 原生能力重新实现 MeloX：

・使用 Kotlin + Jetpack Compose 重建界面与交互； ・使用 AndroidX Media3 / ExoPlayer 实现播放、后台音频与系统媒体会话； ・将 iOS 独有能力映射到 Android 平台能力； ・在小米 HyperOS 上提供可选的焦点通知 / 超级岛适配，同时保持普通 Android 设备可用； ・尽可能复刻 MeloX / Apple Music 风格的播放器、歌词、音乐库与过渡动画； ・Apple Watch 相关功能不在 Android 版本的兼容范围内。

Root 权限不是应用正常运行的必要条件；平台增强功能应尽量通过标准 Android 或 OEM 能力实现，并在不支持时降级。

当前已实现

账号与网易云音乐 ・网易云音乐网页登录； ・MUSIC_U Cookie 登录态持久化； ・登录态搜索、歌曲详情、歌词、播放 URL 与音乐库请求； ・账号权限变化后刷新播放资源缓存。

搜索与音乐库 ・歌曲、歌单、专辑、艺人、用户与播客搜索； 我喜欢的音乐； ・用户歌单； ・创建公开/私密歌单、向歌单添加歌曲及从自己的歌单移除歌曲； ・最近播放； ・歌单、专辑、艺人、歌曲百科与评论详情； ・排行榜、首页推荐、每日推荐、私人 FM 与心动模式； ・播客首页、分类、订阅与节目详情； ・网易云音乐云盘读取、搜索、上传、播放与删除； ・单曲/集合多选下载、逐次音质选择、离线歌词、自动缓存与存储修复； ・保留 app-private 离线副本，并可导出到 MediaStore；本地库可按歌曲、艺术家、专辑和文件夹浏览； ・从音乐库 / 搜索结果直接播放。

播放器 ・MiniPlayer； ・Apple Music / Classic 两套全屏播放器外壳； 播放队列； ・下一首播放、手动队列与队列排序； ・播放 / 暂停、上一首 / 下一首、进度控制； 后台播放； ・MediaSession 与系统媒体控制； ・锁屏播放信息； ・封面与动态取色背景； ・AutoMix 双播放器预载、音频分析、过渡规划、节拍/速度匹配、淡化与 EQ 包络； ・31 Hz–16 kHz 十段均衡器、完整预设、系统/播放器音量模式与睡眠定时； ・播放器共享元素、展开 / 收回动画与横屏播放器。

音质 当前按照 MeloX 的音质模型接入网易云音乐播放接口： ・标准：standard ・高品质：exhigh ・无损：lossless ・Hi-Res：hires ・高清环绕声：jyeffect ・沉浸环绕声：sky ・超清母带：jymaster 实际可播放音质由歌曲资源、账号权益、地区以及网易云音乐服务端返回结果共同决定。请求的目标音质不可用时会按可用资源进行降级，并尽量显示服务端实际返回的音质等级。

歌词 ・LRC 逐行歌词； ・YRC 官方逐字歌词； ・当前行跟随与滚动； ・逐字进度渲染； ・当前行焦点、缩放与颜色过渡； ・Ruby 注音布局、翻译、间奏倒计时、点击跳转与长按分享； ・Apple Music 拖尾滚动、回弹、模糊、高光、长音与刷新率参数； ・EVA 动态构图、18 套具有独立构图/背景/排版/运动参数的 TextPV 模板； ・Skyline 横屏歌词与完整环境文字参数； ・系统媒体歌词、独立歌词通知和可拖动悬浮歌词。

HyperOS ・标准 Android 媒体通知与 MediaSession； ・可选 HyperOS 焦点通知 / 超级岛桥接； ・OEM 特性通过独立适配层实现，不作为普通 Android 设备的硬依赖。

社交、识曲与应用设置 ・一起听房间创建、加入、成员、进度和队列同步； ・联系人、会话、文字私信与站内分享； ・麦克风录音、网易云音频指纹、分段与持续听歌识曲； ・首次启动引导、剪贴板链接识别、页面/首页排序与内容功能开关； ・GitHub 版本检查、更新提示、项目许可与设置重置。

第三方音乐源 ・可在“音乐服务”中单独开启第三方音乐源设置并阅读专用协议；该功能完全由本地开关控制，不属于云控范围。 ・YouTube Music 接入基于 lladlam/Square 的双后端架构；InnerTube 模块已 vendored 到 android/innertube/，其源自 Metrolist，并保留 com.metrolist.innertube 包名。 ・Spotify 接入参考 lladlam/Square 的 Spotify backend 设计，播放引擎使用 librespot-java，目录和 OAuth 使用 Spotify Web API。 ・vivo 设备自动尝试接入 OriginOS 原子岛；不提供单独开关，不支持该能力的设备自动保留标准 Android 媒体通知。该适配使用阿里云文档所述的 notification.superx.* 本地通知扩展，不依赖 EMAS 远程推送。 ・支持导入 LX Music 兼容的 JavaScript 音乐源，并在受限 QuickJS 运行时中解析播放地址。 ・可配置 CHKSZ 个人 API Key，优先解析网易云、QQ音乐和酷狗歌曲；配置前需要前往 api.chksz.com 注册，目前仅支持 LinuxDo 用户注册。 ・第三方解析失败时才回退到对应平台的原生播放；歌词仍由 MeloX 自己的歌词路线处理。

平台范围 iOS Live Activity / Dynamic Island 已映射为 Android 媒体通知、歌词通知和可选 HyperOS 焦点通知；iOS 画中画歌词已映射为 Android 悬浮窗歌词。Apple Watch、watchOS 和 macOS 专属目标不属于 Android APK 的迁移范围。

Liquid Glass 在 Android 上使用 Kyant0 AndroidLiquidGlass 的原生 Backdrop 实现；具体效果仍受 Android 版本、GPU 与 OEM 合成器能力影响。