Qt5官方demo解析集35——Music Player

本系列所有文章可以在这里查看http://blog.csdn.net/cloud_castle/article/category/2123873

接上文Qt5官方demo解析集34——Concentric Circles Example

光看标题大家可能觉得我们今天会聊一聊 Qt 中 multimedia 模块的相关内容，确实，该 demo 基于这个模块实现了一个音乐播放器，不过呢，我们今天更侧重于该 demo 中 winextras 模块的使用。

从名字可以猜到，该模块可以用来为我们提供一些Windows平台上额外的扩展功能，例如DWM(Desktop Window Manager) 特效，Aero Peek，Taskbar，Jump Lists，Thumbnail Toolbar等等，Qt为我们封装了相关 API 使得它们变得更加简单易用。如果大家对这些名词感到陌生，可以前往Qt 官网查看更详细的介绍：http://doc.qt.io/qt-5/qtwinextras-overview.html 。或者，我给大家举几个身边的栗子：

不知道大家有没有留意过，当我们在使用 Qt Creator 进行构建时，其任务栏图标上的进度状态？

或者当我们将鼠标左键放在QQ音乐任务栏图标上时，出现的上一曲、暂停、下一曲这些预览窗口按钮：

亦或是，右键点击QQ音乐出现的最近收听列表：

等等之类，我就不一一列举了，站在GUI的角度来说，这些东西绝不是可有可无的

细节决定成败，用户总是能够在一些小的细节上收获惊喜和感动。

那么，看看我们如何在 Qt 中使用这些贴心的小玩意儿。

记得在pro文件中添加

QT += winextras

然后看看main.cpp，这里面有个实用的关联文件格式的helper函数:

#include "musicplayer.h"#include <QApplication>#include <QFileInfo>#include <QSettings>#include <QIcon>#include <QDir>//! [0]static void associateFileTypes(const QStringList &fileTypes) // 这是一个helper函数，用来将某文件格式与本程序关联{    QString displayName = QGuiApplication::applicationDisplayName();    QString filePath = QCoreApplication::applicationFilePath();    QString fileName = QFileInfo(filePath).fileName();    QSettings settings("HKEY_CURRENT_USER\\Software\\Classes\\Applications\\" + fileName, QSettings::NativeFormat);    settings.setValue("FriendlyAppName", displayName);    settings.beginGroup("SupportedTypes");    foreach (const QString& fileType, fileTypes)        settings.setValue(fileType, QString());    settings.endGroup();    settings.beginGroup("shell");    settings.beginGroup("open");    settings.setValue("FriendlyAppName", displayName);    settings.beginGroup("Command");    settings.setValue(".", QChar('"') + QDir::toNativeSeparators(filePath) + QString("\" \"%1\""));}//! [0]int main(int argc, char *argv[]){    QApplication app(argc, argv);    app.setApplicationName("MusicPlayer");    app.setOrganizationName("QtWinExtras");    app.setOrganizationDomain("qt-project.org");    app.setApplicationDisplayName("QtWinExtras Music Player");    app.setWindowIcon(QIcon(":/logo.png"));    associateFileTypes(QStringList(".mp3"));                // helper函数的使用方式    MusicPlayer player;    const QStringList arguments = QCoreApplication::arguments();    if (arguments.size() > 1)                              // 如果打开参数包含文件名        player.playFile(arguments.at(1));                  // 则开始播放第一首    player.resize(300, 60);    player.show();    return app.exec();}

VolumeButton 类继承自QToolButton，使用 Qt 中的标准音量图像设置为自身图标，

setIcon(style()->standardIcon(QStyle::SP_MediaVolume));

并提供了一个可以调节音量的弹出菜单，并根据DWM的混合状态决定自身的显示状态，代码都很容易理解，就不贴出来了。

在MusicPlayer类中，首先记得

#include <QtWinExtras>

然后我们通过下面的函数来创建Jump Lists：

void MusicPlayer::createJumpList(){    QWinJumpList jumplist;    jumplist.recent()->setVisible(true);}

Taskbar的创建与Progress类似，我们将其与窗口上的进度条关联起来：

void MusicPlayer::createTaskbar(){    taskbarButton = new QWinTaskbarButton(this);    taskbarButton->setWindow(windowHandle());  // 使用窗口句柄作为参数    taskbarProgress = taskbarButton->progress();    connect(positionSlider, SIGNAL(valueChanged(int)), taskbarProgress, SLOT(setValue(int)));    connect(positionSlider, SIGNAL(rangeChanged(int,int)), taskbarProgress, SLOT(setRange(int,int)));    connect(&mediaPlayer, SIGNAL(stateChanged(QMediaPlayer::State)), this, SLOT(updateTaskbar()));}

要创建预览窗口按钮，首先需要创建一个QWinThumbnailToolBar，然后在上面添加按钮：

void MusicPlayer::createThumbnailToolBar(){    thumbnailToolBar = new QWinThumbnailToolBar(this);    thumbnailToolBar->setWindow(windowHandle());    playToolButton = new QWinThumbnailToolButton(thumbnailToolBar);    playToolButton->setEnabled(false);    playToolButton->setToolTip(tr("Play"));    playToolButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay));    connect(playToolButton, SIGNAL(clicked()), this, SLOT(togglePlayback()));    forwardToolButton = new QWinThumbnailToolButton(thumbnailToolBar);    forwardToolButton->setEnabled(false);    forwardToolButton->setToolTip(tr("Fast forward"));    forwardToolButton->setIcon(style()->standardIcon(QStyle::SP_MediaSeekForward));    connect(forwardToolButton, SIGNAL(clicked()), this, SLOT(seekForward()));    backwardToolButton = new QWinThumbnailToolButton(thumbnailToolBar);    backwardToolButton->setEnabled(false);    backwardToolButton->setToolTip(tr("Rewind"));    backwardToolButton->setIcon(style()->standardIcon(QStyle::SP_MediaSeekBackward));    connect(backwardToolButton, SIGNAL(clicked()), this, SLOT(seekBackward()));    thumbnailToolBar->addButton(backwardToolButton);    thumbnailToolBar->addButton(playToolButton);    thumbnailToolBar->addButton(forwardToolButton);    connect(&mediaPlayer, SIGNAL(positionChanged(qint64)), this, SLOT(updateThumbnailToolBar()));    connect(&mediaPlayer, SIGNAL(durationChanged(qint64)), this, SLOT(updateThumbnailToolBar()));    connect(&mediaPlayer, SIGNAL(stateChanged(QMediaPlayer::State)), this, SLOT(updateThumbnailToolBar()));}

最后我们看看程序运行效果：

在Win7下当我们暂停播放时，任务栏会出现一个暂停样式的图标，而在Win8中则表现为绿色的进度条变成了黄色：