在本博客中,我们将详细介绍如何使用C# Windows Forms创建一个功能齐全的音乐播放器,该播放器不仅可以播放本地音乐文件,还可以播放在线音乐,并支持音乐文件的下载功能。我们将使用Windows Media Player控件和NAudio库来实现这些功能。
1. 环境设置
首先,我们需要在Visual Studio中创建一个新的Windows Forms项目。确保你已经安装了以下NuGet包:
- `NAudio`:用于处理音频文件。
- `AxWindowsMediaPlayer`:用于播放本地和在线音频文件。
你可以通过NuGet包管理器安装这些包:
```bash
Install-Package NAudio
Install-Package AxWMPLib
```
2. 创建基本界面
我们需要在窗体上添加以下控件:
- `ListBox`:用于显示本地音乐文件列表。
- `Button`:用于打开文件、播放、停止、下一首、播放在线音乐和下载音乐文件。
- `TrackBar`:用于调整音量。
- `Label`:用于显示当前播放的音乐文件名和音量。
- `TextBox`:用于输入在线音乐的URL和下载URL。
以下是设计器代码,用于初始化控件(假设你已经在设计器中添加了这些控件):
```csharp
// 初始化控件代码
this.button1 = new System.Windows.Forms.Button();
this.button2 = new System.Windows.Forms.Button();
this.button3 = new System.Windows.Forms.Button();
this.button4 = new System.Windows.Forms.Button();
this.button5 = new System.Windows.Forms.Button();
this.button6 = new System.Windows.Forms.Button();
this.textBoxOnlineUrl = new System.Windows.Forms.TextBox();
this.textBoxDownloadUrl = new System.Windows.Forms.TextBox();
this.listBox1 = new System.Windows.Forms.ListBox();
this.trackBar1 = new System.Windows.Forms.TrackBar();
this.label1 = new System.Windows.Forms.Label();
this.label2 = new System.Windows.Forms.Label();
this.axWindowsMediaPlayer1 = new AxWMPLib.AxWindowsMediaPlayer();
((System.ComponentModel.ISupportInitialize)(this.trackBar1)).BeginInit();
((System.ComponentModel.ISupportInitialize)(this.axWindowsMediaPlayer1)).BeginInit();
this.SuspendLayout();
3. 代码功能介绍:
上述代码实现了一个功能丰富的音乐播放器应用程序,具有以下功能:
### 1. 本地音乐文件的选择和播放
- **文件选择**:
- 使用 `OpenFileDialog` 允许用户选择多个本地音乐文件(mp3、wav、flac 格式)。
- 选中的文件路径会显示在 `ListBox` 控件中,并存储在 `localmusiclist` 列表中。
- **播放控制**:
- 用户可以通过选择 `ListBox` 中的项来播放对应的音乐文件。
- 播放器会显示当前播放的文件名(不含扩展名)。
### 2. 音量控制
- **音量滑块**:
- 使用 `TrackBar` 控件来调整播放器的音量。
- 当前音量百分比显示在标签(`Label`)控件中。
### 3. 播放控制
- **停止播放**:
- 提供停止按钮,用户可以随时停止当前播放的音乐。
- **播放下一首**:
- 提供播放下一首的功能,根据当前选中的索引播放列表中的下一首音乐。
### 4. 播放 OGG 文件
- **OGG 文件播放**:
- 使用 `OpenFileDialog` 选择 OGG 文件,并使用 `NAudio` 库中的 `VorbisWaveReader` 和 `WaveOutEvent` 播放 OGG 格式的音乐文件。
### 5. 在线音乐播放
- **播放在线音乐**:
- 提供一个文本框(`TextBox`)让用户输入在线音乐文件的 URL。
- 播放器通过输入的 URL 播放在线音乐,并显示当前播放的 URL。
### 6. 音乐文件下载
- **下载音乐文件**:
- 提供一个文本框(`TextBox`)让用户输入要下载的音乐文件的 URL。
- 使用 `WebClient` 从指定 URL 下载音乐文件,并保存到用户选择的路径。
### 详细功能总结
1. **文件选择和播放**:
- 用户可以选择本地音乐文件并添加到播放列表。
- 选中的文件会显示在列表框中,可以点击列表项播放音乐。
2. **音量控制**:
- 使用滑块调整音量,滑块的值直接影响播放器的音量设置,并显示当前音量百分比。
3. **播放控制**:
- 提供停止播放和播放下一首音乐的功能,方便用户控制播放进度。
4. **播放 OGG 文件**:
- 支持播放 OGG 格式的音乐文件,使用 `NAudio` 库实现。
5. **在线音乐播放**:
- 支持从 URL 播放在线音乐,用户只需输入有效的音乐 URL 即可播放。
6. **音乐文件下载**:
- 支持从 URL 下载音乐文件,并保存到本地,用户可以选择下载路径。
### 应用程序界面
- 应用程序包含多个按钮、文本框、列表框、标签和滑块,用户可以通过这些控件实现上述功能。
这段代码实现了一个完整的音乐播放器应用,支持本地音乐文件的选择和播放、在线音乐播放、音量控制、播放控制、OGG 文件播放以及音乐文件下载功能。
4. 实现音乐播放器的功能
我们将实现以下功能:
1. **本地音乐播放**:允许用户选择多个音频文件并添加到列表中,点击列表项播放音乐。
2. **在线音乐播放**:用户输入在线音频文件的URL并播放。
3. **音乐文件下载**:用户输入音频文件的URL并下载到本地。
4. **音量调节**:通过滑动条调节音量。
以下是实现这些功能的完整代码:
using AxWMPLib;
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Windows.Forms;
using NAudio.Wave;
using NAudio.Vorbis;
namespace WindowsFormsApp3
{
public partial class Form1 : Form
{
string[] files; // 用于存储选择的文件路径
List<string> localmusiclist = new List<string>(); // 用于存储本地音乐文件路径的列表
public Form1()
{
InitializeComponent();
}
// 音乐播放方法
private void musicplay(string filename)
{
// 获取文件扩展名
string extension = Path.GetExtension(filename);
if (extension == ".ogg")
{
Console.WriteLine("这是ogg文件"); // 处理ogg文件
}
else
{
Console.WriteLine("这不是ogg文件"); // 处理其他文件
axWindowsMediaPlayer1.Ctlcontrols.play(); // 使用Windows Media Player播放
}
}
// 打开文件按钮点击事件
private void button1_Click(object sender, EventArgs e)
{
// 设置文件筛选器和允许多选
openFileDialog1.Filter = "选择音频|*.mp3;*.wav;*.flac";
openFileDialog1.Multiselect = true;
if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
// 清空列表框和文件数组
listBox1.Items.Clear();
if (files != null)
{
Array.Clear(files, 0, files.Length);
}
// 获取选择的文件名并添加到列表框和音乐列表中
files = openFileDialog1.FileNames;
foreach (string file in files)
{
listBox1.Items.Add(file);
localmusiclist.Add(file);
}
}
}
// 列表框选择项改变事件
private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
{
if (localmusiclist.Count > 0)
{
// 设置Windows Media Player的播放URL并播放音乐
axWindowsMediaPlayer1.URL = localmusiclist[listBox1.SelectedIndex];
musicplay(axWindowsMediaPlayer1.URL);
// 显示当前播放的文件名(不含扩展名)
label1.Text = Path.GetFileNameWithoutExtension(localmusiclist[listBox1.SelectedIndex]);
}
}
// 音量滑块滚动事件
private void trackBar1_Scroll(object sender, EventArgs e)
{
// 设置Windows Media Player的音量
axWindowsMediaPlayer1.settings.volume = trackBar1.Value;
label2.Text = trackBar1.Value + "%"; // 显示当前音量
}
// 停止按钮点击事件
private void button2_Click(object sender, EventArgs e)
{
// 停止播放
axWindowsMediaPlayer1.Ctlcontrols.stop();
}
// 下一首按钮点击事件
private void button3_Click(object sender, EventArgs e)
{
int nextIndex = listBox1.SelectedIndex;
if (localmusiclist.Count > 0)
{
// 获取下一首音乐的索引
nextIndex = (listBox1.SelectedIndex + 1) % localmusiclist.Count;
// 设置Windows Media Player的播放URL并播放音乐
axWindowsMediaPlayer1.URL = localmusiclist[nextIndex];
musicplay(axWindowsMediaPlayer1.URL);
// 显示当前播放的文件名(不含扩展名)
label1.Text = Path.GetFileNameWithoutExtension(localmusiclist[nextIndex]);
listBox1.SelectedIndex = nextIndex; // 更新列表框的选中项
}
}
// 播放OGG文件按钮点击事件
private void button4_Click(object sender, EventArgs e)
{
string oggFilePath = "";
OpenFileDialog openFileDialog = new OpenFileDialog();
openFileDialog.Filter = "播放音频|*.ogg";
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
oggFilePath = openFileDialog.FileName;
}
// 使用NAudio库播放OGG文件
using (var vorbis = new VorbisWaveReader(oggFilePath))
{
using (var waveOut = new WaveOutEvent())
{
waveOut.Init(vorbis);
waveOut.Play();
while (waveOut.PlaybackState == PlaybackState.Playing)
{
System.Threading.Thread.Sleep(1000);
}
}
}
}
// 播放在线音乐按钮点击事件
private void button5_Click(object sender, EventArgs e)
{
string onlineUrl = textBoxOnlineUrl.Text;
if (!string.IsNullOrEmpty(onlineUrl))
{
// 设置Windows Media Player的播放URL并播放在线音乐
axWindowsMediaPlayer1.URL = onlineUrl;
axWindowsMediaPlayer1.Ctlcontrols.play();
label1.Text = "Playing Online: " + onlineUrl; // 显示当前播放的在线音乐URL
}
else
{
MessageBox.Show("Please enter a valid URL."); // 提示用户输入有效的URL
}
}
// 下载音乐文件按钮点击事件
private void button6_Click(object sender, EventArgs e)
{
string downloadUrl = textBoxDownloadUrl.Text;
if (!string.IsNullOrEmpty(downloadUrl))
{
SaveFileDialog saveFileDialog = new SaveFileDialog();
saveFileDialog.Filter = "音频文件|*.mp3;*.wav;*.flac";
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
string savePath = saveFileDialog.FileName;
WebClient webClient = new WebClient();
webClient.DownloadFile(downloadUrl, savePath); // 下载文件到指定路径
MessageBox.Show("Download completed: " + savePath); // 提示下载完成
}
}
else
{
MessageBox.Show("Please enter a valid URL."); // 提示用户输入有效的URL
}
}
}
}
5. 测试和运行
现在,你可以运行你的应用程序,测试本地音乐播放、在线音乐播放和音乐文件下载功能。
6. 结论
通过本博客,你应该已经学会了如何使用C# Windows Forms和NAudio库来创建一个功能强大的音乐播放器。这个播放器不仅支持本地音乐文件的播放,还可以播放在线音乐,并且支持将音乐文件下载到本地。希望这个教程对你有所帮助!
如果你对这些功能有更多的需求,可以继续扩展,例如添加播放列表管理、歌词显示、更多的音频格式支持等。祝你在编程之路上不断进步!