# 基于Qt的高仿酷狗音乐播放器客户端 **Repository Path**: a-mo-xi-wei/KuGouApp ## Basic Information - **Project Name**: 基于Qt的高仿酷狗音乐播放器客户端 - **Description**: Based on Qt Widget + UiTools module + Custom control + QSS + QsLog + Custom Spdlog，CMake进行模块化管理，参照酷狗播放器客户端，高仿并且优化界面，采用 FFmpeg 和 SDL 进行音频解码与播放来实现音频播放，有着丰富的自定义控件和事件响应，解决诸多难题如：遮罩绘图，控件拉伸，绘制特效等。 - **Primary Language**: C++ - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 132 - **Forks**: 44 - **Created**: 2024-08-27 - **Last Updated**: 2025-07-31 ## Categories & Tags **Categories**: multimedia **Tags**: Qt, JWT, JSON, MVC, Http ## README # 🎵 高仿酷狗音乐客户端 - 用Qt重塑极致音乐体验😌


🔥 🔥

🎁如果你喜欢该项目，请点击右上角的✨星星✨，你的 Star 是我最大的动力
本项目代码仅限研究和学习使用，资源版权归音乐平台所有

--- ### 本人开发工具用的是CLion，非常简便明了，编译的话，生成器使用Ninja，工具链请使用 **_MinGW_** , 不要用VS2022(MSVC)。构建类型选择Release（建议）的话，构建会快很多，Windows 10/11用户可以选择master分支(功能更多)一直在开发中，不保证稳定😜，master-with-docs文档版(文档有点大)，Stable稳定版(功能落后，不再维护)。 ![配置如图](image-show/settings00.png) ![配置如图](image-show/settings01.png) Ubuntu 下如果出现类似如下报错： ``` /home/xxx/Desktop/KuGou/tools/ccache/ccache: error while loading shared libraries: libhiredis.so.0.14: cannot open shared object file: No such file or directory ``` 请执行以下命令： ``` sudo apt install ccache rm YourProjectPath/KuGou/tools/ccache/ccache cp /usr/bin/ccache YourProjectPath/KuGou/tools/ccache ``` #### 同时，Ubuntu 下编译虽然能通过且能运行，但是对于鼠标事件的接受和样式渲染有问题，精力有限，不会去维护。。。 ### Ai对话功能需要预先获取API，有问题请参考：https://gitee.com/a-mo-xi-wei/qt6-access-deepseek#qt6-%E6%8E%A5%E5%85%A5deepseek | [Ubuntu/macOS][lin-link] | [Windows][win-link] | [License][license-link] | | :----------------------: | :-----------------: | :---------------------: | | ![lin-badge] | ![win-badge] | ![license-badge] | [lin-link]: https://你的Ubuntu/macOS构建状态链接 [win-link]: https://你的Windows构建状态链接 [license-link]: https://你的License文件链接 [lin-badge]: https://img.shields.io/badge/Ubuntu/macOS-Passing-lightgrey?logo=linux [win-badge]: https://img.shields.io/badge/Windows-Passing-success?logo=windows [license-badge]: https://img.shields.io/badge/License-MIT-blue.svg ### 📚项目介绍 Based on Qt Widget + UiTools module + Custom control + QSS + QsLog + Custom **Spdlog** + **JWT** + **FFmpeg** + **SDL** 使用**CMake**进行模块化管理，确保核心组件（如用户界面、媒体播放器和网络层）的**高度解耦**，参照酷狗客户端，高仿并且优化界面， 应用程序现采用 **FFmpeg** 和 **SDL** 进行音频解码与播放来实现音频播放，从而提供更灵活、更强大的音乐播放体验。 集成 **QsLog** 和自定义 **Spdlog** 实现健壮的日志系统，使用 JWT 确保安全的用户认证。采用**SQLite**存储音乐元数据（标题/专辑/路径），使用Qt SQL模块实现播放记录管理 通过 **QNetworkAccessManager** 实现在线音乐流媒体播放，结合 QtConcurrent 和 QFutureWatcher 实现非阻塞线程串行任务调度，基于 **QThreadPool** 构建动态弹性线程池，通过 QRunnable 封装任务单元，实现线程资源的自动回收。 项目难点：播放列表、搜索功能、菜单功能，歌词显示、播放控制等**播放器核心功能**设计问题，自定义控件和事件响应，遮罩绘图，控件拉伸，**特效绘制**， 复杂业务逻辑问题，登录注册、**Ai对话**、**数据库连接池**设计、**异步非阻塞式线程**设计、**日志系统**设计、**网络模块**设计、**开源库**（如 FFmpeg 和 SDL）的集成与优化，以提升媒体播放能力。 ## 🎨 界面技术栈 视觉魔法师：QSS样式引擎 + SVG矢量图标 + 动态渐变蒙版 交互黑科技：属性动画系统 + 智能布局适配 性能保障：双缓冲绘图 + 异步加载 + 局部刷新策略 ✅ 支持无损格式直通 ✅ 32段可视化均衡器 ✅ 动态响度补偿技术 ### 🔌 核心架构 ```mermaid flowchart TD %% 模块定义 subgraph 构建系统 CMakeModule["CMake模块化构建"] end subgraph 表现层 UILogic["UI逻辑层"] CustomWidgets["自定义控件库"] end subgraph 核心逻辑层 CoreCode["核心代码层"] KuGouClient["KuGouClient"] KuGouServer["KuGouServer"] end subgraph 第三方依赖层 ThirdParty["第三方管理层"] PoolAsyncNetwork["池化 异步 网络"] end %% 连接关系 CMakeModule -->|"数据/控制流"| UILogic CMakeModule -->|"数据/控制流"| CoreCode CMakeModule -->|"数据/控制流"| ThirdParty UILogic -->|"调用/交互"| CustomWidgets CoreCode -->|"业务逻辑调用"| KuGouClient CoreCode -->|"业务逻辑调用"| KuGouServer ThirdParty -->|"封装/使用"| PoolAsyncNetwork CustomWidgets -- UI事件回传 --> UILogic KuGouClient -- 网络请求 --> PoolAsyncNetwork KuGouServer -- 网络请求 --> PoolAsyncNetwork ``` ## 🛠️ 技术全景图 ### 0.登录注册界面 ![输入图片说明](image-show/image00.png) ![输入图片说明](image-show/image00-1.png) ### 1.为你推荐界面 ![输入图片说明](image-show/image01.png) ![输入图片说明](image-show/image01-1.png) ![输入图片说明](image-show/image01-2.png) ![输入图片说明](image-show/image01-3.png) ![输入图片说明](image-show/image01-4.png) ![输入图片说明](image-show/image01-5.png) ![输入图片说明](image-show/image02.png) ![输入图片说明](image-show/image03.png) ![输入图片说明](image-show/image04.png) ### 2.乐库界面 ![输入图片说明](image-show/image05.png) ![输入图片说明](image-show/image06.png) ### 3.频道界面 ![输入图片说明](image-show/image07.png) ### 4.视频界面 ![输入图片说明](image-show/image08.png) ![输入图片说明](image-show/image09.png) ![输入图片说明](image-show/image10.png) ### 5.Ai对话界面(略卡😅) ![](image-show/image35.png) ![](image-show/image36.png) ### 6.歌单界面 ![输入图片说明](image-show/image11.png) ### 7.每日推荐界面 ![输入图片说明](image-show/image12.png) ![输入图片说明](image-show/image13.png) ### 8.我的收藏界面 ![输入图片说明](image-show/image14.png) ![输入图片说明](image-show/image15.png) ### 9.本地与下载界面 ![输入图片说明](image-show/image17.png) ![输入图片说明](image-show/image18.png) ![输入图片说明](image-show/image20.png) ![输入图片说明](image-show/image21.png) ### 10.音乐云盘界面 ![输入图片说明](image-show/image22.png) ![输入图片说明](image-show/image23.png) ### 11.已购音乐界面 ![输入图片说明](image-show/image24.png) ### 12.最近播放界面 ![输入图片说明](image-show/image25.png) ![输入图片说明](image-show/image26.png) ### 13.全部音乐界面 ![输入图片说明](image-show/image27.png) ### 14.探索界面 ![输入图片说明](image-show/image28.png) ### 15.听书界面 ![输入图片说明](image-show/image29.png) ![输入图片说明](image-show/image30.png) ![输入图片说明](image-show/image31.png) ### 16.直播界面 ![输入图片说明](image-show/image32.png) ![输入图片说明](image-show/image33.png) ![输入图片说明](image-show/image34.png) --- 🌈 未来路线图 🛸 AI声纹识别：语音点歌+歌手识别 🌐 P2P音乐共享：分布式音乐网络 🔮 VR演唱会模式：3D音频空间化 🤖 智能推荐引擎：神经网络推荐算法 🔮 魔幻歌词系统 光流动画：仿OLED屏像素渐隐效果 卡拉OK模式：逐字染色+波形同步 双语对照：智能歌词时间轴对齐 --- ## 😊打赏
### 若文章有所感所获，亦可请我共饮一杯肥宅冰阔落~~