使用Qt+SDL2实现WAV音频播放功能

# SDL2头文件路径
INCLUDEPATH += D:/SDL2-2.28.0/x86_64-w64-mingw32/include
# SDL2库文件路径
LIBS += -LD:/SDL2-2.28.0/x86_64-w64-mingw32/lib -lSDL2

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    // 创建Qt应用对象，管理程序生命周期
    QApplication a(argc, argv);
    // 创建主窗口对象
    MainWindow w;
    // 显示主窗口
    w.show();
    // 进入Qt的事件循环（等待用户操作，比如点击按钮）
    return a.exec();
}

#ifndef PLAYTHREAD_H
#define PLAYTHREAD_H

// Qt线程头文件
#include <QThread>

// 播放线程类，继承QThread
class playThread : public QThread
{
    // Qt信号槽必须的宏
    Q_OBJECT

private:
    // 重写QThread的run方法，线程启动后会执行这里的逻辑
    void run();

public:
    // 构造函数，parent是父对象（Qt的父子机制自动管理内存）
    explicit playThread(QObject *parent = nullptr);
    // 析构函数，释放资源
    ~playThread();

signals:
    // 暂时没定义信号，后续可扩展（比如播放完成信号）
};

#endif // PLAYTHREAD_H

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
// 包含播放线程的头文件
#include "playthread.h"

// Qt的UI命名空间（.ui文件自动生成的代码）
QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    // 播放按钮点击的槽函数（和UI里的按钮关联）
    void on_playBtn_clicked();

private:
    // 指向UI界面的指针（自动生成）
    Ui::MainWindow *ui;
    // 播放线程的指针，初始化为nullptr
    playThread *_playThread = nullptr;
};
#endif // MAINWINDOW_H

#include "mainwindow.h"
#include "ui_mainwindow.h"
// SDL2头文件（音频相关）
#include <SDL2/SDL.h>
// Qt调试输出
#include <QDebug>

// 主窗口构造函数
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    // 初始化UI界面（加载按钮等控件）
    ui->setupUi(this);
}

// 主窗口析构函数
MainWindow::~MainWindow()
{
    // 释放UI资源
    delete ui;
}

// 播放按钮点击触发的槽函数
void MainWindow::on_playBtn_clicked()
{
    // 如果线程已存在（正在播放），则停止播放
    if(_playThread)
    {
        // 向线程发送“中断请求”
        _playThread->requestInterruption();
        // 清空线程指针
        _playThread = nullptr;
        // 按钮文字改回“开始播放”
        ui->playBtn->setText("开始播放");
    }
    else // 线程不存在（未播放），则开始播放
    {
        // 创建播放线程，父对象设为主窗口（自动管理内存）
        _playThread = new playThread(this);
        // 启动线程（会执行playThread的run方法）
        _playThread->start();
        
        // 监听线程结束信号：线程播放完成后，重置状态
        connect(_playThread,&playThread::finished,
                [this]()
                {
                    _playThread = nullptr;
                    ui->playBtn->setText("开始播放");
                });
        
        // 按钮文字改成“停止播放”
        ui->playBtn->setText("停止播放");
    }
}

#include "playthread.h"
#include <SDL2/SDL.h>
#include <QDebug>
#include <QFile>

// ！！！替换成你自己的WAV文件路径！！！
#define FILENAME "D:/in.wav"

// 音频缓冲区结构体：给SDL回调函数传递PCM数据和长度
typedef struct
{
    int len = 0;      // 剩余未播放的PCM数据长度
    int pullLen = 0;  // 本次要填充的PCM数据长度
    Uint8 *data = nullptr; // 指向PCM数据的指针
}AudioBuffer;

// 播放线程构造函数
playThread::playThread(QObject *parent):QThread{parent}
{
    // 线程结束后自动销毁（避免内存泄漏）
    connect(this,&playThread::finished,this,&playThread::deleteLater);
}

// 播放线程析构函数（关键：安全停止线程+释放资源）
playThread::~playThread()
{
    // 断开所有信号槽
    disconnect();
    // 发送中断请求
    requestInterruption();
    // 退出线程事件循环
    quit();
    // 等待线程结束（防止线程还在运行就销毁）
    wait();

    qDebug() << this << "析构了";
}

