# SDL2頭文件路徑
INCLUDEPATH += D:/SDL2-2.28.0/x86_64-w64-mingw32/include
# SDL2庫(kù)文件路徑
LIBS += -LD:/SDL2-2.28.0/x86_64-w64-mingw32/lib -lSDL2

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

int main(int argc, char *argv[])
{
    // 創(chuàng)建Qt應(yīng)用對(duì)象，管理程序生命周期
    QApplication a(argc, argv);
    // 創(chuàng)建主窗口對(duì)象
    MainWindow w;
    // 顯示主窗口
    w.show();
    // 進(jìn)入Qt的事件循環(huán)（等待用戶操作，比如點(diǎn)擊按鈕）
    return a.exec();
}

#ifndef PLAYTHREAD_H
#define PLAYTHREAD_H

// Qt線程頭文件
#include <QThread>

// 播放線程類，繼承QThread
class playThread : public QThread
{
    // Qt信號(hào)槽必須的宏
    Q_OBJECT

private:
    // 重寫QThread的run方法，線程啟動(dòng)后會(huì)執(zhí)行這里的邏輯
    void run();

public:
    // 構(gòu)造函數(shù)，parent是父對(duì)象（Qt的父子機(jī)制自動(dòng)管理內(nèi)存）
    explicit playThread(QObject *parent = nullptr);
    // 析構(gòu)函數(shù)，釋放資源
    ~playThread();

signals:
    // 暫時(shí)沒定義信號(hào)，后續(xù)可擴(kuò)展（比如播放完成信號(hào)）
};

#endif // PLAYTHREAD_H

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

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

// Qt的UI命名空間（.ui文件自動(dòng)生成的代碼）
QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

private slots:
    // 播放按鈕點(diǎn)擊的槽函數(shù)（和UI里的按鈕關(guān)聯(lián)）
    void on_playBtn_clicked();

private:
    // 指向UI界面的指針（自動(dòng)生成）
    Ui::MainWindow *ui;
    // 播放線程的指針，初始化為nullptr
    playThread *_playThread = nullptr;
};
#endif // MAINWINDOW_H

#include "mainwindow.h"
#include "ui_mainwindow.h"
// SDL2頭文件（音頻相關(guān)）
#include <SDL2/SDL.h>
// Qt調(diào)試輸出
#include <QDebug>

// 主窗口構(gòu)造函數(shù)
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    // 初始化UI界面（加載按鈕等控件）
    ui->setupUi(this);
}

// 主窗口析構(gòu)函數(shù)
MainWindow::~MainWindow()
{
    // 釋放UI資源
    delete ui;
}

