myMusic音乐平台APP官方版

想听歌，手机上一个App、电视上另一个App、平板上又得重新登录一遍，歌单还不互通。这种被平台和设备割裂的感觉，开源项目往往能给出另一种解法。myMusic是一款面向Android 6.0及以上设备的音乐客户端，由mytv-android开发，项目在GitHub上开源。它用Jetpack Compose和Material 3构建界面，手机、平板、折叠屏和电视共用同一套焦点与播放操作，触摸、鼠标、键盘和遥控器都能用。核心能力是跨平台聚合：单曲、专辑、歌单并行查询网易云、QQ、酷狗、酷我、咪咕等已启用的平台，同一录音合并展示，榜单或歌单里的曲目可以在其他平台按需检索同一版本并播放，某个平台没有播放地址时自动回退并保留进度。同步歌词支持标准LRC逐行高亮和逐字时间轴，带卡拉OK式填充。海报墙、桌面小组件、后台播放、离线缓存、音乐库同步和均衡器也都有覆盖。应用代码采用AGPL-3.0许可证，属于学习项目，需遵守所在地法律和各音乐平台服务条款。

版本主要特点

跨平台聚合与换源播放：

单曲、专辑、歌单并行查询已启用的平台，默认包含网易云、QQ、酷狗、酷我、咪咕。单曲按同一录音合并，专辑按名称、艺人和曲目数保守分组。

榜单或歌单中的曲目可以在其他平台按需检索同一版本并播放，所选平台没有返回播放地址时自动回退到其他来源并保留播放进度。来源面板支持拆分，搜索结果支持合并，匹配策略可配置。

多设备适配与遥控器操作：

手机、平板、折叠屏和电视共用同一套焦点与播放操作。平板840至1199dp使用底部播放条，1200dp以上右侧常驻播放窗格；电视使用全屏播放页，空闲后进入只显示封面和歌词的环境模式。

折叠屏半折成书本姿态时左页封面右页歌词，桌面姿态时上半屏歌词下半屏控制，横跨双屏按铰链分块。触摸、鼠标、键盘和遥控器都能完成播放控制。

同步歌词与歌词背景律动：

标准LRC逐行高亮和自动滚动；带逐字时间轴的源在当前行按字做卡拉OK式填充，播放中用帧时钟逐帧推进。

歌词背景律动可选，取自封面颜色的流光场随真实音频变化：响度调节流速，低中高频调节光团大小和光量，低频鼓点让光团胀开。分析在本机完成，不申请麦克风权限，不保存或上传音频。

海报墙与桌面小组件：

播放队列可以切成一面封面墙，曲目按大小不一的格子铺开、向四周无限延伸，四向拖动，点格放大再播放。歌单、专辑、榜单详情页可一键切换海报视图。

六款桌面小组件包括正在播放、歌词、听歌模式、榜单、歌单和快捷入口，按组件实际大小换版式，颜色和深浅跟随App外观设置。

核心功能内容

聚合搜索与结果合并：

提交搜索后并行查询已启用平台，结果按同一录音合并，逐条标出各平台是完整、试听、VIP还是没有音源，不只靠颜色区分。

单曲聚合搜索支持加载更多。粘贴链接会自动识别并显示解析链接。聚合结果与匹配缓存保存在本机数据库，播放地址只存在内存中，不上传服务器。

播放、后台与离线缓存：

切到后台或锁屏后继续播放，保留系统媒体通知与控制。播放队列和位置存在本机，进程被回收后从上次位置接着放。

播放过的音频自动缓存，缓存上限可在设置中调整，调低后立即按最近使用淘汰。下载按钮把音频保存到应用目录，已完成下载优先作为本地音源，网络不可用时也能从本地文件播放。

音乐库同步与账号管理：

同步自建歌单、收藏和平台账号Cookie，后端支持GitHub Gist与Gitee代码片段，也可导入导出本机JSON。

