Qt6开发跨平台音乐播放器（三）：Player

1. 目标

这一节我们来写一个功能完备的Player类，实现以下功能：

• 播放控制（播放/暂停）

• 音量控制

• 播放顺序控制

• 播放进度控制

2. 实现

实现播放功能可以用libVlc、ffmpeg和QMediaPlayer这几种方案，但libVlc和ffmpeg都太重了，我们的需求只是简单的播放音乐，所以当前选择QMediaPlayer。

创建一个player模块，包含一个继承QObject的Player类：

player
    - player.pri
    - player.h
    - player.cpp

在player.pri中添加multimedia模块：

QT += multimedia

Qt6对multimedia模块进行了大幅修改，与Qt5相比有巨大的不同（参考Changes to Qt Multimedia | Qt Multimedia 6.7.2），我们的代码Qt6以上才能编译，可以在pri文件中加入限制：

lessThan(QT_MAJOR_VERSION, 6): error("The minimum supported version is QT6"

2.1 播放控制

创建一个QMediaPlayer对象：

// player.h
class QMediaPlayer;
class Player : public QObject {
...
private:
    QMediaPlayer *m_player = nullptr;
};

// player.cpp
#include "player.h"
#include <QMediaPlayer>

Player::Player(QObject *parent) : QObject{parent} {
    m_player = new QMediaPlayer(this);
}

然后创建三个public的槽函数：

void Player::play(const QString &path) {
    m_player->setSource(QUrl(path));
    m_player->play();
}

void Player::pause() {
    m_player->pause();
}

void Player::stop() {
    m_player->stop();
}

2.2 音量控制

QMediaPlayer包含了默认的播放设备，用audioOutput函数返回一个QAudioOutput对象指针，该对象即可控制播放音量：

// 设置音量
void Player::setVolume(float vol) {
    QAudioOutput *device = m_player->audioOutput();
    if (nullptr != device) device->setVolume(vol);
}

// 设置静音
void Player::setMuted(bool muted) {
    QAudioOutput *device = m_player->audioOutput();
    if (nullptr != device) device->setMuted(muted);
}

也可以先设置播放设备，然后利用该设备来控制音量：

Player::Player(QObject *parent) : QObject{parent} {
    m_output = new QAudioOutput(this);
    m_player = new QMediaPlayer(this);
    m_player->setAudioOutput(m_output);
}

2.3 播放顺序控制

Qt6取消了QMediaPlaylist类，只在example代码中保留，所以播放顺序控制需要自己写Playlist类，或者从qt example代码中迁移QMediaPlaylist类，这里我们选择自定义Playlist类。

在player模块中添加一个Playlist类：

player
    - player.pri
    - player.h
    - player.cpp
    - playlist.h
    - playlist.cpp

主要提供以下几类接口：

// 歌曲管理接口
void setSongList(const QVariantList &songList);
void appendSong(const QVariantMap &song);
void insertSong(int index, const QVariantMap &song);
bool removeSong(int index);
void clear();
bool isEmpty() const;

// 播放模式
PLAYBACK_MODE playbackMode() const { return m_mode; }
void setPlaybackMode(PLAYBACK_MODE mode);

// 播放顺序管理
void setCurrentIndex(int index);
QString songAt(int index);
QString currentSong();
QString previousSong();
QString nextSong();

2.4 播放进度控制

这个比较简单：

// player.h
class Player : public QObject {
...
    void setPosition(qint64);
};

// player.cpp
void Player::setPosition(qint64 pos) {
    m_player->setPosition(pos);
}

---

PS: 代码已经开源在github：linqiaqun/music-player: A cross platform music player (github.com) 欢迎star/fork/issue