MD3Music最新版

使用Flutter&Rust构建的现代Material3音乐播放器。开源音乐播放器，基于酷狗音乐API，采用MaterialDesign，无需额外服务器即可使用。支持在线与本地音乐播放，内置歌词辉光、均衡器、DLNA投屏、云盘音乐等丰富功能，同时支持平板、车机、TV、Windows，自定义程度很高。

软件介绍

MD3Music是一款基于酷狗音乐API的Flutter音乐播放器，内置嵌入式RustAPI服务器，占用外部服务器即可使用。支持手机/平板、Windows桌面、车机与AndroidTV，提供MD3与AppleMusic风格播放页、逐字歌词和多种音频输出能力。

✨ 功能特性

• 在线音乐— 搜索、每日推荐、排行榜、新碟上架、听歌识曲、私人FM、歌单/专辑/歌手/评论/MV、云盘、听书、场景音乐、频道、刷刷短视频、一起听、刷歌推荐

• 本地音乐—文件夹浏览、内嵌封面与歌词、本地收藏、音质标签、多维度排序、在线歌曲元数据智能匹配；Android支持扫描系统授权目录中的U盘等外部存储音乐

• 播放体验—多音质选择（标准/高质量/无损/高分辨率）、USB独占布局、均衡器、AutoMix无缝过渡、度响均衡、DLNA投屏、睡眠定时、倍速、进度记忆、画中画

• 视觉效果—动态封面、3D景深封面、流动背景，歌曲/MV弹幕支持透明度、速度与颜色设置

• 歌词显示— Apple Music 风格逐字歌词（KRC/LRC），支持翻译/罗马音、辉光、模糊、动态取色，以及桌面/锁屏/蓝牙歌词与lyricinfo lyricon词幕 SuperLyric Flyme歌词协议

• 用户中心— VIP三签到、多账号管理、听歌等级/排行/识曲、与播放收藏历史、桌面小组件

• 个性化—MD3E/AM双风格、主题色与动态取色、深度模式、自定义壁纸与字体；文字全局及多种播放页歌词颜色独立设置，支持双栏开关（左右各50%）、悬浮迷你播放器与主页选项卡管理

• 设置还原—设置项搜索、一键默认设置并保留登录状态

• Windows桌面—便携版、系统托盘、SMTC系统媒体控制、桌面歌词、全屏/沉浸式播放页，版本以及检查、镜像下载与便携版更新

• 车机模式—自适应播放面板、左右停靠与底部停靠避让

• 电视端—背光焦点导航、播放/歌词/评论交互及播放队列操作

• AI代理—内置MCP接入，支持搜索、播放控制和歌词查询，提供串口模式及写操作确认；默认关闭，支持HTTP / stdio桥接

核心特点

• 嵌入式 Rust 服务器— App 启动时通过libkugou_server.so（JNI/MethodChannel）启动本地tiny_http 服务器（127.0.0.1），所有酷狗 API 请求在本地处理

• 性能低资源— Rust 实现取代 Node.js 方案，内存占用负载，启动更快

• 消耗外部服务器—用户自行消耗搭建服务器API

• 多架构支持—支持armeabi-v7a（32位）、arm64-v8a（64位）、x86、x86_64（模拟器）

• 本地投屏支持—内置消防服务器HTTP（支持Range请求），本地音乐也能投屏到DLNA设备

🔧 常见问题

问：有没有Windows版本？

A：有。可以直接从GitHub Releases下载Windows便携版ZIP；也可以从公开源码自行构建。前置要求：

• Windows 10/11 x64 + Flutter（稳定版）+ Rust（稳定版，cargo ≥ 1.85）

• Visual Studio Build Tools 2022：勾选「使用 C++ 的桌面开发」工作负载，并另外勾选 C++ ATL 组件（flutter_secure_storage_windows需要atlstr.h）

• 构建期间可访问NuGet（permission_handler_windows需要下载相关构建依赖）

