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();               // 开始播放
}