Windows程序设计课程作业二----音乐播放器

最新推荐文章于 2024-06-17 00:00:51 发布

2301_79997717

最新推荐文章于 2024-06-17 00:00:51 发布

阅读量1k

点赞数 16

文章标签： windows

本文链接：https://blog.csdn.net/2301_79997717/article/details/138579852

版权

在现代计算机的应用中，音乐播放器已经成为人们生活中不可或缺的一部分。从复杂的媒体播放器到简单的音频播放工具，各种应用层出不穷。今天，我们将通过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线程，导致应用程序在播放音频时无法响应用户操作。我暂时还没找到适合的解决方案，之后也会不断学习，相信不久之后就可以解决这个问题。

2301_79997717

关注

16
点赞
踩
24

收藏

觉得还不错? 一键收藏
0
评论
Windows程序设计课程作业二----音乐播放器

在现代计算机的应用中，音乐播放器已经成为人们生活中不可或缺的一部分。从复杂的媒体播放器到简单的音频播放工具，各种应用层出不穷。今天，我们将通过Windows Forms、AxWindowsMediaPlayer控件和Nuget程序包中的Naudi.Vorbis控件来打造一款简易的音乐播放器，并详细解析其实现过程。
复制链接

扫一扫