Qt实现简易音乐播放器

news/2025/2/8 19:30:18/

 使用Qt6实现简易音乐播放器，效果如下：

github：

Gabriel-gxb/MusicPlayer: qt6实现简易音乐播放器

    

一、整体架构

基于Qt框架构建

整个音乐播放器程序以Qt框架为基础进行开发。Qt提供了丰富的类库和工具，方便开发者构建图形用户界面（GUI）以及处理多媒体等功能。

以MainWindow类为核心

  1.1. 功能集成点
      1.MainWindow类是程序的核心，集成了音乐播放器的各种功能逻辑，包括界面显示、用户交互处理、多媒体播放控制等。

  2.2. 继承关系
      1.继承自QMainWindow，这使得MainWindow能够利用QMainWindow的特性，如默认的菜单栏、工具栏、状态栏布局等。通过这种继承关系，可以在MainWindow类中方便地添加自定义的界面元素和功能。

功能模块划分

  1.1. 多媒体播放模块
      1.以QMediaPlayer类为中心，该类负责音乐文件的播放操作。同时创建QAudioOutput对象与QMediaPlayer关联，以处理音频输出相关的功能，如设置音量等。

  2.2. 界面显示模块
      1.包含各种QWidget相关的界面元素，如QPushButton（按钮）、QListWidget（列表部件）、QLabel（标签）、QSlider（滑块）等。这些界面元素用于展示音乐信息（如歌曲名称、播放时间、音量等），以及提供用户交互操作（如播放、暂停、添加文件、切换歌曲、调整音量等）。
      2.利用paintEvent函数绘制界面背景等自定义的绘制操作。

  3.3. 用户交互模块
      1.通过信号与槽机制将界面元素的交互事件（如按钮点击、滑块移动等）与相应的功能函数连接起来。例如，当用户点击播放按钮时，会触发on_pushButton_start_clicked函数来控制音乐的播放或暂停；当滑块移动时，会触发相应的sliderMoved或valueChanged函数来调整音乐播放的位置或音量等。

  4.4. 数据管理模块
      1.在程序中通过QListWidgetItem存储音乐文件相关信息，如文件名和文件路径（以QUrl形式存储在Qt::UserRole自定义数据中）。这些数据在程序运行过程中起到了管理音乐文件列表、获取当前播放文件等作用。

    

二、基本布局

在布局中，使按钮隐藏边框的样式表内容为：

*{border: none;
}

使ListWidget变为透明的样式表内容为：

*{background-color: transparent
}

     

三、代码注释

.h文件中代码：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include <QtMultimedia/qmediaplayer.h>QT_BEGIN_NAMESPACEclass QLabel;
class QListWidgetItem;namespace Ui {
class MainWindow;
}
QT_END_NAMESPACEclass MainWindow : public QMainWindow
{Q_OBJECTpublic:MainWindow(QWidget *parent = nullptr);~MainWindow();private:Ui::MainWindow *ui;QMediaPlayer *player;bool isLoop = false;QLabel *label_volume;QLabel *label_loop;QString m_durationTime;QString m_positionTime;// QWidget interface
protected:virtual void paintEvent(QPaintEvent *event) override;private slots:void on_pushButton_add_clicked();void on_pushButton_start_clicked(bool check);void on_listWidget_itemClicked(QListWidgetItem *item);void on_listWidget_itemDoubleClicked(QListWidgetItem *item);void on_pushButton_volume_clicked(bool checked);void on_horizontalSlider_sliderMoved(int position);void on_horizontalSlider_sliderPressed();void on_verticalSlider_valueChanged(int value);void on_pushButton_front_clicked();void on_pushButton_back_clicked();void on_pushButton_mode_clicked(bool checked);void on_horizontalSlider_valueChanged(int value);
};#endif // MAINWINDOW_H

.cpp文件中代码：