三个版本逐歌单合并，两边都修改同一歌单时不会静默覆盖，可选择合并两版、保留本机或使用云端。删除使用墓碑，不会把已删除歌单重新创建。令牌加密后只保存在本机。

均衡器与音量均衡：

均衡器绑定当前播放会话，按设备实际频段绘制五段或更多滑杆，提供平直、流行、摇滚、爵士、人声和自定义预设。

音量均衡用平台返回的响度元数据自动调整每首歌的增益并做峰值限幅，没有元数据的歌曲改用实时AGC加峰值限幅兜底，不采样、不修改音频文件。

开源与构建说明：

应用代码与纳入的music-lib均使用AGPL-3.0许可证。项目为学习项目，请遵守所在地法律和各音乐平台服务条款，不要将程序或下载内容用于商业用途。

推送到main或dev时GitHub Actions会构建Android 6.0以上通用APK，并随Release发布update.json和SHA-256文件。应用更新通过GitHub Release检查，下载后校验SHA-256、包名、版本号和签名再打开系统安装器。

新手玩机操作指南

1. 进入应用的“榜单”页面，可切换“网易云音乐”“QQ音乐”等平台，查看飙升榜、新歌榜等热门曲目。

2. 点击底部“歌单”选项，切换到歌单界面，可浏览平台推荐歌单，也能切换分类查找音乐。

3. 点开底部“搜索”页，在搜索框输入“张杰”，选择“单曲”标签，查看跨平台的歌曲搜索结果。

4. 在搜索列表选中歌曲“渡口”，进入播放页面，可控制暂停、切歌，查看歌曲音源信息。

5. 点击歌曲的更多按钮，弹出操作菜单，可对歌曲执行“收藏”、“下载”、加到歌单等操作。

首次使用与基础设置：

1、从GitHub Release页面下载最新APK安装，或通过项目配套的易用TV助手在电视上一键安装。安装前确认设备为Android 6.0及以上。

2、打开应用后进入主界面，四个入口为榜单、歌单、搜索、我的。手机在“我的”右上角进入设置，平板和电视在导航栏底部进入设置。

3、在设置中配置聚合平台、播放策略、优先平台和匹配严格度。默认启用网易云、QQ、酷狗、酷我、咪咕，可按需增减。

4、需要跨设备同步时，在音乐库同步中配置GitHub Gist或Gitee代码片段，填写令牌和文件ID。令牌加密后只保存在本机。

5、在设置的外观中调整配色来源、对比度、纯黑背景、模糊和减少动画。电视、低内存设备和Android 12以下默认关闭实时模糊。

播放与歌词操作：

1、手机底部是悬浮迷你播放器，点按打开播放页，左右滑切歌，上滑展开，长按打开队列。可在设置中把点按行为改成打开海报墙。

2、播放页封面铺满并延伸到状态栏下，背景是缓慢流动的封面光。控件4秒无操作后隐藏，点屏幕唤出。

3、在封面上左右滑切歌、双击收藏。歌名下常驻两行歌词，点开是全屏歌词，点某一行跳到该处播放。

4、定时关闭可选15、30、45、60分钟或播完当前歌曲，结束前30秒淡出，计时在播放服务里，后台和锁屏都有效。

5、电视上使用遥控器方向键移动焦点，播放页空闲后进入环境模式，只显示封面和歌词。按Home、切到别的应用或连按两次返回退出时暂停播放。

换源、识曲与同步：

1、榜单或歌单中的曲目播放失败时，应用会自动回退到其他来源并保留进度。也可以在来源面板手动选择其他平台。

2、搜索结果中的条目可以拆分或合并到当前曲目，把其他版本合并进同一录音。匹配有误时可在设置中恢复自动匹配。

3、搜索栏右侧的波形按钮录音12秒进行听歌识曲，同时查询网易云和酷狗两个通道，结果按歌名和歌手合并，点一条直接播放。首次使用会申请麦克风权限，电视和无麦克风设备不显示入口。