// 播放按鈕點(diǎn)擊觸發(fā)的槽函數(shù)
void MainWindow::on_playBtn_clicked()
{
    // 如果線程已存在（正在播放），則停止播放
    if(_playThread)
    {
        // 向線程發(fā)送“中斷請(qǐng)求”
        _playThread->requestInterruption();
        // 清空線程指針
        _playThread = nullptr;
        // 按鈕文字改回“開始播放”
        ui->playBtn->setText("開始播放");
    }
    else // 線程不存在（未播放），則開始播放
    {
        // 創(chuàng)建播放線程，父對(duì)象設(shè)為主窗口（自動(dòng)管理內(nèi)存）
        _playThread = new playThread(this);
        // 啟動(dòng)線程（會(huì)執(zhí)行playThread的run方法）
        _playThread->start();
        
        // 監(jiān)聽線程結(jié)束信號(hào)：線程播放完成后，重置狀態(tài)
        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"

// 音頻緩沖區(qū)結(jié)構(gòu)體：給SDL回調(diào)函數(shù)傳遞PCM數(shù)據(jù)和長(zhǎng)度
typedef struct
{
    int len = 0;      // 剩余未播放的PCM數(shù)據(jù)長(zhǎng)度
    int pullLen = 0;  // 本次要填充的PCM數(shù)據(jù)長(zhǎng)度
    Uint8 *data = nullptr; // 指向PCM數(shù)據(jù)的指針
}AudioBuffer;

// 播放線程構(gòu)造函數(shù)
playThread::playThread(QObject *parent):QThread{parent}
{
    // 線程結(jié)束后自動(dòng)銷毀（避免內(nèi)存泄漏）
    connect(this,&playThread::finished,this,&playThread::deleteLater);
}

// 播放線程析構(gòu)函數(shù)（關(guān)鍵：安全停止線程+釋放資源）
playThread::~playThread()
{
    // 斷開所有信號(hào)槽
    disconnect();
    // 發(fā)送中斷請(qǐng)求
    requestInterruption();
    // 退出線程事件循環(huán)
    quit();
    // 等待線程結(jié)束（防止線程還在運(yùn)行就銷毀）
    wait();

    qDebug() << this << "析構(gòu)了";
}

// SDL音頻回調(diào)函數(shù)（音頻設(shè)備會(huì)主動(dòng)調(diào)用這個(gè)函數(shù)“拉取”數(shù)據(jù)）
// userdata：自定義數(shù)據(jù)（這里傳AudioBuffer）
// stream：音頻設(shè)備的緩沖區(qū)，需要往里面填PCM數(shù)據(jù)
// len：音頻設(shè)備希望填充的字節(jié)數(shù)
void pull_audio_data(void *userdata, Uint8 *stream, int len)
{
    qDebug() << "音頻設(shè)備拉取數(shù)據(jù)，期望長(zhǎng)度：" << len;

    // 第一步：清空stream（靜音處理，避免填充數(shù)據(jù)前有雜音）
    SDL_memset(stream,0,len);

    // 取出我們傳遞的AudioBuffer
    AudioBuffer *buffer = (AudioBuffer*)userdata;

    // 如果沒有可用的PCM數(shù)據(jù)，直接返回（靜音）
    if(buffer->len <= 0)    return;

    // 第二步：確定本次要填充的長(zhǎng)度（取“設(shè)備期望長(zhǎng)度”和“剩余數(shù)據(jù)長(zhǎng)度”的最小值）
    buffer->pullLen = (len > buffer->len) ? buffer->len : len;

    // 第三步：填充PCM數(shù)據(jù)到音頻設(shè)備緩沖區(qū)
    // SDL_MixAudio：混合音頻（這里直接用最大音量）
    SDL_MixAudio(stream, buffer->data, buffer->pullLen, SDL_MIX_MAXVOLUME);
    
    // 第四步：更新緩沖區(qū)狀態(tài)（已播放的數(shù)據(jù)要跳過）
    buffer->data += buffer->pullLen;  // 指針后移，指向剩余數(shù)據(jù)
    buffer->len -= buffer->pullLen;   // 剩余長(zhǎng)度減少
}

// 線程的核心執(zhí)行函數(shù)（播放邏輯全在這里）
void playThread::run()
{
    // 1. 初始化SDL的音頻子系統(tǒng)
    if(SDL_Init(SDL_INIT_AUDIO)) // 非0表示失敗
    {
        qDebug() << "SDL初始化失敗：" << SDL_GetError();
        return;
    }

    // 2. 加載WAV文件
    SDL_AudioSpec spec;    // 存儲(chǔ)WAV文件的音頻規(guī)格（采樣率、聲道數(shù)等）
    Uint8 *data = nullptr; // 指向WAV文件的PCM原始數(shù)據(jù)
    Uint32 len = 0;        // PCM數(shù)據(jù)的總長(zhǎng)度
    if(!SDL_LoadWAV(FILENAME,&spec,&data,&len)) // 加載失敗返回0
    {
        qDebug() << "加載WAV文件失敗：" << SDL_GetError();
        SDL_Quit(); // 失敗則釋放SDL資源
        return;
    }

    // 3. 配置音頻播放參數(shù)
    spec.samples = 1024;          // 音頻緩沖區(qū)的樣本數(shù)（常用1024）
    spec.callback = pull_audio_data; // 設(shè)置音頻回調(diào)函數(shù)（設(shè)備拉數(shù)據(jù)時(shí)調(diào)用）
    AudioBuffer buffer;           // 創(chuàng)建音頻緩沖區(qū)
    buffer.data = data;           // 綁定PCM數(shù)據(jù)
    buffer.len = len;             // 綁定PCM數(shù)據(jù)長(zhǎng)度
    spec.userdata = &buffer;      // 給回調(diào)函數(shù)傳自定義數(shù)據(jù)（AudioBuffer）

    // 4. 打開音頻設(shè)備
    if(SDL_OpenAudio(&spec,nullptr)) // 失敗返回非0
    {
        qDebug() << "打開音頻設(shè)備失?。? << SDL_GetError();
        SDL_FreeWAV(data); // 釋放WAV數(shù)據(jù)
        SDL_Quit();        // 釋放SDL資源
        return;
    }

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

    // 6. 計(jì)算音頻參數(shù)（用于后續(xù)等待播放完成）
    int sampleSize = SDL_AUDIO_BITSIZE(spec.format); // 每個(gè)樣本的位數(shù)（比如16位）
    // 每個(gè)樣本的字節(jié)數(shù) = (位數(shù) * 聲道數(shù)) / 8（8位=1字節(jié)）
    int bytesPerSample = (sampleSize * spec.channels) >> 3;

    // 7. 主線程循環(huán)：等待播放完成/收到中斷請(qǐng)求
    while(!isInterruptionRequested()) // 只要沒收到“停止”請(qǐng)求，就循環(huán)
    {
        // 如果還有未播放的PCM數(shù)據(jù)，繼續(xù)等待（回調(diào)函數(shù)會(huì)自動(dòng)處理）
        if(buffer.len > 0) continue;

        // 8. 播放完成：等待最后一批數(shù)據(jù)播放完畢
        if(buffer.len <= 0)
        {
            // 計(jì)算最后一批數(shù)據(jù)的播放時(shí)長(zhǎng)（毫秒）
            int samples = buffer.pullLen / bytesPerSample; // 樣本數(shù)
            int ms = samples * 1000 / spec.freq;           // 時(shí)長(zhǎng)=樣本數(shù)/采樣率*1000
            SDL_Delay(ms); // 等待播放完成
            break; // 退出循環(huán)
        }
    }

    // 9. 釋放資源（重中之重！）
    SDL_FreeWAV(data);    // 釋放WAV文件的PCM數(shù)據(jù)
    SDL_CloseAudio();     // 關(guān)閉音頻設(shè)備
    SDL_Quit();           // 釋放SDL所有子系統(tǒng)
}