/****************************************************************************************/
/*
 * 程序名：ol_MediaPlaylist.h
 * 功能描述：Qt6 媒體播放列表類，替代廢棄的 QMediaPlaylist，支持以下特性：
 *          - 自動(dòng)綁定 QMediaPlayer，監(jiān)聽播放完成狀態(tài)
 *          - 三種播放模式：單次播放、單曲循環(huán)、列表循環(huán)
 *          - 播放結(jié)束自動(dòng)切換曲目/循環(huán)播放
 *          - 索引/媒體資源自動(dòng)管理，適配 Qt6
 *          - 支持信號(hào)通知索引變化，與音頻播放器聯(lián)動(dòng)
 * 作者：ol
 * 適用標(biāo)準(zhǔn)：Qt 6.0及以上
 */
/****************************************************************************************/
#ifndef OL_MEDIAPLAYLIST_H
#define OL_MEDIAPLAYLIST_H
#include <QObject>
#include <QVector>
#include <QUrl>
#include <QMediaPlayer>
namespace ol
{
    /**
     * @brief 媒體播放列表類，適配 Qt6 QMediaPlayer
     * 實(shí)現(xiàn)播放列表管理、自動(dòng)循環(huán)切歌、播放模式控制，無需手動(dòng)處理音源切換
     */
    class MediaPlaylist : public QObject
    {
        Q_OBJECT
    public:
        /**
         * @brief 播放模式枚舉
         */
        enum class PlaybackMode : char
        {
            CurrentItemOnce, /**< 當(dāng)前曲目播放一次后自動(dòng)停止 */
            CurrentItemLoop, /**< 當(dāng)前曲目無限循環(huán)播放 */
            SequentialLoop   /**< 列表順序循環(huán)，尾首自動(dòng)銜接 */
        };
    private:
        QVector<QUrl> m_mediaList;   ///< 媒體資源 URL 列表
        int m_currentIndex;          ///< 當(dāng)前播放索引，-1 表示未選中
        PlaybackMode m_playbackMode; ///< 當(dāng)前播放模式
        QMediaPlayer* m_player;      ///< 綁定的 Qt 媒體播放器
    public:
        /**
         * @brief 構(gòu)造函數(shù)
         * @param parent 父對(duì)象
         */
        explicit MediaPlaylist(QObject* parent = nullptr);
        /**
         * @brief 向播放列表添加媒體資源
         * @param media 媒體資源 URL（支持 qrc 資源/本地文件）
         */
        void addMedia(const QUrl& media);
        /**
         * @brief 清空播放列表，重置索引
         */
        void clear();
        /**
         * @brief 設(shè)置當(dāng)前播放索引（自動(dòng)切換播放器音源）
         * @param index 目標(biāo)播放索引
         */
        void setCurrentIndex(int index);
        /**
         * @brief 獲取當(dāng)前播放索引
         * @return 當(dāng)前索引，-1 表示無效
         */
        inline int getCurrentIndex() const { return m_currentIndex; }
        /**
         * @brief 獲取當(dāng)前播放的媒體 URL
         * @return 有效 URL / 空 QUrl
         */
        QUrl getCurrentMedia() const;
        /**
         * @brief 獲取列表總媒體數(shù)量
         * @return 媒體資源總數(shù)
         */
        inline qsizetype getMediaCount() const { return m_mediaList.size(); }
        /**
         * @brief 設(shè)置播放模式
         * @param mode 目標(biāo)播放模式
         */
        inline void setPlaybackMode(PlaybackMode mode) { m_playbackMode = mode; }
        /**
         * @brief 獲取當(dāng)前播放模式
         * @return 播放模式枚舉值
         */
        inline PlaybackMode getPlaybackMode() const { return m_playbackMode; }
        /**
         * @brief 綁定 Qt 媒體播放器
         * @param player 待綁定的 QMediaPlayer 對(duì)象
         */
        void setPlayer(QMediaPlayer* player);
        /**
         * @brief 切換到下一首媒體
         * @return 下一首媒體的 URL
         */
        QUrl nextMedia();
        /**
         * @brief 切換到上一首媒體
         * @return 上一首媒體的 URL
         */
        QUrl previousMedia();
    signals:
        /**
         * @brief 播放索引改變信號(hào)，用于用戶未來功能擴(kuò)展
         * @param newIndex 新的播放索引
         */
        void currentIndexChanged(int newIndex);
    private slots:
        /**
         * @brief 監(jiān)聽播放器狀態(tài)，播放完成自動(dòng)處理切歌/循環(huán)
         * @param status 媒體播放狀態(tài)
         */
        void onMediaStatusChanged(QMediaPlayer::MediaStatus status);
    };
} // namespace ol
#endif // !OL_MEDIAPLAYLIST_H

