★ FEATURED ARTICLE 1. 项目概述本文介绍如何基于 Qt 框架开发一款功能完整的音乐播放器。上层界面使用 Qt Widgets 构建底层解码调用 mplayer 播放器实现播放、暂停、上一曲、下一曲、时间显示、歌词显示、播放列表、播放模式、声音调控等核心功能。选择 mplayer 作为底层解码引擎可以借助其强大的格式兼容能力避免自行处理复杂的音频解码逻辑从而把开发重心放在界面交互与业务功能上。2. 开发环境准备在开始编码之前需要准备以下开发环境Qt 开发环境建议使用 Qt 5.15 或 Qt 6.x 版本安装 Qt Widgets 模块。mplayer 播放器确保系统已安装 mplayer并可通过命令行调用。编译器Windows 下可使用 MinGW 或 MSVCLinux 下使用 GCC。验证 mplayer 是否可用可在终端执行以下命令mplayer -version如果能够正常输出版本信息说明环境准备完成。3. 整体架构设计本项目的架构分为两层上层为 Qt 图形界面负责用户交互与状态展示底层为 mplayer 进程负责音频解码与播放控制。两层之间通过 Qt 的 QProcess 进行通信。整体架构如下图所示flowchart TD A[Qt 界面层] -- B[QProcess 通信层] B -- C[mplayer 进程] C -- D[音频输出] A -- E[播放列表管理] A -- F[歌词解析显示] A -- G[播放模式控制]Qt 界面层通过 QProcess 启动 mplayer 进程并向其标准输入写入控制命令同时读取标准输出解析播放状态信息。4. 核心类设计本项目主要设计以下几个核心类MainWindow主窗口类负责整体界面布局与菜单管理。PlayerCore播放核心类封装 mplayer 进程的启动、控制与状态解析。PlaylistManager播放列表管理类负责歌曲的添加、删除与排序。LyricParser歌词解析类负责 LRC 歌词文件的解析与时间轴同步。各类的职责划分清晰便于后续功能扩展与维护。5. 界面布局实现主窗口界面采用垂直布局从上到下依次为播放列表区域、歌词显示区域和控制区域。控制区域包含以下控件播放/暂停按钮切换播放与暂停状态。上一曲/下一曲按钮切换播放列表中的歌曲。时间标签显示当前播放时间与总时长。音量滑块调节播放音量。播放模式按钮切换顺序播放、随机播放、单曲循环等模式。界面布局代码如下// 创建控制按钮 QPushButton *playButton new QPushButton(播放, this); QPushButton *prevButton new QPushButton(上一曲, this); QPushButton *nextButton new QPushButton(下一曲, this); // 创建时间标签 QLabel *timeLabel new QLabel(00:00 / 00:00, this); // 创建音量滑块 QSlider *volumeSlider new QSlider(Qt::Horizontal, this); volumeSlider-setRange(0, 100); volumeSlider-setValue(80); // 创建播放模式按钮 QPushButton *modeButton new QPushButton(顺序播放, this); // 添加到水平布局 QHBoxLayout *controlLayout new QHBoxLayout; controlLayout-addWidget(prevButton); controlLayout-addWidget(playButton); controlLayout-addWidget(nextButton); controlLayout-addWidget(timeLabel); controlLayout-addWidget(volumeSlider); controlLayout-addWidget(modeButton);6. mplayer进程封装PlayerCore 类负责管理 mplayer 进程的生命周期。启动 mplayer 时需要传入音频文件路径并开启从标准输入读取控制命令的模式。启动 mplayer 的代码如下void PlayerCore::startPlayer(const QString filePath) { if (m_process m_process-state() ! QProcess::NotRunning) { m_process-kill(); } m_process new QProcess(this); QStringList args; args -slave -quiet -input file/dev/stdin; args filePath; connect(m_process, QProcess::readyReadStandardOutput, this, PlayerCore::parseOutput); m_process-start(mplayer, args); }使用-slave参数使 mplayer 进入从模式接受标准输入的控制命令-quiet参数减少不必要的输出信息。7. 播放控制命令实现播放、暂停、上一曲、下一曲等操作本质上是向 mplayer 进程发送控制命令。核心控制命令封装如下void PlayerCore::play() { writeCommand(pause); } void PlayerCore::pause() { writeCommand(pause); } void PlayerCore::stop() { writeCommand(stop); } void PlayerCore::seek(int seconds) { writeCommand(QString(seek %1 0).arg(seconds)); } void PlayerCore::setVolume(int volume) { writeCommand(QString(volume %1 1).arg(volume)); } void PlayerCore::writeCommand(const QString cmd) { if (m_process m_process-state() QProcess::Running) { m_process-write((cmd \n).toUtf8()); } }播放与暂停共用pause命令mplayer 会根据当前状态自动切换。8. 播放状态解析mplayer 在从模式下会持续输出播放状态信息包括当前播放时间、总时长等。PlayerCore 需要解析这些输出并更新界面显示。状态解析代码如下void PlayerCore::parseOutput() { while (m_process-canReadLine()) { QByteArray line m_process-readLine(); QString text QString::fromUtf8(line).trimmed(); if (text.startsWith(ANS_TIME_POSITION)) { double seconds text.mid(18).toDouble(); emit positionChanged(seconds); } else if (text.startsWith(ANS_LENGTH)) { double duration text.mid(11).toDouble(); emit durationChanged(duration); } } }解析得到的时间信息通过信号传递给主窗口用于更新时间标签显示。9. 播放列表管理PlaylistManager 类负责维护歌曲列表支持添加本地文件、删除歌曲、上下移动排序等操作。播放列表管理代码如下void PlaylistManager::addFiles(const QStringList filePaths) { for (const QString path : filePaths) { if (!m_playlist.contains(path)) { m_playlist.append(path); } } emit playlistChanged(); } void PlaylistManager::removeFile(int index) { if (index 0 index m_playlist.size()) { m_playlist.removeAt(index); emit playlistChanged(); } } QString PlaylistManager::nextFile(int currentIndex) { if (m_playlist.isEmpty()) return QString(); return m_playlist.at((currentIndex 1) % m_playlist.size()); }播放列表与 QListWidget 绑定用户点击列表项即可切换歌曲。10. 播放模式实现播放模式支持顺序播放、随机播放、单曲循环三种模式。通过一个枚举类型管理当前模式并在切换歌曲时根据模式决定下一曲的选取逻辑。播放模式切换代码如下void MainWindow::switchPlayMode() { switch (m_playMode) { case Sequential: m_playMode Random; modeButton-setText(随机播放); break; case Random: m_playMode SingleLoop; modeButton-setText(单曲循环); break; case SingleLoop: m_playMode Sequential; modeButton-setText(顺序播放); break; } } QString MainWindow::getNextTrack() { if (m_playMode Random) { return m_playlistManager.randomFile(); } return m_playlistManager.nextFile(m_currentIndex); }单曲循环模式下当前歌曲播放结束后自动重新播放同一首歌曲。11. 歌词显示实现歌词显示功能需要解析 LRC 格式的歌词文件并根据当前播放时间高亮对应的歌词行。歌词解析代码如下void LyricParser::parseLrcFile(const QString filePath) { m_lyrics.clear(); QFile file(filePath); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { return; } QTextStream stream(file); stream.setCodec(UTF-8); while (!stream.atEnd()) { QString line stream.readLine(); parseLine(line); } file.close(); } void LyricParser::parseLine(const QString line) { QRegularExpression regex(\\[(\\d{2}):(\\d{2})\\.(\\d{2})\\]); QRegularExpressionMatch match regex.match(line); if (match.hasMatch()) { int minute match.captured(1).toInt(); int second match.captured(2).toInt(); int centisecond match.captured(3).toInt(); double time minute * 60 second centisecond / 100.0; m_lyrics.append(qMakePair(time, match.captured(4))); } }歌词显示区域使用 QLabel 展示当前歌词并通过定时器根据播放时间更新高亮行。下面给出一个完整的 LRC 歌词解析与同步显示实战示例包含同名歌词文件自动匹配、多行时间戳处理以及基于 QListWidget 的高亮显示逻辑可直接运行。// lyricparser.h #ifndef LYRICSPARSER_H #define LYRICSPARSER_H #include QString #include QVector #include QPair class LyricsParser { public: // 歌词条目时间秒 歌词文本 using LyricLine QPairdouble, QString; // 根据歌曲文件路径自动匹配同名 .lrc 文件 static QString findLrcFile(const QString songPath); // 解析 LRC 文件支持一行多个时间戳 bool parseFile(const QString lrcPath); // 根据当前播放时间返回应高亮的歌词行索引 int currentLineIndex(double position) const; // 获取全部歌词行 const QVectorLyricLine lines() const { return m_lines; } private: void parseLine(const QString line); QVectorLyricLine m_lines; // 按时间排序的歌词行 }; #endif // LYRICSPARSER_H// lyricparser.cpp #include lyricparser.h #include QFile #include QFileInfo #include QTextStream #include QRegularExpression QString LyricsParser::findLrcFile(const QString songPath) { // 取歌曲文件所在目录与主文件名替换扩展名为 .lrc QFileInfo info(songPath); QString lrcPath info.absolutePath() / info.completeBaseName() .lrc; // 若同名 .lrc 存在则返回否则返回空字符串 return QFile::exists(lrcPath) ? lrcPath : QString(); } bool LyricsParser::parseFile(const QString lrcPath) { m_lines.clear(); QFile file(lrcPath); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { return false; } QTextStream stream(file); stream.setCodec(UTF-8); while (!stream.atEnd()) { parseLine(stream.readLine()); } file.close(); // 按时间升序排序保证高亮查找正确 std::sort(m_lines.begin(), m_lines.end(), [](const LyricLine a, const LyricLine b) { return a.first b.first; }); return !m_lines.isEmpty(); } void LyricsParser::parseLine(const QString line) { // 匹配 [mm:ss.xx] 格式xx 为百分秒 static QRegularExpression timeRegex(\\[(\\d{1,2}):(\\d{1,2})\\.(\\d{1,2})\\]); QRegularExpressionMatchIterator it timeRegex.globalMatch(line); // 提取时间戳后的歌词文本去掉所有时间标签 QString text line; text.remove(timeRegex); // 一行可能包含多个时间戳如 [00:12.34][00:45.67]歌词 while (it.hasNext()) { QRegularExpressionMatch match it.next(); int minute match.captured(1).toInt(); int second match.captured(2).toInt(); int centisecond match.captured(3).toInt(); double time minute * 60 second centisecond / 100.0; m_lines.append(qMakePair(time, text.trimmed())); } } int LyricsParser::currentLineIndex(double position) const { // 二分查找最后一个时间 position 的歌词行 int low 0, high m_lines.size() - 1, result -1; while (low high) { int mid (low high) / 2; if (m_lines[mid].first position) { result mid; low mid 1; } else { high mid - 1; } } return result; }// 在 MainWindow 中使用 QListWidget 显示歌词并高亮当前行 #include QListWidget #include QListWidgetItem #include QTimer class MainWindow : public QMainWindow { // ... 其他成员 private: LyricsParser m_lyricsParser; QListWidget *m_lyricList; // 歌词列表控件 QTimer *m_lyricTimer; // 歌词刷新定时器 int m_currentLyricIndex; // 当前高亮行索引 void loadLyric(const QString songPath); void updateLyricHighlight(double position); }; // 加载歌词自动匹配同名 .lrc 文件并填充列表 void MainWindow::loadLyric(const QString songPath) { // 1. 根据歌曲路径自动匹配同名 .lrc 文件 QString lrcPath LyricsParser::findLrcFile(songPath); if (lrcPath.isEmpty()) { m_lyricList-clear(); m_lyricList-addItem(未找到同名歌词文件); return; } // 2. 解析歌词文件 if (!m_lyricsParser.parseFile(lrcPath)) { m_lyricList-clear(); m_lyricList-addItem(歌词解析失败); return; } // 3. 将歌词行填充到 QListWidget m_lyricList-clear(); const auto lines m_lyricsParser.lines(); for (const auto line : lines) { m_lyricList-addItem(line.second); } // 4. 重置高亮状态 m_currentLyricIndex -1; m_lyricList-setCurrentRow(-1); } // 根据当前播放时间更新歌词高亮 void MainWindow::updateLyricHighlight(double position) { // 获取当前应高亮的歌词行索引 int index m_lyricsParser.currentLineIndex(position); if (index m_currentLyricIndex) { return; // 行未变化无需刷新 } m_currentLyricIndex index; // 清除上一行的高亮样式 if (index 0) { QListWidgetItem *prev m_lyricList-item(index - 1); if (prev) { prev-setForeground(Qt::gray); QFont font prev-font(); font.setBold(false); prev-setFont(font); } } // 高亮当前歌词行 if (index 0 index m_lyricList-count()) { QListWidgetItem *current m_lyricList-item(index); current-setForeground(QColor(0, 153, 255)); // 蓝色高亮 QFont font current-font(); font.setBold(true); current-setFont(font); // 滚动到当前行保证歌词始终可见 m_lyricList-scrollToItem(current, QAbstractItemView::PositionAtCenter); } } // 在播放状态解析中调用例如 // void MainWindow::onPositionChanged(double position) // { // updateTimeDisplay(position, m_duration); // updateLyricHighlight(position); // }上述示例完整覆盖了三个关键点通过findLrcFile根据歌曲路径自动匹配同名 .lrc 文件通过正则全局匹配处理一行多个时间戳的情况通过currentLineIndex二分查找并结合 QListWidget 实现当前歌词行的高亮与自动滚动。若希望使用 QLabel 单行显示只需将高亮逻辑改为m_lyricLabel-setText(currentLine)即可。12. 时间显示与进度控制时间标签显示当前播放位置与总时长格式为分:秒 / 分:秒。同时提供进度条用户可以通过拖动进度条跳转到指定位置。时间更新代码如下void MainWindow::updateTimeDisplay(double position, double duration) { QString posStr formatTime(position); QString durStr formatTime(duration); timeLabel-setText(posStr / durStr); if (duration 0) { progressSlider-setValue(static_castint(position / duration * 1000)); } } QString MainWindow::formatTime(double seconds) { int totalSeconds static_castint(seconds); int minute totalSeconds / 60; int sec totalSeconds % 60; return QString(%1:%2).arg(minute, 2, 10, QChar(0)) .arg(sec, 2, 10, QChar(0)); }进度条拖动时发送 seek 命令到 mplayer 实现跳转。13. 声音调控实现音量滑块控制 mplayer 的输出音量范围从 0 到 100。滑块值变化时实时发送 volume 命令。音量控制代码如下void MainWindow::onVolumeChanged(int value) { m_playerCore-setVolume(value); volumeLabel-setText(QString::number(value) %); }同时支持静音切换功能通过 mute 命令实现。14. 歌曲切换与自动播放当一首歌曲播放结束时根据当前播放模式自动切换到下一曲。mplayer 播放结束时会输出特定信息PlayerCore 解析后发出 finished 信号。自动切换代码如下void MainWindow::onPlaybackFinished() { if (m_playMode SingleLoop) { playCurrentTrack(); return; } m_currentIndex m_playlistManager.nextIndex(m_currentIndex); playCurrentTrack(); } void MainWindow::playCurrentTrack() { QString filePath m_playlistManager.fileAt(m_currentIndex); m_playerCore-startPlayer(filePath); loadLyric(filePath); updatePlaylistSelection(); }切换歌曲时同步加载对应的歌词文件并更新播放列表的选中状态。15. 完整项目结构项目文件结构如下MusicPlayer/ ├── main.cpp ├── mainwindow.h ├── mainwindow.cpp ├── playercore.h ├── playercore.cpp ├── playlistmanager.h ├── playlistmanager.cpp ├── lyricparser.h ├── lyricparser.cpp └── MusicPlayer.pro工程文件 MusicPlayer.pro 中需要添加 widgets 模块依赖。16. 总结本文完整实现了基于 Qt 与 mplayer 的音乐播放器覆盖了播放控制、播放列表、播放模式、歌词显示、时间显示、声音调控等核心功能。通过 QProcess 与 mplayer 的从模式通信实现了简洁可靠的播放控制方案。后续可以在此基础上扩展更多功能例如专辑封面显示、均衡器调节、网络歌词下载等进一步提升播放器的用户体验。
阅读完成 · 觉得有帮助？
