在本教程中，我们将介绍如何使用Qt框架和C++来实现一个音频播放器。通过创建一个AudioPlayer类，我们将展示如何使用Qt的QMediaPlayer和QAudioOutput类来播放音频文件（例如MP3文件）。以下内容将结合关键代码部分进行讲解。

源码工程下载

通过网盘分享的文件：音频播放单例
链接: https://pan.baidu.com/s/1LZHROEIuD8SfAV1ZX2zYvw?pwd=jkcf 提取码: jkcf

1. 创建AudioPlayer类

首先，我们创建一个AudioPlayer类来封装音频播放的功能。该类将提供播放、暂停、停止音频以及获取播放进度的接口。为了保证只有一个AudioPlayer实例存在，我们使用了单例模式。

QT       += core multimedia

1.1 音频播放器的单例模式

在AudioPlayer类中，我们通过静态函数instance()来获取类的单例实例，这确保了在整个应用程序中，只有一个AudioPlayer实例：

// 获取 AudioPlayer 类的单例实例
AudioPlayer& AudioPlayer::instance()
{
    static AudioPlayer instance;  // 静态局部变量，保证唯一实例
    return instance;
}

1.2 构造函数：初始化播放器

构造函数初始化了QMediaPlayer和QAudioOutput对象，并将它们连接起来。QMediaPlayer负责处理音频的播放，而QAudioOutput负责将音频数据输出到音频设备。

AudioPlayer::AudioPlayer(QObject *parent)
    : QObject(parent),
    mediaPlayer(new QMediaPlayer(this)),
    audioOutput(new QAudioOutput(this))
{
    mediaPlayer->setAudioOutput(audioOutput);  // 设置音频输出
}

2. 播放音频

要播放音频文件，我们使用QMediaPlayer的setSource()和play()方法。setSource()用于设置音频文件的路径，而play()则开始播放音频。

2.1 播放函数

在AudioPlayer类中，play()函数用于启动音频的播放。通过获取单例对象，我们调用playMP3()函数来设置音频源并开始播放：

void AudioPlayer::play(const QString &filePath)
{
    AudioPlayer& player = instance();  // 获取单例对象
    player.playMP3(filePath);  // 调用私有函数播放文件
}

void AudioPlayer::playMP3(const QString &filePath)
{
    mediaPlayer->setSource(QUrl::fromLocalFile(filePath));  // 设置媒体源文件
    mediaPlayer->play();  // 开始播放
}

2.2 音频文件的路径

setSource()方法的参数是一个QUrl对象，因此我们使用QUrl::fromLocalFile()将本地文件路径转换为QUrl格式。

3. 暂停与停止播放

为了控制音频播放，我们提供了暂停和停止的功能。QMediaPlayer提供了pause()和stop()方法来实现这两个功能。

3.1 暂停播放

在pause()方法中，我们通过获取AudioPlayer单例实例并调用mediaPlayer->pause()来暂停当前播放的音频：

void AudioPlayer::pause()
{
    AudioPlayer& player = instance();  // 获取单例对象
    player.mediaPlayer->pause();  // 暂停播放
}

3.2 停止播放

类似地，stop()方法通过调用mediaPlayer->stop()来停止音频播放，并将播放进度重置为起始位置：

void AudioPlayer::stop()
{
    AudioPlayer& player = instance();  // 获取单例对象
    player.mediaPlayer->stop();  // 停止播放
}

4. 获取播放进度

要获取当前音频的播放进度，我们使用QMediaPlayer的position()方法，它返回当前播放的毫秒数。

4.1 获取当前播放进度

通过静态函数position()，我们可以实时获取音频的播放进度：

qint64 AudioPlayer::position()
{
    AudioPlayer& player = instance();  // 获取单例对象
    return player.mediaPlayer->position();  // 获取当前播放进度
}

5. 音频状态变化与错误处理

QMediaPlayer具有一个mediaStatusChanged信号，当音频播放器的状态发生变化时，Qt会触发该信号。我们可以通过连接该信号到槽函数来处理不同的状态，比如播放、暂停、停止等。

5.1 处理状态变化

在onMediaStatusChanged()槽函数中，我们根据不同的状态（如播放、暂停、停止）打印相关信息：

void AudioPlayer::onMediaStatusChanged(QMediaPlayer::MediaStatus status)
{
    switch (status) {
    case QMediaPlayer::PlayingState:
        qDebug() << "正在播放音频...";
        break;
    case QMediaPlayer::PausedState:
        qDebug() << "音频已暂停。";
        break;
    case QMediaPlayer::StoppedState:
        qDebug() << "音频已停止。";
        break;
    case QMediaPlayer::BufferingMedia:
        qDebug() << "音频正在缓冲...";
        break;
    default:
        break;
    }
}

5.2 错误处理

当发生播放错误时，QMediaPlayer会发出errorOccurred信号。我们可以在onErrorOccurred()槽函数中捕获并处理错误信息：

void AudioPlayer::onErrorOccurred(QMediaPlayer::Error error, const QString &errorString)
{
    qDebug() << "发生错误:" << errorString;
}

6. 在main()函数中使用AudioPlayer

在main()函数中，我们可以创建一个简单的测试，播放音频、暂停音频以及停止音频。使用QTimer可以模拟延时操作。

6.1 示例代码

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 播放 MP3 文件
    AudioPlayer::play("1.mp3");

    // 5秒后暂停播放
    QTimer::singleShot(5000, []() {
        AudioPlayer::pause();
        qDebug() << "5秒后暂停音频播放。";
    });

    // 10秒后停止播放
    QTimer::singleShot(10000, []() {
        AudioPlayer::stop();
        qDebug() << "10秒后停止音频播放。";
    });

    return a.exec();
}

在上述代码中，音频将在5秒后暂停，10秒后停止。