一、作业内容
编写一个C#程序,实现音乐文件的播放功能
要求1:
1. 程序应能够读取MP3文件,并播放其中的音频。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用WindowsMediaPlayer控件
要求2:
1. 程序应能够播放ogg文件。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用Nuget程序包中的Naudi.Vorbis控件
二、 设计思路分析与难点
1 、架构选择
选择Windows Forms作为开发平台,Windows Forms提供了一个简单而强大的方法来创建桌面应用程序,并且与C#高度兼容,在开发过程,我们选择.NETFramework 4.8.0进行程序设计。
2、设计思路
1.界面设计: 使用Windows Forms工具箱中的控件如按钮、标签和文件对话框构建用户界面。
2.功能编码: 使用OpenFileDialog允许用户选择音频文件。 使用WindowsMediaPlayer控件或其他相应播放器进行播放。 播放控制,包括开始、暂停和下一首。
3.异常处理: 捕获并响应各种可能的运行时错误,如文件读取失败、文件格式不支持等,为用户提供清晰的错误信息。
3 、难点分析
1.文件格式支持: 处理多种音频格式(MP3,OGG等)要求使用不同的库,这可能导致代码复杂度增加。
2.异常处理: 音频文件的播放中可能遇到多种异常情况,如文件损坏、编解码器不支持等。
4、窗体设计
实现窗体如下:
其中,各控件实现功能如下:
ListBox:展示选择的歌曲列表。
AxWindowsMediaPlayer:用于播放常规格式音乐(ogg无法用此播放)。
OpenFileDialog:用于选择音乐文件。
Button:用于添加歌曲文件、停止播放、下一曲的功能实现。
TrackBarl:用于音量控制。
三、代码实现
1、文件选择功能
Button1“添加音乐”代码
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);
}
}
openFileDialog1.ShowDialog() == DialogResult.OK;
}
在这部分,我们采用button
和openFileDialog
控件来实现文件的选择,Filter
用于筛选文件类型,使得用户只能选择音乐文件,不能选择其他文件导致后续功能无法实现报错,同时初始化一个files文件存放音乐文件的文件名。并且对选择的文件进行处理,首先,将所有变量清空,防止有残留影响后续程序执行,之后,将文件名添加到ListBox
中,显示出来用于选择音乐,同时,利用localmusiclist
变量存储文件名,并且作为类成员变量进行传输,方便后续对音乐的操作。
2、音乐选择功能
ListBox1代码
private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
{
if (localmusiclist.Count > 0)
{
axWindowsMediaPlayer1.URL= localmusiclist[listBox1.SelectedIndex];
musicplay(axWindowsMediaPlayer1.URL);
歌曲列表.Text =Path.GetFileNameWithoutExtension(localmusiclist[listBox1.SelectedIndex]);
}
}
在ListBox控件中,存在一个事件监听SelectedIndexChanged,利用该事件,我们可以去获取用户切换列表,SelectedIndex是获取目前列表中选择的序号,通过该序号和之前的localmusiclist,我们可以获取到音乐信息并且进行传参调用函数,进行音乐播放。
3、ogg音乐文件播放功能
musicplay代码
private void musicplay(string filename)
{
string extension=Path.GetExtension(filename);
if (extension == "ogg")
{
if (File.Exists(filename))
{
OpenFileDialog openFileDialog = new OpenFileDialog();
openFileDialog.Filter = "打开音频|*.ogg";
string oggFilePath = "";
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
oggFilePath = openFileDialog.FileName;
}
using (var vorbisReader = new VorbisWaveReader(oggFilePath))
{
using (var outputDevice = new WaveOutEvent())
{
outputDevice.Init(vorbisReader);
outputDevice.Play();
while (outputDevice.PlaybackState == PlaybackState.Playing)
{
System.Threading.Thread.Sleep(1000);
}
}
}
using (var vorbisStream = new VorbisWaveReader(oggFilePath))
{
// 创建WaveOutEvent实例来播放音频
using (var outputDevice = new WaveOutEvent())
{
outputDevice.Init(vorbisStream);
outputDevice.Play();
// 等待播放完成,或者你可以添加其他逻辑来处理播放过程
while (outputDevice.PlaybackState == PlaybackState.Playing)
{
System.Threading.Thread.Sleep(1000);
}
}
}
}
}
else
{
Console.WriteLine("this is not ogg");
axWindowsMediaPlayer1.Ctlcontrols.play();
}
}
首先,获取当前文件名的后缀信息,判断文件类型。若是ogg
文件,调用NAudio
第三方库总的Vorbis
和Wave
类来实现播放音乐。若是其他类型的文件,使用C#原生库中的WindowsMediaPlayer
控件实现播放。
4、停止播放
Button2“停止播放”代码
private void button2_Click(object sender, EventArgs e)
{
if (waveOut.PlaybackState == PlaybackState.Playing)
{
waveOut.Pause(); // 暂停播放OGG
}
axWindowsMediaPlayer1.Ctlcontrols.stop();
}
停止播放功能也需要先区分类型,如果waveOut
的播放状态为正在播放,调用函数暂停音乐,否则就是调用WindowsMediaPlayer
的暂停函数。
5、播放下一首功能
Button3“下一首”代码
private void button3_Click(object sender, EventArgs e)
{
if(localmusiclist.Count > 0)
{
int index = (listBox1.SelectedIndex + 1);
axWindowsMediaPlayer1.URL = localmusiclist[index];
musicplay(axWindowsMediaPlayer1.URL);
label1.Text = Path.GetFileNameWithoutExtension(localmusiclist[index]);
listBox1.SelectedIndex = index;
}
}
这里采用索引来得到下一首音乐URL,再进行播放,同时更改SelectedIndex
的当前索引。
6、音量控制
private void trackBar1_Scroll(object sender, EventArgs e)
{
axWindowsMediaPlayer1.settings.volume = trackBar1.Value;
label2.Text = trackBar1.Value + "%";
}
直接将WindowsMediaPlayer
的属性和TrackBar
设置的值进行关联并再label2上显示当前音量/
四、完整代码:
代码仓库:https://github.com/dafsss/Windows-/tree/main/WindowsFormsApp1
五、总结
本次作业旨在通过导入第三方库辅助自己的程序设计与学习更复杂的控件使用和控件之间的联系。并开发了一个能够播放MP3和OGG格式音乐文件的C# Windows Forms应用程序
对于MP3文件的播放,Windows Media Player控件是一个简单且有效的选择,它提供了良好的用户界面和兼容性。
对于Ogg Vorbis文件的播放,Naudio库是一个强大的选择,它支持多种音频格式,并提供了灵活的API来处理音频数据。然而,由于它没有提供现成的用户界面控件,因此你可能需要更多的工作来创建用户界面。
本次作业通过开发一个音乐播放应用程序,让我对C#和Windows Forms开发有了更深入的了解和认识。