一.要求:
要求1:
1. 程序应能够读取MP3文件,并播放其中的音频。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用WindowsMediaPlayer控件
要求2:
1. 程序应能够播放ogg文件。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用Nuget程序包中的Naudi.Vorbis控件
二.实现分析
要求1分析
-
读取并播放MP3文件:
- 可以使用 Windows Media Player 控件(
WindowsMediaPlayer
)来实现对MP3文件的播放。将其添加到窗体上,并在用户选择MP3文件后,将文件路径赋给WindowsMediaPlayer
的URL
属性即可开始播放音频。
- 可以使用 Windows Media Player 控件(
-
处理异常:
- 在播放音频时,需要捕获可能出现的异常,如文件不存在、文件读取错误等。可以使用 try-catch 块来捕获这些异常,并向用户显示适当的错误消息。
-
用户界面设计:
- 可以设计一个简单的窗体界面,包含一个按钮用于打开文件对话框选择MP3文件,并添加一个播放按钮用于控制音频的播放和暂停。
-
兼容性:
- 使用 Windows Media Player 控件是一个通用的解决方案,它可以在不同版本的C#中正常运行,因为它是 .NET Framework 的一部分,因此不需要额外的依赖。
要求2分析:
-
播放ogg文件:
- 为了播放ogg文件,可以使用第三方库 NAudio.Vorbis。首先需要将该库添加到项目中,然后使用其中的
VorbisWaveReader
类来读取ogg文件,并通过WaveOut
类将音频输出到音频设备。
- 为了播放ogg文件,可以使用第三方库 NAudio.Vorbis。首先需要将该库添加到项目中,然后使用其中的
-
处理异常:
- 同样需要处理可能出现的异常情况,如文件不存在、文件读取错误等。在使用 NAudio.Vorbis 库时,需要注意捕获其可能抛出的异常。
-
用户界面设计:
- 与要求1相似,设计一个简单的窗体界面,包含一个按钮用于打开文件对话框选择ogg文件,并添加一个播放按钮用于控制音频的播放和暂停。
-
兼容性:
- 使用 NAudio.Vorbis 库时,需要确保项目能够正确引用该库,并且库本身能够与所使用的C#版本兼容。
实现步骤:
- 根据要求设计窗体界面,包括添加按钮和播放器控件。
- 实现打开文件对话框选择MP3文件的功能,并将选定的文件路径赋给
WindowsMediaPlayer
控件的URL
属性。 - 在播放MP3文件时,捕获可能出现的异常,并向用户显示错误消息。
- 添加播放按钮的点击事件处理方法,以实现音频的播放和暂停功能。
- 同样的步骤也适用于ogg文件的播放,不同之处在于使用 NAudio.Vorbis 库来处理ogg文件,并通过
WaveOut
类来播放音频。
代码实现:
(都有详细的注释,简单易懂)
using NAudio.Wave;
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Reflection.Emit;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
namespace WindowsFormsApp4
{
public partial class Form1 : Form
{
// 存储选定的文件路径的数组
string[] files;
// 存储本地音乐文件路径的列表
List<string> localmusiclist = new List<string> { };
// Form1 类的构造函数
public Form1()
{
// 初始化窗体组件
InitializeComponent();
}
// 播放音乐的方法
private void musicplay(string filename)
{
// 获取文件扩展名
string extnesion = Path.GetExtension(filename);
// 如果文件扩展名为 .ogg
if (extnesion == ".ogg")
{
// 输出信息:这是 ogg 文件
Console.WriteLine("this is ogg file");
}
else
{
// 输出信息:这不是 ogg 文件
Console.WriteLine("this is not ogg file");
// 控制 Windows Media Player 控件播放音频文件
axWindowsMediaPlayer1.Ctlcontrols.play();
}
}
private void axWindowsMediaPlayer1_Enter(object sender, EventArgs e)
{
}
// “选择音频”按钮点击事件处理方法
private void button1_Click(object sender, EventArgs e)
{
// 设置文件对话框过滤器
openFileDialog1.Filter = "选择音频|*mp3;*.wav;*.flac";
// 允许多选文件
openFileDialog1.Multiselect = true;
// 如果用户点击了文件对话框的“确定”按钮
if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
// 清空列表框中的项
listBox1.Items.Clear();
// 如果 files 数组不为空
if (files != null)
{
// 清空 files 数组
Array.Clear(files, 0, files.Length);
}
// 获取文件对话框选中的文件名数组
files = openFileDialog1.FileNames;
// 将文件名添加到列表框和本地音乐列表中
string[] array = files;
foreach (string x in array)
{
listBox1.Items.Add(x);
localmusiclist.Add(x);
}
}
}
private void openFileDialog1_FileOk(object sender, CancelEventArgs e)
{
// 当打开文件对话框的文件确认事件被触发时执行的方法
// 这里可以添加需要的逻辑,但当前代码中没有任何内容
}
private void button2_Click(object sender, EventArgs e)
{
// 当按钮2被点击时执行的方法
// 停止 Windows Media Player 控件的播放
axWindowsMediaPlayer1.Ctlcontrols.stop();
}
private void button3_Click(object sender, EventArgs e)
{
// 当按钮3被点击时执行的方法
// 检查本地音乐列表是否包含音乐文件
if (localmusiclist.Count > 0)
{
// 获取当前选中音乐文件的索引
int index = listBox1.SelectedIndex;
// 设置 Windows Media Player 控件的 URL 为下一首音乐文件的路径,并播放该文件
axWindowsMediaPlayer1.URL = localmusiclist[(index + 1) % localmusiclist.Count];
// 调用自定义方法 musicplay() 播放音乐
musicplay(axWindowsMediaPlayer1.URL);
// 在标签控件中显示当前音乐文件的名称(不包含扩展名)
label1.Text = Path.GetFileNameWithoutExtension(localmusiclist[listBox1.SelectedIndex]);
// 设置列表框中选中项为下一首音乐文件的索引
listBox1.SelectedIndex = (index + 1) % localmusiclist.Count;
}
}
private void label1_Click(object sender, EventArgs e)
{
// 当标签1被点击时执行的方法
// 这里可以添加需要的逻辑,但当前代码中没有任何内容
}
private void listBox1_SelectedIndexChanged(object sender, EventArgs e)
{
// 当列表框选中项发生变化时执行的方法
// 检查本地音乐列表是否包含音乐文件
if (localmusiclist.Count > 0)
{
// 设置 Windows Media Player 控件的 URL 为当前选中音乐文件的路径,并播放该文件
axWindowsMediaPlayer1.URL = localmusiclist[listBox1.SelectedIndex];
// 调用自定义方法 musicplay() 播放音乐
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;
// 在标签2控件中显示当前音量值
label2.Text = trackBar1.Value + "%";
}
private void button4_Click(object sender, EventArgs e)
{
// 创建一个打开文件对话框
OpenFileDialog openFileDialog = new OpenFileDialog();
// 设置文件过滤器,只允许选择 .ogg 格式的文件
openFileDialog.Filter = "播放音频|*.ogg";
// 如果用户点击了打开按钮
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
// 获取用户选择的 .ogg 文件的路径
string oggFilePath = openFileDialog.FileName;
// 检查文件是否存在
if (!File.Exists(oggFilePath))
{
// 如果文件不存在,则输出错误信息并退出方法
Console.WriteLine("OGG file not found.");
return;
}
// 使用NAudio的MediaFoundationReader来读取OGG文件
using (var reader = new MediaFoundationReader(oggFilePath))
{
// 创建一个音频输出设备
using (var outputDevice = new WaveOutEvent())
{
// 初始化输出设备,并开始播放读取的音频文件
outputDevice.Init(reader);
outputDevice.Play();
// 循环等待音频播放结束
while (outputDevice.PlaybackState == PlaybackState.Playing)
{
// 暂停线程执行一段时间,然后再次检查播放状态
System.Threading.Thread.Sleep(100); // 等待一段时间,然后检查播放状态
}
}
}
}
}
}
}
winform界面:
实验易错及注意点:
-
文件选择器设置问题:
- 确保在使用文件选择器前设置正确的文件过滤器(Filter),以便用户可以选择所需类型的文件。
- 确保启用了文件多选功能(Multiselect),如果需要用户可以选择多个文件。
-
文件对话框返回值检查:
- 检查文件对话框的返回值是否为
DialogResult.OK
,以确保用户选择了文件并点击了确定按钮。
- 检查文件对话框的返回值是否为
-
清空列表框内容:
- 在向列表框中添加新项之前,务必清空列表框的现有内容,以避免重复添加文件名。
-
数组操作注意事项:
- 在重新分配文件数组之前,确保先检查其是否为空,以避免出现空引用异常。
- 使用
Array.Clear()
方法清空数组时,确保传入正确的索引和长度参数。
-
列表操作正确性:
- 确保将文件名添加到列表框和本地音乐列表之后,以便正确跟踪所选文件。
小结:
在上述代码中,主要实现了一个简单的窗体应用程序,其中包含一个按钮点击事件处理方法,用于打开文件对话框并选择音频文件。一旦用户选择了文件,它们将会被添加到列表框中,并同时被添加到本地音乐文件列表中。同时,还对文件的扩展名进行了简单的检查,以区分是否为 ogg 格式的文件,并在不是 ogg 文件时控制 Windows Media Player 控件播放音频文件。