#include "mainwindow.h"
#include "./ui_mainwindow.h"// 包含用于文件对话框操作的头文件
#include <QFileDialog>
// 包含用于绘制事件相关的头文件
#include <QPaintEvent>
// 包含用于绘图操作（如画图工具类）的头文件
#include <QPainter>
// 包含Qt多媒体相关的头文件
#include <QtMultimedia>// MainWindow类的构造函数，用于初始化MainWindow对象
MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{// 使用UI设计文件中的setupUi函数来初始化界面ui->setupUi(this);// 设置主窗口的大小为宽度1000，高度700resize(1000, 700);// 创建一个QMediaPlayer对象，this表示该对象的父对象为MainWindowplayer = new QMediaPlayer(this);// 创建一个QAudioOutput对象，与前面创建的QMediaPlayer对象关联QAudioOutput *audioOutput = new QAudioOutput(player);player->setAudioOutput(audioOutput);// 创建一个QLabel对象用于显示音量相关信息，初始文本包含当前音量值（从垂直滑块获取）label_volume = new QLabel("当前音量：" + QString("%1").arg(ui->verticalSlider->value()), this);// 设置标签的固定宽度为80像素label_volume->setFixedWidth(80);// 将音量标签添加到状态栏的永久部件中，使其始终显示ui->statusBar->addPermanentWidget(label_volume);// 创建一个QLabel对象用于显示循环相关信息，初始文本为"当前模式：列表循环"label_loop = new QLabel("当前模式：列表循环", this);// 设置标签的固定宽度为200像素label_loop->setFixedWidth(200);// 将循环标签添加到状态栏中ui->statusBar->addWidget(label_loop);// 设置状态栏的样式表，使状态栏中的项目没有边框ui->statusBar->setStyleSheet(QString("QStatusBar::item{border:0px}"));// 当QMediaPlayer的播放状态发生改变时（开始播放或停止播放）的连接操作// 当playing为true表示正在播放，false表示停止播放// 使用lambda表达式作为槽函数，根据播放状态更新播放按钮的选中状态和水平滑块的可用性connect(player, &QMediaPlayer::playingChanged, this, [&](bool playing) {ui->pushButton_start->setChecked(!playing);  //播放按钮状态ui->horizontalSlider->setEnabled(true);  //设置进度条可拖拽});// 当QMediaPlayer的播放文件发生改变时（例如切换到新的音频或视频文件）的连接操作// media是新的播放文件的QUrl对象// 使用lambda表达式作为槽函数，根据新的播放文件更新歌曲名称标签的显示内容connect(player, &QMediaPlayer::sourceChanged, this, [&](const QUrl &media) {ui->label_info->setText(media.fileName());  //设置歌曲名称});// 当QMediaPlayer的源数据发生变化时（例如音频或视频的元数据发生改变）的连接操作// 使用lambda表达式作为槽函数，处理元数据变化相关的操作connect(player, &QMediaPlayer::metaDataChanged, this, [&]() {// 获取元数据对象QMediaMetaData metaData = player->metaData();// 获取元数据中的缩略图图像数据（如果存在）QVariant metaImg = metaData.value(QMediaMetaData::ThumbnailImage);if (metaImg.isValid()) {// 将图像数据转换为QImage对象QImage img = metaImg.value<QImage>();// 将QImage转换为QPixmap对象，并根据部件宽度缩放图像QPixmap pix = QPixmap::fromImage(img);ui->label_pic->setPixmap(pix.scaledToWidth(ui->widget->width()));} else {// 如果没有有效图像，清除标签上的图像显示ui->label_pic->clear();}});// 当QMediaPlayer的播放源时长发生变化时（例如切换到新的音频或视频文件，其时长与之前不同）的连接操作// duration是新的播放时长（以毫秒为单位）// 使用lambda表达式作为槽函数，根据新的时长更新水平滑块的最大范围，并计算和显示总时长connect(player, &QMediaPlayer::durationChanged, this, [&](qint64 duration) {ui->horizontalSlider->setMaximum(duration);int sec = duration / 1000;int min = sec / 60;sec %= 60;m_durationTime = QTime(0, min, sec).toString("mm:ss");ui->label_time->setText(m_positionTime + "/" + m_durationTime);});// 当QMediaPlayer的播放位置发生变化时（例如播放过程中时间轴的推进）的连接操作// position是新的播放位置（以毫秒为单位）// 使用lambda表达式作为槽函数，根据新的播放位置更新水平滑块的滑块位置，并计算和显示当前播放时间connect(player, &QMediaPlayer::positionChanged, this, [&](qint64 position) {if (ui->horizontalSlider->isSliderDown())return;ui->horizontalSlider->setSliderPosition(position);int sec = position / 1000;int min = sec / 60;sec %= 60;m_positionTime = QTime(0, min, sec).toString("mm:ss");ui->label_time->setText(m_positionTime + "/" + m_durationTime);});
}// MainWindow类的析构函数，用于释放ui对象占用的内存
MainWindow::~MainWindow()
{delete ui;
}
// paintEvent函数用于处理主窗口的绘制事件
// 重写QWidget的paintEvent函数
void MainWindow::paintEvent(QPaintEvent *event)
{// 创建一个QPainter对象，用于在主窗口（this表示当前的MainWindow对象）上进行绘制操作QPainter painter(this);// 创建一个QPixmap对象，加载指定资源路径（":/bk"，这是Qt的资源系统路径）下的图像QPixmap pixmap(":/bk");// 将图像按照主窗口的大小进行缩放，忽略宽高比并使用平滑变换pixmap = pixmap.scaled(size(), Qt::IgnoreAspectRatio, Qt::SmoothTransformation);// 在主窗口的坐标(0, 0)处绘制缩放后的图像painter.drawPixmap(0, 0, pixmap);// 调用父类（QMainWindow）的paintEvent函数，以确保默认的绘制操作也能执行return QMainWindow::paintEvent(event);
}// 当名为pushButton_add的按钮被点击时调用此函数
void MainWindow::on_pushButton_add_clicked()
{// 获取当前的工作目录路径QString curPath = QDir::currentPath();// 设置文件选择对话框的标题QString title = "选择音频文件";// 设置文件选择对话框的文件过滤器，只显示扩展名为.mp3的音频文件QString filter = "音频文件(*.mp3)";// 弹出文件选择对话框，允许用户选择多个文件，返回所选文件的路径列表QStringList fileList = QFileDialog::getOpenFileNames(this, title, curPath, filter);// 如果没有选择任何文件，则直接返回，不进行后续操作if (fileList.size() < 1) return;// 遍历所选文件的路径列表for (int i = 0; i < fileList.size(); i++) {// 获取当前遍历到的文件路径QString aFile = fileList[i];// 创建一个QFileInfo对象，用于获取文件的相关信息（如文件名等）QFileInfo info(aFile);// 创建一个QListWidgetItem对象，用于在列表部件（listWidget）中显示文件名QListWidgetItem *item = new QListWidgetItem(info.fileName());// 将文件的本地路径转换为QUrl对象，并将其作为用户自定义数据（Qt::UserRole）存储在列表项中item->setData(Qt::UserRole, QUrl::fromLocalFile(aFile));// 将创建好的列表项添加到列表部件（listWidget）中ui->listWidget->addItem(item);}
}
// 当名为pushButton_start的按钮被点击时调用此函数，check表示按钮的选中状态
void MainWindow::on_pushButton_start_clicked(bool check)
{// 获取列表部件（listWidget）中的当前选中项QListWidgetItem *item = ui->listWidget->currentItem();// 获取当前选中项中存储的文件路径（以QUrl形式）auto url = item->data(Qt::UserRole).toUrl();// 如果播放器的当前播放源与当前选中项的文件路径不同，则设置播放器的播放源为当前选中项的文件路径if (player->source()!= url)player->setSource(url);// 如果按钮未被选中（即check为false，表示要开始播放）if (!check) {// 设置播放按钮的图标为暂停图标（":/D:/Apps/qIcon/pause.png"）ui->pushButton_start->setIcon(QIcon(":/D:/Apps/qIcon/pause.png"));// 调用播放器的play函数开始播放player->play();}// 如果按钮被选中（即check为true，表示要暂停播放）else {// 设置播放按钮的图标为播放图标（":/D:/Apps/qIcon/play.png"）ui->pushButton_start->setIcon(QIcon(":/D:/Apps/qIcon/play.png"));// 调用播放器的pause函数暂停播放player->pause();}
}// 当列表部件（listWidget）中的项目被点击时调用此函数，item为被点击的项目指针
void MainWindow::on_listWidget_itemClicked(QListWidgetItem *item)
{// Q_UNUSED宏用于标记未使用的参数，这里表示虽然有item参数但在函数内未使用Q_UNUSED(item);// 启用播放按钮，使其可被点击ui->pushButton_start->setEnabled(true);// 启用向前按钮（pushButton_front），使其可被点击ui->pushButton_front->setEnabled(true);// 启用向后按钮（pushButton_back），使其可被点击ui->pushButton_back->setEnabled(true);
}
// 当列表部件（listWidget）中的项目被双击时调用此函数，item为被双击的项目指针
void MainWindow::on_listWidget_itemDoubleClicked(QListWidgetItem *item)
{// 获取被双击项目中存储的文件路径（以QUrl形式）auto url = item->data(Qt::UserRole).toUrl();// 设置播放器的播放源为被双击项目的文件路径player->setSource(url);// 设置播放按钮的图标为暂停图标（":/D:/Apps/qIcon/pause.png"）ui->pushButton_start->setIcon(QIcon(":/D:/Apps/qIcon/pause.png"));// 调用播放器的play函数开始播放player->play();
}
// 当名为pushButton_volume的按钮被点击时调用此函数，checked表示按钮的选中状态
void MainWindow::on_pushButton_volume_clicked(bool checked)
{// 根据按钮的选中状态设置垂直滑块（verticalSlider）是否可见ui->verticalSlider->setVisible(checked);
}
// 当水平滑块（horizontalSlider）被移动时调用此函数，position为滑块的新位置
void MainWindow::on_horizontalSlider_sliderMoved(int position)
{// 设置播放器的播放位置为滑块的新位置（以毫秒为单位）player->setPosition(position);
}
// 当水平滑块（horizontalSlider）被按下时调用此函数
void MainWindow::on_horizontalSlider_sliderPressed()
{// 设置播放器的播放位置为水平滑块的当前值（以毫秒为单位）player->setPosition(ui->horizontalSlider->value());
}// 当水平滑块（horizontalSlider）的值发生改变时调用此函数，value为滑块的新值
void MainWindow::on_horizontalSlider_valueChanged(int value)
{// 如果当前播放时间等于总播放时间if (m_positionTime == m_durationTime) {// 如果处于循环播放模式（isLoop为true）if (isLoop)// 将播放器的播放位置设置为0，即重新开始播放player->setPosition(0);else// 否则点击向后按钮（pushButton_back），切换到下一个音频文件（根据pushButton_back的逻辑）ui->pushButton_back->click();}
}// 当垂直滑块（verticalSlider）的值发生改变时调用此函数，value为滑块的新值
void MainWindow::on_verticalSlider_valueChanged(int value)
{// 设置播放器音频输出的音量，将滑块的值转换为0到1之间的浮点数（因为音量范围是0.0到1.0）player->audioOutput()->setVolume(value / 100.0);// 更新音量标签的文本，显示当前音量值（从垂直滑块获取）label_volume->setText("当前音量：" + QString("%1").arg(ui->verticalSlider->value()));// 如果垂直滑块的值为0（即音量为0）if (ui->verticalSlider->value() == 0)// 设置音量按钮的图标为静音图标（":/D:/Apps/qIcon/静音.png"）ui->pushButton_volume->setIcon(QIcon(":/D:/Apps/qIcon/静音.png"));else// 否则设置音量按钮的图标为音量图标（":/D:/Apps/qIcon/音量.png"）ui->pushButton_volume->setIcon(QIcon(":/D:/Apps/qIcon/音量.png"));
}
// 当名为pushButton_front的按钮被点击时调用此函数
void MainWindow::on_pushButton_front_clicked()
{// 获取列表部件（listWidget）中的当前行索引int curRow = ui->listWidget->currentRow();// 如果当前行是第一行（索引为0）if (curRow == 0)// 将当前行设置为最后一行（列表部件的行数减1）curRow = ui->listWidget->count() - 1;else// 否则将当前行减1，即切换到上一行curRow--;// 设置列表部件的当前行为新的行索引ui->listWidget->setCurrentRow(curRow);// 获取新的当前行项目中存储的文件路径（以QUrl形式）auto url = ui->listWidget->item(curRow)->data(Qt::UserRole).toUrl();// 设置播放器的播放源为新的文件路径player->setSource(url);// 调用播放器的play函数开始播放player->play();
}
// 当名为pushButton_back的按钮被点击时调用此函数
void MainWindow::on_pushButton_back_clicked()
{// 获取列表部件（listWidget）中的当前行索引int curRow = ui->listWidget->currentRow();// 如果当前行是最后一行（索引为列表部件的行数减1）if (curRow == ui->listWidget->count() - 1)// 将当前行设置为第一行（索引为0）curRow = 0;else// 否则将当前行加1，即切换到下一行curRow++;// 设置列表部件的当前行为新的行索引ui->listWidget->setCurrentRow(curRow);// 获取新的当前行项目中存储的文件路径（以QUrl形式）auto url = ui->listWidget->item(curRow)->data(Qt::UserRole).toUrl();// 设置播放器的播放源为新的文件路径player->setSource(url);// 调用播放器的play函数开始播放player->play();
}
// 当名为pushButton_mode的按钮被点击时调用此函数，checked表示按钮的选中状态
void MainWindow::on_pushButton_mode_clicked(bool checked)
{// 如果按钮被选中（即checked为true）if (checked) {// 更新循环模式标签的文本为"当前模式：单曲循环"label_loop->setText("当前模式：单曲循环");// 设置模式按钮的图标为单曲循环图标（":/D:/Apps/qIcon/单曲循环.png"）ui->pushButton_mode->setIcon(QIcon(":/D:/Apps/qIcon/单曲循环.png"));// 设置循环标志为true，表示处于单曲循环模式isLoop = true;}else {// 更新循环模式标签的文本为"当前模式：列表循环"label_loop->setText("当前模式：列表循环");// 设置模式按钮的图标为列表循环图标（":/D:/Apps/qIcon/列表循环.png"）ui->pushButton_mode->setIcon(QIcon(":/D:/Apps/qIcon/列表循环.png"));// 设置循环标志为false，表示处于列表循环模式isLoop = false;}
}

 

 


