目录
导言
在本篇博客中,我们将学习如何使用C#和WinForms构建一个简单但功能强大的音乐播放器。我们将会介绍如何实现文件的选择和播放功能。
要求
要求1:
1. 程序应能够读取MP3文件,并播放其中的音频。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用WindowsMediaPlayer控件
要求2:
1. 程序应能够播放ogg文件。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用Nuget程序包中的Naudi.Vorbis控件
准备工作
在开始编写代码之前,我们需要进行一些准备工作。首先,确保你已经安装了Visual Studio,帮助我们编写和调试C#代码。其次,我们需要下载并安装所需的库,包括WMPLib
和NAudio.Vorbis
。这些库将帮助我们实现MP3和OGG格式的音乐文件播放功能
Install-Package WMPLib
Install-Package NAudio.Vorbis
程序架构设计
我们的音乐播放器将采用Windows窗体应用程序的形式。主要的程序逻辑将会在Form1.cs
文件中实现,其中包括文件选择、播放控制和异常处理等功能。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using WMPLib; // 引入WindowsMediaPlayer控件
using NAudio.Vorbis; // 引入Naudi.Vorbis程序包
using NAudio.Wave;
using System.IO;
using System.Threading;
using System.Diagnostics;
using System.Reflection.Emit;
namespace MusicPlayer
{
public partial class Form1 : Form
{
WindowsMediaPlayer wmp;
VorbisWaveReader vorbisReader;
public Form1()
{
InitializeComponent();
wmp = new WindowsMediaPlayer();
}
}
}
功能实现
文件选择与列表显示
首先,我们需要实现文件选择和列表显示的功能。用户可以通过点击按钮选择音频文件,选择的文件将会显示在列表框中,方便用户查看已添加的音乐文件。在这个部分中,我们定义了文件选择按钮 button1
的点击事件处理方法。当用户点击按钮时,将会弹出文件选择对话框,用户可以选择一个或多个音频文件。选择的文件路径将会显示在列表框 listBox1
中,并存储到 localmusiclist
中。
private void button1_Click(object sender, EventArgs e)
{
string[] files = { };
openFileDialog1.Filter = "选择音频|*.mp3;*.flac;*.wav;*.ogg";
//同时打开多个文件
openFileDialog1.Multiselect = true;
if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
//清空原有列表
listBox1.Items.Clear();
localmusiclist.Clear();
if (files != null)
{
Array.Clear(files, 0, files.Length);
}
files = openFileDialog1.FileNames;
string[] array = files;
foreach (string file in array)
{
listBox1.Items.Add(file);
localmusiclist.Add(file);
}
}
}
播放音乐方法
在这个部分中,我们定义了一个名为 musicplay
的方法,用于播放音乐文件。根据文件的扩展名,我们使用不同的方式进行播放。对于OGG格式的文件,我们使用 NAudio.Vorbis
库提供的 VorbisWaveReader
类来播放音乐,同时利用线程池来实现异步播放。对于其他格式的文件,我们使用 WindowsMediaPlayer
控件来播放。
private void musicplay(string file)
{
string extension = Path.GetExtension(file);
if (extension == ".ogg")
{
ThreadPool.QueueUserWorkItem(delegate
{
try
{
using (var vorbis = new VorbisWaveReader(file))
{
waveOut = new WaveOutEvent();
waveOut.Init(vorbis);
waveOut.Play();
while (waveOut.PlaybackState == PlaybackState.Playing)
{
Thread.Sleep(1000);
}
}
}
catch (Exception ex)
{
string filePath = "errorLog.txt";
// 使用StreamWriter将错误信息写入txt文件
using (StreamWriter writer = new StreamWriter(filePath, true))
{
writer.WriteLine("播放过程中发生错误: " + ex.Message);
}
// 打开txt文件以查看错误信息
Process.Start("notepad.exe", filePath);
}
});
}
else
{
axWindowsMediaPlayer1.URL = file;
axWindowsMediaPlayer1.Ctlcontrols.play();
}
}
停止播放方法
在这个部分中,我们定义了一个名为 all_stop
的方法,用于停止音乐的播放。此外,我们还定义了按钮 button2
的点击事件处理方法,以及列表框 listBox1
的选中项变更事件处理方法。这些方法都会调用 all_stop
方法来停止音乐的播放。
private void all_stop()
{
// 确保 waveOut 不是 null 并且正在播放
if (waveOut != null && waveOut.PlaybackState == PlaybackState.Playing)
{
waveOut.Stop();
}
axWindowsMediaPlayer1.Ctlcontrols.stop();
}
private void button2_Click(object sender, EventArgs e)
{
all_stop();
}
private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
{
all_stop();
string file = "";
if (localmusiclist.Count > 0)
{
file = localmusiclist[listBox1.SelectedIndex];
musicplay(file);
label1.Text = Path.GetFileNameWithoutExtension(file);
}
}
下一首按钮点击事件处理
在这个部分中,我们定义了按钮 button3
的点击事件处理方法。当用户点击按钮时,将会播放列表中的下一首音乐。如果已经播放到最后一首,则会从头开始播放。
private void button3_Click(object sender, EventArgs e)
{
if (localmusiclist.Count > 0)
{
string file = "";
int index = listBox1.SelectedIndex + 1;
if (index >= localmusiclist.Count()) { index = 0; }
file = localmusiclist[index];
label1.Text = Path.GetFileNameWithoutExtension(localmusiclist[index]);
musicplay(file);
listBox1.SelectedIndex = index;
}
}
完整代码
完整代码已经上传到gitee上,仓库归途/windows (gitee.com)https://gitee.com/xi-way/windows
总结
在本博客中,我们介绍了如何使用C#和WinForms构建一个简单但功能强大的音乐播放器。我们从准备工作开始,安装所需的库,并讨论了程序的架构设计。然后,我们详细介绍了程序中实现的各个功能模块,包括文件选择与列表显示、音乐播放方法、停止播放方法以及下一首按钮点击事件处理。
通过这个简单的音乐播放器项目,我们学习了如何利用C#语言和WinForms框架来实现一个实用的 应用程序。我们深入了解了如何处理音乐文件的选择和播放,以及如何处理可能出现的异常情况。同时,我们也学习了如何使用第三方库来支持不同格式的音频文件的播放。
未来改进的方向包括界面优化、错误处理改进、功能扩展、代码优化和性能优化等。通过持续改进和学习,我们可以使这个音乐播放器变得更加完善、稳定和用户友好。
-
功能实现: 代码实现了基本的功能,包括文件选择、音乐播放、暂停和停止等。通过使用
WindowsMediaPlayer
控件和NAudio.Vorbis
库,实现了对不同格式音乐文件的播放支持。 -
异常处理: 程序对可能出现的异常情况进行了处理,但错误信息仅以弹窗和日志文件形式显示,可以更友好地提供用户反馈。
-
界面设计: 界面简洁明了,缺乏一些美观性,可以根据自我需求,考虑改进界面设计,提升体验。
-
代码结构: 代码结构清晰。