公开仓库透明度scripts/md3.ps1，请从仓库根目录直接运行独立脚本：

powershell -ExecutionPolicy Bypass -File .\scripts\tasks\windows.ps1

脚本会构建 Rust 桌面版kugou_server.dll、Flutter Windows 应用并文件夹 VC++ 运行库，产品为build\windows\md3music-windows-<版本>.zip。解压后运行md3music.exe即可。Android 独有功能（如 USB 独占输出、主屏小组件）在 Windows 上不可用，属预期。默认产品商标 3D 封面（kDepthCoverAvailable为 false）；需要时加-With3D，脚本会按固定版本下载 ONNX Runtime 运行时并把深度模型一起打进包里。

Q:应用启动后无法搜索或播放音乐？

A：检查日志确认Rust服务器是否成功启动。在Android Studio Logcat中搜索KugouApiService查看启动日志。

问：登录功能无法使用？

A: 登录/注册/验证码已全部本地化：由嵌入式Rust服务器直连酷狗官方接口处理，不再依赖第三方。请确保设备可正常联网，并在Logcat中搜索KugouApiService确认本地服务器已成功启动。

Q：如何修改API服务代码？

A: 修改kugou_api_server/rust/src/下的Rust代码，运行cargo build --release编译验证，安卓侧执行./build_android.sh交叉编译，再重新编译App。

问：为什么 Rust 服务器需要 NDK？

A: Rust 的 TLS 依赖（ringcrate）需要交叉编译为 Android 平台的.so文件。NDK 提供了aarch64-linux-android-clang等交叉编译工具链。

Q：设置里找不到「状态栏歌词」开关？

A：该开关仅在魅族Flyme上出现（由设备能力探测决定），其他品牌不显示。

Q: 切歌提示只能看MV A: 登录过渡或者没有登录 

更新内容

v6.2.0

新增AppleMusic播放页面普通样式选项及搜索索引

重构发现页面区块与搜索探索入口，恢复并支持配置推荐内容

调整桌面端侧边栏导航与新碟数量，删除新碟折叠功能

优化大屏自适应、Windows默认缩放及TV双栏布局切换

修复TV缩小视口焦点无法进入列表及显示缩放后焦点框偏移

添加Windows3D封面文件夹参数与DartFFI推理思考

修复Windows3D封面卡死、AI修复开关故障及深度图颜色异常

修复图片修复未生效及多平台壁纸双栏背景透明性问题

新增桌面端缓冲提示与播放页时间行中央状态胶囊

重构提示逻辑，修复文档条后提示不显示

新增暂停后自动停止保活的省电设置

修复本地音乐封面空白、USB存储扫描及媒体访问问题

修复专辑跨分页加载歌曲不完整及在线封面加载失败问题

新增歌词辉光强度设置，重构三层辉光与抗锯齿渲染效果

新增歌词上方行已播放颜色开关及动态混色比例配置

优化AppleMusic歌词离屏渲染激活，提升抗锯齿效果

新增弹幕速度、透明度、颜色及仅看弹幕设置，并完善分组设置

修复弹幕设置进入播放页运行、随机颜色及镜像配置回填问题

新增Windows便携版自动更新、镜像下载及项目地址入口

修复Windows更新交接、文件锁冲突、弹窗布局及诊断恢复问题

完美车机歌词同步、深链截图、配合直达歌词及自动续播

修复车机与Vivo原子岛的点播、高亮、循环、收藏及列表刷新问题

新增Vivo原子随身听当前、收藏、本地列表及三项媒体控制能力

修复Vivo、车机相关编译错误、生命周期竞态、连接认证与前台服务问题

优化播放页封面重试、静态监听释放、加载竞态及深链守卫

为色彩圆盘引入共享旋转相位，修复转场角度错位

优化音频解码器能力展示逻辑与文案

修复AndroidSAF扫描器发布编译及脚本处理单行Git输出问题