http://www.ppmy.cn/news/1570389.html

相关文章

Redis企业开发实战(二)——点评项目之商户缓存查询

Redis企业开发实战(二)——点评项目之商户缓存查询

目录 一、缓存介绍 二、缓存更新策略 三、如何保证redis与数据库一致性 1.解决方案概述 2.双写策略 3.双删策略 3.1延迟双删的目的 4.数据重要程度划分 四、缓存穿透 (一)缓存穿透解决方案 (二)缓存穿透示意图 五、缓存雪崩 (一)缓存雪崩解决方案 (二)缓存雪崩…
阅读更多...
解锁 DeepSeek 模型高效部署密码：蓝耘平台全解析

解锁 DeepSeek 模型高效部署密码：蓝耘平台全解析

&#x1f496;亲爱的朋友们&#xff0c;热烈欢迎来到 青云交的博客&#xff01;能与诸位在此相逢&#xff0c;我倍感荣幸。在这飞速更迭的时代&#xff0c;我们都渴望一方心灵净土&#xff0c;而 我的博客 正是这样温暖的所在。这里为你呈上趣味与实用兼具的知识&#xff0c;也…
阅读更多...
神经网络参数量和运算量的计算- 基于deepspeed库和thop库函数

神经网络参数量和运算量的计算- 基于deepspeed库和thop库函数

