在现代计算机的应用中,音乐播放器已经成为人们生活中不可或缺的一部分。从复杂的媒体播放器到简单的音频播放工具,各种应用层出不穷。今天,我们将通过Windows Forms、AxWindowsMediaPlayer控件和Nuget程序包中的Naudi.Vorbis控件来打造一款简易的音乐播放器,并详细解析其实现过程。
1、作业要求
请编写一个C#程序,实现音乐文件的播放功能。
要求1:
1. 程序应能够读取MP3文件,并播放其中的音频。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用WindowsMediaPlayer控件
要求2:
1. 程序应能够播放ogg文件。
2. 程序应能够处理可能出现的异常,如文件不存在、文件读取错误等。
3. 程序应具有良好的用户界面,方便用户进行操作。
4. 程序应具有良好的兼容性,能在不同版本的C#中正常运行。
提示:此功能可以使用Nuget程序包中的Naudi.Vorbis控件
2 、设计界面
我们需要添加必要的控件来构建我们的音乐播放器界面。这里我们至少需要:
- 一个ListBox控件(listBox1),用于显示音乐文件列表。
- 四个Button控件(button1、button2、button3、button4),分别用于选择音乐、停止播放、下一曲和播放ogg。
- 一个trackBar1控件,用于调节音量。
- 一个AxWindowsMediaPlayer控件(axWindowsMediaPlayer1),用于播放音乐。
- 两个label控件,分别用来显示歌曲名称和音量大小
如图所示
3、核心功能实现
2.1 播放MP3文件
首先,确保我们的开发环境中已经安装了Windows Forms和AxWindowsMediaPlayer控件。AxWindowsMediaPlayer控件是一个ActiveX控件,它可以嵌入到Windows Forms应用程序中,用于播放音频文件。
2.1.1 筛选正确的歌曲文件并播放
当用户点击
button1
时,会触发button1_Click
事件处理函数。这个函数的主要目的是允许用户通过文件对话框选择音频文件,并将选择的文件路径显示在listBox1
控件中,同时将这些文件路径存储在一个列表(localmusciclist
)和一个数组(files
)中。
(1)设置文件对话框的过滤器(Filter):
这行代码设置了 openFileDialog1
的过滤器,使得用户只能选择 .mp3
、.wav
或 .flac
格式的文件。过滤器的字符串格式为 "描述|扩展名1;扩展名2;..."
。
openFileDialog1.Filter = "选择音频|*mp3;*wav;*.flac";
(2)允许多选(Multiselect):
这行代码允许用户通过文件对话框选择多个文件。如果 Multiselect
属性为 false
,则用户只能选择单个文件。
openFileDialog1.Multiselect = true;
(3)显示文件对话框:
调用 ShowDialog
方法显示文件对话框。如果用户点击了“打开”按钮(或进行了等效操作),则 ShowDialog
方法返回 DialogResult.OK
,并且后续的代码会被执行。
if (openFileDialog1.ShowDialog() == DialogResult.OK)
(4)清空ListBox和文件数组:
首先,清空 listBox1
中的所有项,以确保不会显示之前选择的文件。然后,检查 files
数组是否为 null
。如果 files
不是 null
,则使用 Array.Clear
方法清空数组的内容。
listBox1.Items.Clear();
if (files != null)
{
Array.Clear(files, 0, files.Length);
}
(5)获取并处理选择的文件:
通过 openFileDialog1.FileNames
属性获取用户选择的文件路径数组,并将其赋值给 files
数组。然后,我们创建了一个引用 files
的新数组变量 array
。最后,我们使用 foreach
循环遍历每个文件路径,将它们添加到 listBox1
的项集合中,并添加到 localmusciclist
列表中。
files = openFileDialog1.FileNames;
string[] array = files;
foreach (string x in array)
{
listBox1.Items.Add(x);
localmusciclist.Add(x);
}
(6)总体代码
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;
string[] array = files;
foreach (string x in array)
{
listBox1.Items.Add(x);//把x放入列表里面,给用户看
localmusciclist.Add(x);
}
}
}
(7)用户界面如下
2.1.2 暂停播放
暂停播放就需要用到我们提到过的WindowsMediaPlayer控件,让歌曲暂停
axWindowsMediaPlayer1.Ctlcontrols.stop();//停止音乐播放
2.1.3 下一曲
当歌曲有下一曲时,进行下一首歌曲的播放,如果没有下一曲,我设置的是自动播放第一曲,当然大家也可以设置直接结束
我写了一个事件处理函数,对应于下一曲的点击事件。其主要功能是播放音乐列表中的下一首音乐,并更新相关的UI元素
(1)检查音乐列表是否非空:
if (localmusciclist.Count > 0)
在开始处理之前,代码首先检查 localmusciclist
是否包含任何项。如果列表为空,则不执行任何操作。
(2)计算下一曲的索引:
int nextIndex = listBox1.SelectedIndex + 1;
这里,listBox1.SelectedIndex
获取当前在 listBox1
(一个列表框控件)中选中项的索引。由于要播放下一首音乐,所以将索引加1。
(3)处理列表索引超出范围的情况:
if (nextIndex > localmusciclist.Count)
{
nextIndex = 0;
}
如果计算出的 nextIndex
大于 localmusciclist
的项数(即索引超出了列表的范围),则将 nextIndex
重置为0,表示要播放列表中的第一首音乐。
(4)设置Windows Media Player的URL:
axWindowsMediaPlayer1.URL = localmusciclist[nextIndex];
使用计算出的 nextIndex
从 localmusciclist
中获取下一首音乐的路径,并将其设置为 axWindowsMediaPlayer1
(一个Windows Media Player控件)的URL
属性,从而开始播放该音乐.
(5)调用音乐播放函数:
musicplay(axWindowsMediaPlayer1.URL);
调用名为 musicplay
的函数,并传入当前播放音乐的URL作为参数。这个函数可能用于执行一些与音乐播放相关的额外操作,但根据给出的代码片段,我们无法确定其具体功能。
(6)更新标签的文本:
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[nextIndex]);
使用 Path.GetFileNameWithoutExtension
方法从 localmusciclist
中获取当前播放音乐的文件名(不带扩展名),并将其设置为 label1
(一个标签控件)的文本,从而在UI上显示当前播放的音乐名称。
(7)整体代码
该代码段实现了音乐播放器中常见的“下一曲”功能,通过更新Windows Media Player的URL来播放列表中的下一首音乐,并更新UI以反映当前播放的音乐。
private void button3_Click_1(object sender, EventArgs e)
{
if (localmusciclist.Count > 0)
{
int nextIndex = listBox1.SelectedIndex + 1;//下一曲比列表总数长,恢复第一首
if (nextIndex > localmusciclist.Count)
{
nextIndex = 0;
}
axWindowsMediaPlayer1.URL = localmusciclist[nextIndex];
musicplay(axWindowsMediaPlayer1.URL);
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[nextIndex]);
}
}
2.1.4 音量控制
这段代码是一个事件处理函数,对应于
trackBar1
控件的Scroll
事件。trackBar1
是一个音量调节滑块,而axWindowsMediaPlayer1
是一个Windows Media Player控件,用于播放音频代码的功能是当用户通过滑动
trackBar1
来调整音量时,它会更新axWindowsMediaPlayer1
的音量设置,并在label2
标签控件中显示当前的音量百分比。
private void trackBar1_Scroll_1(object sender, EventArgs e)//设置音量
{
axWindowsMediaPlayer1.settings.volume = trackBar1.Value;
label2.Text = trackBar1.Value + "%";//增加字符串,自动变成字符串类型
}
2.1.5 播放时目录的显示
(1)检查音乐列表是否非空:
if (localmusciclist.Count > 0)
首先,代码检查localmusciclist
是否包含任何项。这是为了防止在空列表上执行索引操作时可能出现的异常。
(2)设置Windows Media Player的URL :
axWindowsMediaPlayer1.URL = localmusciclist[listBox1.SelectedIndex];
当listBox1
的选中项发生改变时,代码通过listBox1.SelectedIndex
获取当前选中项的索引,并使用这个索引从localmusciclist
列表中检索对应的音乐文件路径。然后,它将这个路径设置为axWindowsMediaPlayer1
(一个Windows Media Player控件)的URL
属性,从而改变播放器当前播放的音乐 。
(3)调用音乐播放函数:
musicplay(axWindowsMediaPlayer1.URL);
这行代码调用了一个名为musicplay
的函数,并传入了当前播放音乐的URL作为参数。虽然我们没有这个函数的具体实现,但可以推测它可能用于执行一些与音乐播放相关的额外操作,比如更新UI状态、记录播放历史等。不过,由于axWindowsMediaPlayer1.URL
的设置通常会自动触发播放,所以这个musicplay
函数可能是可选的,具体取决于应用程序的需求。
(4)更新标签的文本:
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[listBox1.SelectedIndex]);
最后,代码使用Path.GetFileNameWithoutExtension
方法从localmusciclist
列表中获取当前选中音乐文件的文件名(不带扩展名),并将其设置为label1
(一个标签控件)的文本。这样,用户就可以通过label1
看到当前选中的音乐文件的名称,而不需要查看完整的文件路径。
(5)总体代码:
该代码是一个事件处理函数,对应于
listBox1
控件的SelectedIndexChanged
事件。当listBox1
中的选中项发生改变时,此函数会被触发。
private void listBox1_SelectedIndexChanged_1(object sender, EventArgs e)
{
if (localmusciclist.Count > 0)
{
axWindowsMediaPlayer1.URL = localmusciclist[listBox1.SelectedIndex];
musicplay(axWindowsMediaPlayer1.URL);
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[listBox1.SelectedIndex]);
}
}
2.1.6异常处理
处理异常的时候,可以使用try_catch的结构,分别处理三种异常
try
{
axWindowsMediaPlayer1.Ctlcontrols.play(); // 注意这里可能需要检查属性/方法的名称是否正确
}
catch (FileNotFoundException ex)
{
MessageBox.Show("文件不存在:" + ex.Message,"错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (IOException ex)
{
MessageBox.Show("文件读取错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (Exception ex)// 捕获其他未指定的异常
{
MessageBox.Show("发生未知错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
2.2 播放ogg文件
需要使用Nuget程序包中的Naudi.Vorbis控件
首先我定义了一个名为
button4_Click
的事件处理器,它对应于播放ogg的点击事件。当按钮被点击时,代码会打开一个文件对话框,让用户选择一个.ogg
格式的音频文件,并使用NAudio库(由VorbisWaveReader
和WaveOutEvent
等类推断)来播放该音频文件。
2.2.1变量声明:
string oggFilePath = " ";
声明一个字符串变量oggFilePath
用于存储用户选择的.ogg
音频文件的路径。初始化为一个空格字符,但实际上这个初始值并没有太大意义,因为稍后会通过文件对话框重新赋值。
2.2.2创建OpenFileDialog:
OpenFileDialog openFileDialog = new OpenFileDialog();
openFileDialog.Filter = "播放音频|*.ogg";
这里创建了一个OpenFileDialog
实例,并设置了其Filter
属性,以便用户只能选择.ogg
格式的文件。
2.2.3显示文件对话框并获取文件路径:
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
oggFilePath = openFileDialog.FileName;
}
如果用户点击了文件对话框的“确定”按钮(即DialogResult.OK
),则获取用户选择的文件路径并赋值给oggFilePath
。
2.2.4音频文件读取与播放:
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);
}
}
}
使用VorbisWaveReader
读取用户选择的.ogg
文件。使用WaveOutEvent
初始化音频输出设备,并将vorbisReader
作为音频源。调用Play()
方法开始播放音频。使用while
循环和Thread.Sleep(1000)
来等待音频播放结束。
2.2.5 异常处理
用try-catch结构,处理三种异常
catch (FileNotFoundException ex)
{
MessageBox.Show("文件不存在:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (IOException ex)
{
MessageBox.Show("文件读取错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (Exception ex)// 捕获其他未指定的异常
{
MessageBox.Show("发生未知错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
3、整体实验代码
using NAudio.Wave;
using System;
using NAudio;
using NAudio.Wave;
using NAudio.Vorbis;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using static System.Windows.Forms.VisualStyles.VisualStyleElement;
using System.Security.Policy;
namespace Music
{
public partial class Form1 : Form
{
string[] files;
List<string> localmusciclist = new List<string> { };
public Form1()
{
InitializeComponent();
}
private void musicplay(string filename) //播放音乐
{
string extension = Path.GetExtension(filename);
if (extension == ".ogg") { Console.WriteLine("this is ogg file."); }//ogg需要用特殊方法调用
else
{
try
{
axWindowsMediaPlayer1.Ctlcontrols.play(); // 注意这里可能需要检查属性/方法的名称是否正确
}
catch (FileNotFoundException ex)
{
MessageBox.Show("文件不存在:" + ex.Message,"错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (IOException ex)
{
MessageBox.Show("文件读取错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (Exception ex)// 捕获其他未指定的异常
{
MessageBox.Show("发生未知错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
}
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;
string[] array = files;
foreach (string x in array)
{
listBox1.Items.Add(x);//把x放入列表里面,给用户看
localmusciclist.Add(x);
}
}
}
private void button2_Click_1(object sender, EventArgs e)
{
axWindowsMediaPlayer1.Ctlcontrols.stop();//停止音乐播放
}
private void button3_Click_1(object sender, EventArgs e)
{
if (localmusciclist.Count > 0)
{
int nextIndex = listBox1.SelectedIndex + 1;//下一曲比列表总数长,恢复第一首
if (nextIndex > localmusciclist.Count)
{
nextIndex = 0;
}
axWindowsMediaPlayer1.URL = localmusciclist[nextIndex];
musicplay(axWindowsMediaPlayer1.URL);
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[nextIndex]);
}
}
private void listBox1_SelectedIndexChanged_1(object sender, EventArgs e)
{
if (localmusciclist.Count > 0)
{
axWindowsMediaPlayer1.URL = localmusciclist[listBox1.SelectedIndex];
musicplay(axWindowsMediaPlayer1.URL);
label1.Text = Path.GetFileNameWithoutExtension(localmusciclist[listBox1.SelectedIndex]);
}
}
private void label1_Click(object sender, EventArgs e)
{
}
private void trackBar1_Scroll_1(object sender, EventArgs e)//设置音量
{
axWindowsMediaPlayer1.settings.volume = trackBar1.Value;
label2.Text = trackBar1.Value + "%";//增加字符串,自动变成字符串类型
}
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;
}
try
{
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);
}
}
}
}
catch (FileNotFoundException ex)
{
MessageBox.Show("文件不存在:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (IOException ex)
{
MessageBox.Show("文件读取错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (Exception ex)// 捕获其他未指定的异常
{
MessageBox.Show("发生未知错误:" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
4、效果预览
4、实验小结
在Windows程序设计中使用C#制作音乐播放器是一个有趣且实用的项目。在开始编写代码之前,我首先明确了音乐播放器的功能需求,包括播放、暂停、停止、音量调节、播放列表管理等基本功能,这些需求为后续的开发指明了方向。我设计了一个简洁明了的用户界面,包括播放/暂停按钮、音量滑块、进度条等控件。用户可以通过这些控件轻松控制音乐的播放。在编码过程中,我遇到了不少挑战,如音频文件的加载、播放控制、进度条的同步等。通过不断尝试,我逐渐解决了这些问题。完成编码后,我进行了多次测试,包括正常情况下的播放、暂停、停止等功能,以及异常情况下的错误处理。通过测试,我发现了一些潜在的问题。播放ogg文件时可能会产生UI线程阻塞:
while
循环会阻塞UI线程,导致应用程序在播放音频时无法响应用户操作。我暂时还没找到适合的解决方案,之后也会不断学习,相信不久之后就可以解决这个问题。