/****************************************************************************************/
/*
 * 程序名：ol_MediaPlaylist.cpp
 * 功能描述：媒體播放列表類實(shí)現(xiàn)文件
 * 作者：ol
 */
/****************************************************************************************/
#include "ol_MediaPlaylist.h"
#include <QMediaPlayer>

namespace ol
{
    MediaPlaylist::MediaPlaylist(QObject* parent)
        : QObject(parent), m_currentIndex(-1), m_playbackMode(PlaybackMode::CurrentItemOnce), m_player(nullptr)
    {
    }

    void MediaPlaylist::addMedia(const QUrl& media)
    {
        m_mediaList.append(media);
        if (m_currentIndex == -1) setCurrentIndex(0);
    }

    void MediaPlaylist::clear()
    {
        m_mediaList.clear();
        m_currentIndex = -1;
        emit currentIndexChanged(m_currentIndex);
    }

    void MediaPlaylist::setCurrentIndex(int index)
    {
        if (index >= 0 && index < m_mediaList.size() && index != m_currentIndex)
        {
            m_currentIndex = index;
            emit currentIndexChanged(m_currentIndex);

            // 自動(dòng)切換播放器音源
            if (m_player) m_player->setSource(getCurrentMedia());
        }
    }

    QUrl MediaPlaylist::getCurrentMedia() const
    {
        if (m_currentIndex >= 0 && m_currentIndex < m_mediaList.size()) return m_mediaList.at(m_currentIndex);
        return QUrl();
    }

    void MediaPlaylist::setPlayer(QMediaPlayer* player)
    {
        // 斷開舊播放器連接
        if (m_player) disconnect(m_player, nullptr, this, nullptr);

        m_player = player;

        // 綁定狀態(tài)監(jiān)聽信號(hào)
        if (m_player)
        {
            connect(m_player, &QMediaPlayer::mediaStatusChanged, this, &MediaPlaylist::onMediaStatusChanged);

            // 默認(rèn)加載當(dāng)前音源
            const QUrl url = getCurrentMedia();
            if (url.isValid()) m_player->setSource(url);
        }
    }

    QUrl MediaPlaylist::nextMedia()
    {
        if (m_mediaList.isEmpty()) return QUrl();

        setCurrentIndex((m_currentIndex + 1) % m_mediaList.size());
        return getCurrentMedia();
    }

    QUrl MediaPlaylist::previousMedia()
    {
        if (m_mediaList.isEmpty()) return QUrl();

        setCurrentIndex((m_currentIndex - 1 + m_mediaList.size()) % m_mediaList.size());
        return getCurrentMedia();
    }

    void MediaPlaylist::onMediaStatusChanged(QMediaPlayer::MediaStatus status)
    {
        // 僅處理播放完成狀態(tài)
        if (status != QMediaPlayer::EndOfMedia || !m_player) return;
        if (m_mediaList.isEmpty()) return;

        switch (m_playbackMode)
        {
        case PlaybackMode::CurrentItemOnce:
            m_player->stop();
            break;
        case PlaybackMode::CurrentItemLoop:
            m_player->play();
            break;
        case PlaybackMode::SequentialLoop:
            nextMedia();
            m_player->play();
            break;
        }
    }

} // namespace ol

// 音頻控制類中初始化播放列表
BGMControl::BGMControl(QObject* parent) : QObject(parent)
{
    // 初始化5組音頻單元（男女音效/BGM/輔助音效/結(jié)束音效）
    for (int i = 0; i < 5; ++i)
    {
        QAudioOutput* output = new QAudioOutput(this);
        QMediaPlayer* player = new QMediaPlayer(this);
        ol::MediaPlaylist* playlist = new ol::MediaPlaylist(this);

        // 綁定播放器與播放列表
        player->setAudioOutput(output);
        playlist->setPlayer(player);
        output->setVolume(1.0f);

        // 配置播放模式（BGM列表循環(huán)，其他單次播放）
        if (i == 2) {
            playlist->setPlaybackMode(ol::MediaPlaylist::PlaybackMode::SequentialLoop);
        } else {
            playlist->setPlaybackMode(ol::MediaPlaylist::PlaybackMode::CurrentItemOnce);
        }

        m_outputs.push_back(output);
        m_players.push_back(player);
        m_playlists.push_back(playlist);
    }

    // 加載音頻資源
    initPlayList();
}

// 啟動(dòng)BGM示例
void BGMControl::startBGM(float volume)
{
    m_outputs[2]->setVolume(volume);
    m_playlists[2]->setCurrentIndex(0); // 選中第一個(gè)BGM
    m_players[2]->play();               // 開始播放
}