// SDL音频回调函数（音频设备会主动调用这个函数“拉取”数据）
// userdata：自定义数据（这里传AudioBuffer）
// stream：音频设备的缓冲区，需要往里面填PCM数据
// len：音频设备希望填充的字节数
void pull_audio_data(void *userdata, Uint8 *stream, int len)
{
    qDebug() << "音频设备拉取数据，期望长度：" << len;

    // 第一步：清空stream（静音处理，避免填充数据前有杂音）
    SDL_memset(stream,0,len);

    // 取出我们传递的AudioBuffer
    AudioBuffer *buffer = (AudioBuffer*)userdata;

    // 如果没有可用的PCM数据，直接返回（静音）
    if(buffer->len <= 0)    return;

    // 第二步：确定本次要填充的长度（取“设备期望长度”和“剩余数据长度”的最小值）
    buffer->pullLen = (len > buffer->len) ? buffer->len : len;

    // 第三步：填充PCM数据到音频设备缓冲区
    // SDL_MixAudio：混合音频（这里直接用最大音量）
    SDL_MixAudio(stream, buffer->data, buffer->pullLen, SDL_MIX_MAXVOLUME);
    
    // 第四步：更新缓冲区状态（已播放的数据要跳过）
    buffer->data += buffer->pullLen;  // 指针后移，指向剩余数据
    buffer->len -= buffer->pullLen;   // 剩余长度减少
}

// 线程的核心执行函数（播放逻辑全在这里）
void playThread::run()
{
    // 1. 初始化SDL的音频子系统
    if(SDL_Init(SDL_INIT_AUDIO)) // 非0表示失败
    {
        qDebug() << "SDL初始化失败：" << SDL_GetError();
        return;
    }

    // 2. 加载WAV文件
    SDL_AudioSpec spec;    // 存储WAV文件的音频规格（采样率、声道数等）
    Uint8 *data = nullptr; // 指向WAV文件的PCM原始数据
    Uint32 len = 0;        // PCM数据的总长度
    if(!SDL_LoadWAV(FILENAME,&spec,&data,&len)) // 加载失败返回0
    {
        qDebug() << "加载WAV文件失败：" << SDL_GetError();
        SDL_Quit(); // 失败则释放SDL资源
        return;
    }

    // 3. 配置音频播放参数
    spec.samples = 1024;          // 音频缓冲区的样本数（常用1024）
    spec.callback = pull_audio_data; // 设置音频回调函数（设备拉数据时调用）
    AudioBuffer buffer;           // 创建音频缓冲区
    buffer.data = data;           // 绑定PCM数据
    buffer.len = len;             // 绑定PCM数据长度
    spec.userdata = &buffer;      // 给回调函数传自定义数据（AudioBuffer）

    // 4. 打开音频设备
    if(SDL_OpenAudio(&spec,nullptr)) // 失败返回非0
    {
        qDebug() << "打开音频设备失败：" << SDL_GetError();
        SDL_FreeWAV(data); // 释放WAV数据
        SDL_Quit();        // 释放SDL资源
        return;
    }

    // 5. 开始播放（0=取消暂停，1=暂停）
    SDL_PauseAudio(0);

    // 6. 计算音频参数（用于后续等待播放完成）
    int sampleSize = SDL_AUDIO_BITSIZE(spec.format); // 每个样本的位数（比如16位）
    // 每个样本的字节数 = (位数 * 声道数) / 8（8位=1字节）
    int bytesPerSample = (sampleSize * spec.channels) >> 3;

    // 7. 主线程循环：等待播放完成/收到中断请求
    while(!isInterruptionRequested()) // 只要没收到“停止”请求，就循环
    {
        // 如果还有未播放的PCM数据，继续等待（回调函数会自动处理）
        if(buffer.len > 0) continue;

        // 8. 播放完成：等待最后一批数据播放完毕
        if(buffer.len <= 0)
        {
            // 计算最后一批数据的播放时长（毫秒）
            int samples = buffer.pullLen / bytesPerSample; // 样本数
            int ms = samples * 1000 / spec.freq;           // 时长=样本数/采样率*1000
            SDL_Delay(ms); // 等待播放完成
            break; // 退出循环
        }
    }

    // 9. 释放资源（重中之重！）
    SDL_FreeWAV(data);    // 释放WAV文件的PCM数据
    SDL_CloseAudio();     // 关闭音频设备
    SDL_Quit();           // 释放SDL所有子系统
}