4、自建歌单、收藏和平台Cookie通过Gist或Gitee同步。修改后约1秒防抖推送，离线时自动重试，推送后会再读云端并重新合并，避免两台设备停在旧版本。

常见问题答疑

Q：myMusic是免费的吗？有广告吗？

A：myMusic是开源项目，应用代码采用AGPL-3.0许可证，免费使用，没有内置广告。

项目定位为学习项目，请遵守所在地法律和各音乐平台服务条款，不要用于商业用途。

Q：支持哪些设备？

A：面向Android 6.0及以上设备，支持手机、平板、折叠屏和电视。

触摸、鼠标、键盘和遥控器使用同一套焦点与播放操作。折叠屏和双屏针对书本姿态、桌面姿态和铰链分栏做了适配。

Q：聚合搜索支持哪些平台？

A：默认启用网易云、QQ、酷狗、酷我、咪咕五个平台，可在设置中增减。

单曲聚合搜索支持加载更多，其余平台目前返回第一页。换源播放会在所选平台没有播放地址时自动回退到其他来源。

Q：听歌识曲会上传录音吗？

A：网易云通道只在本机计算3秒指纹，不上传原始录音；酷狗通道会把8kHz单声道PCM上传到酷狗识曲接口。

两个接口都是非官方协议，可能随服务端调整失效。首次使用会申请麦克风权限。

Q：音乐库同步安全吗？

A：同步自建歌单、收藏和平台Cookie，Cookie会以明文写入私密Gist或代码片段，请勿公开文件链接。

最近播放、下载文件、播放地址和播放进度不上传。令牌加密后只保存在本机，不进入数据库、日志或同步文件。

适用人群与场景

多设备听歌用户：

手机、平板、电视都用，希望一个客户端覆盖所有设备。myMusic的跨设备适配和统一操作逻辑省去了在多个App之间切换的麻烦。

跨平台找歌的听众：

歌曲分散在网易云、QQ、酷狗等不同平台，不想为了某首歌专门开会员。聚合搜索和换源播放可以在已启用平台之间找同一版本。

电视端音乐用户：

想在电视上听歌，但多数音乐App的电视适配粗糙。myMusic针对电视做了全屏播放页、遥控器焦点操作和环境模式，适合客厅场景。

开源爱好者与技术用户：

项目在GitHub开源，采用AGPL-3.0许可证，支持自行构建和签名配置。适合关注开源项目、愿意阅读文档和反馈问题的用户。

同类型热门开源音乐客户端推荐

测评总结

myMusic在开源音乐客户端里做出了自己的定位：不是只服务手机，而是把手机、平板、折叠屏和电视都纳入了同一套操作逻辑。聚合搜索和换源播放解决了歌曲分散在多个平台的问题，同一录音合并和状态透明让用户清楚知道每首歌在各平台是可播、试听还是VIP。同步歌词的逐字填充和歌词背景律动是体验上的加分项，海报墙和六款桌面小组件把播放界面延伸到了桌面。折叠屏的书本姿态、桌面姿态和铰链分栏适配做得比较细，电视上的遥控器焦点和环境模式也考虑了实际使用场景。AGPL-3.0开源、无广告、支持自行构建，对技术用户友好。

缺点是聚合依赖各平台非官方接口，接口调整时可能失效；部分平台的封面和音频CDN仍使用http，公共Wi-Fi下需注意风险；作为学习项目，长期维护和稳定性取决于开发者投入。如果你是多设备用户、喜欢跨平台找歌、又愿意接受开源项目的不确定性，myMusic值得试试；如果你只需要在手机上稳定听某个平台的歌，官方App可能更省心。

更新日志

版本：v1.0

支持折叠屏与双屏：书本/桌面姿态、铰链分栏、弹窗避开折痕。

新增海报墙、六款桌面小组件、歌词背景律动与听歌识曲功能。

跨平台聚合搜索、换源播放、音乐库同步与均衡器功能完善。