更新README

This commit is contained in:
LanZhan-Harmony
2026-04-26 11:57:07 +08:00
parent 28aa1be4f2
commit cf86051797
4 changed files with 56 additions and 5 deletions

View File

@@ -17,6 +17,7 @@
安装 Visual Studio 2026 时,请勾选以下工作负载:
- **使用 C++ 的桌面开发**
- **WinUI 应用程序开发**
![Visual Studio 组件安装图](/Docs/Images/VisualStudioComponent.png)
@@ -37,6 +38,14 @@ git clone https://github.com/LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicP
等待 Visual Studio 自动还原 NuGet 依赖包。
### 5. 编译并运行
### 5. 编译 BassAudioEngine
右击 `BassAudioEngine` 项目,选择“生成”以编译音频引擎。
![编译 BassAudioEngine 图](/Docs/Images/BuildBassAudioEngine.png)
### 6. 编译运行 Untamed Music Player
右击 `Untamed Music Player` 项目,选择“设为启动项目”。
![设为启动项目图](/Docs/Images/SetStartupProject.png)
点击工具栏中的"**▶ Untamed Music Player (Package)**"按钮开始调试和运行应用程序。

View File

@@ -37,6 +37,14 @@ Open the `UntamedMusicPlayer.slnx` file in Visual Studio.
Wait for Visual Studio to automatically restore the NuGet dependencies.
### 5. Build and Run
### 5. Compile BassAudioEngine
Right-click on the `BassAudioEngine` project and select "Build" to compile the audio engine.
![Build BassAudioEngine](Images/BuildBassAudioEngine.png)
### 6. Build and Run Untamed Music Player
Right-click on the `Untamed Music Player` project and select "Set as StartUp Project".
![Set as StartUp Project](Images/SetStartupProject.png)
Click the "**▶ Untamed Music Player (Package)**" button in the toolbar to start debugging and running the application.

View File

@@ -35,7 +35,7 @@ A modern music player for online and local music streaming
- 📝 **Immersive Lyrics Experience** - Dual-mode lyrics display with embedded and floating options, supporting custom
fonts
- 🎛️ **Professional Audio Control** - Built-in variable speed playback with WASAPI exclusive mode output support
- 🎨 **Exquisite Visual Design** - Multiple Mica/Acrylic material themes, cover-based dynamic backgrounds, elegant and
- 🎨 **Exquisite Visual Design** - Multiple Mica/Acrylic material themes, cover-based dynamic backgrounds, bouncy animation, elegant and
modern interface
- 🔄 **Deep System Integration** - System Media Transport Control (SMTC) support, file association launch, and
notification push
@@ -55,6 +55,10 @@ A modern music player for online and local music streaming
- **ARM64** - For ARM 64-bit systems (e.g., Surface Pro X)
- **x86** - For 32-bit systems (Less common)
## ❗ Important Notes
The batch selection function for songs has not been implemented yet. Currently, it is normal that clicking the checkbox in front of a song does not respond.
## 📱 Application Interface
<div align="center">
@@ -107,6 +111,16 @@ Current translation status:
| Simplified Chinese (简体中文) | zh-Hans | ✅ | ✅ | LanZhan-Harmony |
| Traditional Chinese (繁體中文) | zh-Hant | ✅ | - | Machine Translation |
## ⭐ Star History
<a href="https://www.star-history.com/?repos=LanZhan-Harmony%2FWindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=bottom-right">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=top-left" />
</picture>
</a>
## 🙏 Acknowledgments
Special thanks to the following open-source projects and developers for their support and inspiration:
@@ -114,6 +128,7 @@ Special thanks to the following open-source projects and developers for their su
- [Disenchant UWP Music Player](https://github.com/DenryDu/Disenchant-Music-Player)
- [C# Netease Cloud Music API](https://github.com/wwh1004/NeteaseCloudMusicApi)
- [ScreenBox](https://github.com/huynhsontung/Screenbox)
- [Character-Map-UWP](https://github.com/character-map-uwp/Character-Map-UWP)
## 📚 Project Dependencies

View File

@@ -29,9 +29,9 @@
- 🎵 **全格式音频播放** - 支持 MP3、FLAC、OPUS、OGG 等 20+ 种音频格式,本地与在线音乐无缝切换
- 🌐 **在线音乐搜索** - 集成在线音乐 API支持在线搜索、播放歌曲、专辑、歌单及艺术家
- 🗂️ **智能音乐管理** - 按艺术家、专辑、歌单多维度分类,支持 M3U8 播放列表导入导出
- 📝 **沉浸歌词体验** - 内嵌与灵动词岛双模式歌词显示,支持字体自定义
- 📝 **沉浸歌词体验** - 内嵌与灵动词岛双模式歌词显示,支持字体字号自定义
- 🎛️ **专业音效控制** - 内置变速播放,支持 WASAPI 独占模式输出
- 🎨 **精致视觉设计** - 多种 云母/亚克力 材质主题,封面取色动态背景,优雅现代的界面
- 🎨 **精致视觉设计** - 多种云母亚克力材质主题,封面取色动态背景,Q弹动效优雅现代的界面
- 🔄 **系统深度整合** - 系统媒体传输控制SMTC支持文件关联启动通知推送
- 📋 **灵活队列管理** - 随机播放、单曲循环、列表循环,支持播放队列自由编辑
@@ -49,6 +49,14 @@
- **ARM64** - 适用于 ARM 64 位系统(如 Surface Pro X
- **x86** - 适用于 32 位系统(较少使用)
## ❗ 注意事项
批量选择歌曲功能暂未实现,目前点击歌曲前的复选框没有反应是正常现象。
## 📢 社区
交流群: [QQ群](https://qm.qq.com/q/fwxkEjwlDa) (548076820)
## 📱 应用界面
<div align="center">
@@ -100,6 +108,16 @@
| 简体中文 | zh-Hans | ✅ | ✅ | LanZhan-Harmony |
| 繁体中文 (繁體中文) | zh-Hant | ✅ | - | 机器翻译 |
## ⭐ Star 历史趋势
<a href="https://www.star-history.com/?repos=LanZhan-Harmony%2FWindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=bottom-right">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=LanZhan-Harmony/WindowsMusicPlayer-TheUntamedMusicPlayer&type=date&legend=top-left" />
</picture>
</a>
## 🙏 致谢
特别感谢以下开源项目和开发者的支持和灵感:
@@ -107,6 +125,7 @@
- [离幻 UWP 音乐播放器](https://github.com/DenryDu/Disenchant-Music-Player)
- [C# 版网易云音乐 API](https://github.com/wwh1004/NeteaseCloudMusicApi)
- [ScreenBox](https://github.com/huynhsontung/Screenbox)
- [Character-Map-UWP](https://github.com/character-map-uwp/Character-Map-UWP)
## 📚 项目依赖