Qt6替代废弃QMediaPlaylist的解决方案

/****************************************************************************************/
/*
 * 程序名：ol_MediaPlaylist.h
 * 功能描述：Qt6 媒体播放列表类，替代废弃的 QMediaPlaylist，支持以下特性：
 *          - 自动绑定 QMediaPlayer，监听播放完成状态
 *          - 三种播放模式：单次播放、单曲循环、列表循环
 *          - 播放结束自动切换曲目/循环播放
 *          - 索引/媒体资源自动管理，适配 Qt6
 *          - 支持信号通知索引变化，与音频播放器联动
 * 作者：ol
 * 适用标准：Qt 6.0及以上
 */
/****************************************************************************************/
#ifndef OL_MEDIAPLAYLIST_H
#define OL_MEDIAPLAYLIST_H
#include <QObject>
#include <QVector>
#include <QUrl>
#include <QMediaPlayer>
namespace ol
{
    /**
     * @brief 媒体播放列表类，适配 Qt6 QMediaPlayer
     * 实现播放列表管理、自动循环切歌、播放模式控制，无需手动处理音源切换
     */
    class MediaPlaylist : public QObject
    {
        Q_OBJECT
    public:
        /**
         * @brief 播放模式枚举
         */
        enum class PlaybackMode : char
        {
            CurrentItemOnce, /**< 当前曲目播放一次后自动停止 */
            CurrentItemLoop, /**< 当前曲目无限循环播放 */
            SequentialLoop   /**< 列表顺序循环，尾首自动衔接 */
        };
    private:
        QVector<QUrl> m_mediaList;   ///< 媒体资源 URL 列表
        int m_currentIndex;          ///< 当前播放索引，-1 表示未选中
        PlaybackMode m_playbackMode; ///< 当前播放模式
        QMediaPlayer* m_player;      ///< 绑定的 Qt 媒体播放器
    public:
        /**
         * @brief 构造函数
         * @param parent 父对象
         */
        explicit MediaPlaylist(QObject* parent = nullptr);
        /**
         * @brief 向播放列表添加媒体资源
         * @param media 媒体资源 URL（支持 qrc 资源/本地文件）
         */
        void addMedia(const QUrl& media);
        /**
         * @brief 清空播放列表，重置索引
         */
        void clear();
        /**
         * @brief 设置当前播放索引（自动切换播放器音源）
         * @param index 目标播放索引
         */
        void setCurrentIndex(int index);
        /**
         * @brief 获取当前播放索引
         * @return 当前索引，-1 表示无效
         */
        inline int getCurrentIndex() const { return m_currentIndex; }
        /**
         * @brief 获取当前播放的媒体 URL
         * @return 有效 URL / 空 QUrl
         */
        QUrl getCurrentMedia() const;
        /**
         * @brief 获取列表总媒体数量
         * @return 媒体资源总数
         */
        inline qsizetype getMediaCount() const { return m_mediaList.size(); }
        /**
         * @brief 设置播放模式
         * @param mode 目标播放模式
         */
        inline void setPlaybackMode(PlaybackMode mode) { m_playbackMode = mode; }
        /**
         * @brief 获取当前播放模式
         * @return 播放模式枚举值
         */
        inline PlaybackMode getPlaybackMode() const { return m_playbackMode; }
        /**
         * @brief 绑定 Qt 媒体播放器
         * @param player 待绑定的 QMediaPlayer 对象
         */
        void setPlayer(QMediaPlayer* player);
        /**
         * @brief 切换到下一首媒体
         * @return 下一首媒体的 URL
         */
        QUrl nextMedia();
        /**
         * @brief 切换到上一首媒体
         * @return 上一首媒体的 URL
         */
        QUrl previousMedia();
    signals:
        /**
         * @brief 播放索引改变信号，用于用户未来功能扩展
         * @param newIndex 新的播放索引
         */
        void currentIndexChanged(int newIndex);
    private slots:
        /**
         * @brief 监听播放器状态，播放完成自动处理切歌/循环
         * @param status 媒体播放状态
         */
        void onMediaStatusChanged(QMediaPlayer::MediaStatus status);
    };
} // namespace ol
#endif // !OL_MEDIAPLAYLIST_H

/****************************************************************************************/
/*
 * 程序名：ol_MediaPlaylist.cpp
 * 功能描述：媒体播放列表类实现文件
 * 作者：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);

            // 自动切换播放器音源
            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;

        // 绑定状态监听信号
        if (m_player)
        {
            connect(m_player, &QMediaPlayer::mediaStatusChanged, this, &MediaPlaylist::onMediaStatusChanged);

            // 默认加载当前音源
            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)
    {
        // 仅处理播放完成状态
        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/辅助音效/结束音效）
    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列表循环，其他单次播放）
        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();
}

// 启动BGM示例
void BGMControl::startBGM(float volume)
{
    m_outputs[2]->setVolume(volume);
    m_playlists[2]->setCurrentIndex(0); // 选中第一个BGM
    m_players[2]->play();               // 开始播放
}