引言 最近需要对神经网络的参数量和运算量进行统计。找到一个基于deepspeed库函数计算参数量和运算量的例子。而我之前一直用thop库函数来计算。 看到有一篇勘误博文写道使用thops库得到的运算量是MACs (Multiply ACcumulate operations&#xff0c;乘加累积操作次数&#xf…
阅读更多...
【分块解决大文件上传的最佳实践】

【分块解决大文件上传的最佳实践】

前言 前几天看了一篇关于大文件上传分块实现的博客&#xff0c;代码实现过于复杂且冗长&#xff0c;而且没有进行外网上传的测试。因此&#xff0c;我决定自己动手实现一个大文件上传&#xff0c;并进行优化。 实现思路 在许多应用中&#xff0c;大文件上传是常见的需求&…
阅读更多...
低代码开发中的创新实践

低代码开发中的创新实践

在软件开发领域&#xff0c;传统开发模式长期占据主导地位&#xff0c;其严谨的流程和规范为众多大型系统的构建奠定了基础。但随着数字化浪潮的席卷&#xff0c;业务需求的快速变化和对开发效率的高要求&#xff0c;传统开发思维逐渐显露出局限性。低代码开发的兴起&#xff0…
阅读更多...
数据库高安全—审计追踪：传统审计统一审计

数据库高安全—审计追踪：传统审计统一审计

书接上文数据库高安全—角色权限&#xff1a;权限管理&权限检查&#xff0c;从权限管理和权限检查方面解读了高斯数据库的角色权限&#xff0c;本篇将从传统审计和统一审计两方面对高斯数据库的审计追踪技术进行解读。 4 审计追踪 4.1 传统审计 审计内容的记录方式通…
阅读更多...
docker常用基础

docker常用基础

镜像 拉取 docker pull id删除 docker rmi id查看 docker images容器 运行 docker run -p 本:远 id查看 docker ps停止 docker stop id转换 导出容器&#xff08;镜像实例的文件变化&#xff09; docker export id > 名.tar导入容器&#xff08;镜像实例的文件变化…
阅读更多...
C++多线程编程——call_once和单例模式

C++多线程编程——call_once和单例模式

目录 1. 前言 2. call_once和once_flag 3. 后记 3.1 单例类的析构问题 3.2 饿汉式单例模式的线程安全问题 1. 前言 之前在讲解单例模式时&#xff0c;有提到懒汉式单例模式使用了双重检测Double-Checked Locking Pattern (DCLP)来解决多线程的安全访问问题。但是该方法也…
阅读更多...
最新文章

Copyright @ 2022~2023