Ubuntu Qt媒体播放器项目：如何获取QMediaPlaylist中所有媒体元数据？

嘿，我刚好在Ubuntu上做过类似的Qt媒体播放器项目，给你几个实用的方案来获取QMediaPlaylist里所有歌曲的元数据：

这是最贴合Qt生态的方案，不需要额外依赖，核心思路是遍历播放列表里的每个QMediaContent，用临时的QMediaPlayer加载并读取元数据——因为元数据加载是异步的，所以要通过信号触发来获取。

实现步骤 #

• 遍历QMediaPlaylist的所有索引，逐个取出QMediaContent
• 用一个QMediaPlayer实例（或复用）加载每个媒体，监听mediaStatusChanged信号，当状态变为LoadedMedia时即可读取元数据
• 把获取到的元数据存入列表，待所有媒体处理完成后填充表格

代码示例 #

// 假设你已经初始化了QMediaPlaylist* playlist，以及用于存储元数据的列表
QList<QVariantMap> allTrackMetadata;

// 创建临时播放器用于加载元数据
QMediaPlayer* tempMetadataPlayer = new QMediaPlayer(this);

// 连接状态变化信号，处理元数据读取
connect(tempMetadataPlayer, &QMediaPlayer::mediaStatusChanged, this, [=](QMediaPlayer::MediaStatus status) {
    if (status == QMediaPlayer::LoadedMedia) {
        // 提取常用元数据字段，可根据需求扩展
        QVariantMap trackMeta;
        trackMeta["title"] = tempMetadataPlayer->metaData(QMediaMetaData::Title);
        trackMeta["artist"] = tempMetadataPlayer->metaData(QMediaMetaData::Artist);
        trackMeta["album"] = tempMetadataPlayer->metaData(QMediaMetaData::AlbumTitle);
        trackMeta["duration"] = tempMetadataPlayer->metaData(QMediaMetaData::Duration);
        trackMeta["filePath"] = tempMetadataPlayer->media().canonicalUrl().toLocalFile();

        allTrackMetadata.append(trackMeta);

        // 判断是否处理完所有媒体
        if (allTrackMetadata.size() == playlist->mediaCount()) {
            // 调用你的表格填充函数
            populatePlaylistTable(allTrackMetadata);
            // 释放临时播放器
            tempMetadataPlayer->deleteLater();
        } else {
            // 加载下一个媒体
            int nextIndex = allTrackMetadata.size();
            tempMetadataPlayer->setMedia(playlist->media(nextIndex));
        }
    } else if (status == QMediaPlayer::InvalidMedia) {
        // 处理媒体加载失败的情况
        qWarning() << "Failed to load media at index:" << allTrackMetadata.size();
        // 跳过错误媒体，继续处理下一个
        if (allTrackMetadata.size() < playlist->mediaCount()) {
            int nextIndex = allTrackMetadata.size();
            tempMetadataPlayer->setMedia(playlist->media(nextIndex));
        }
    }
});

// 开始加载第一个媒体（如果播放列表非空）
if (!playlist->isEmpty()) {
    tempMetadataPlayer->setMedia(playlist->media(0));
}

因为Ubuntu上Qt多媒体默认用GStreamer作为后端，我们可以直接调用GStreamer的GstDiscoverer来批量读取媒体元数据——这个方法不需要完整加载媒体文件，速度更快，但依赖GStreamer库，跨平台性稍差。

实现步骤 #

• 初始化GStreamer环境
• 创建GstDiscoverer实例，设置超时时间
• 为每个媒体文件路径添加到发现器，通过回调函数获取元数据
• 等待所有处理完成后整理数据填充表格

代码示例 #

首先在.pro文件中添加GStreamer依赖：

LIBS += -lgstreamer-1.0 -lgobject-2.0 -lglib-2.0

然后是C++代码：

#include <gst/gst.h>
#include <gst/discoverer/discoverer.h>

void loadAllPlaylistMetadata(QMediaPlaylist* playlist) {
    QList<QVariantMap> allTrackMetadata;
    QStringList filePaths;

    // 先从播放列表中提取所有文件路径
    for (int i = 0; i < playlist->mediaCount(); ++i) {
        QUrl mediaUrl = playlist->media(i).canonicalUrl();
        if (mediaUrl.isLocalFile()) {
            filePaths.append(mediaUrl.toLocalFile());
        }
    }

    // 初始化GStreamer
    gst_init(nullptr, nullptr);

    // 创建发现器，设置5秒超时
    GstDiscoverer* discoverer = gst_discoverer_new(5 * GST_SECOND, nullptr);

    // 定义发现完成的回调函数
    auto onMediaDiscovered = [](GstDiscoverer* discoverer, GstDiscovererInfo* info, GError* error, gpointer user_data) {
        QList<QVariantMap>* metadataList = static_cast<QList<QVariantMap>*>(user_data);
        if (error) {
            qWarning() << "Failed to discover media:" << error->message;
            g_error_free(error);
            return;
        }

        QVariantMap trackMeta;
        // 获取标签列表
        const GstTagList* tags = gst_discoverer_info_get_tags(info);
        if (tags) {
            gchar* title = nullptr;
            if (gst_tag_list_get_string(tags, GST_TAG_TITLE, &title)) {
                trackMeta["title"] = QString(title);
                g_free(title);
            }
            gchar* artist = nullptr;
            if (gst_tag_list_get_string(tags, GST_TAG_ARTIST, &artist)) {
                trackMeta["artist"] = QString(artist);
                g_free(artist);
            }
            gchar* album = nullptr;
            if (gst_tag_list_get_string(tags, GST_TAG_ALBUM, &album)) {
                trackMeta["album"] = QString(album);
                g_free(album);
            }
        }

        // 获取媒体时长
        gint64 duration = gst_discoverer_info_get_duration(info);
        trackMeta["duration"] = duration;

        // 获取文件路径
        gchar* uri = gst_discoverer_info_get_uri(info);
        trackMeta["filePath"] = QUrl(uri).toLocalFile();
        g_free(uri);

        metadataList->append(trackMeta);
    };

    // 连接发现信号
    gst_discoverer_connect(discoverer, "discovered", G_CALLBACK(onMediaDiscovered), &allTrackMetadata);

    // 启动发现器
    gst_discoverer_start(discoverer);

    // 添加所有文件到发现器
    for (const QString& path : filePaths) {
        GFile* file = g_file_new_for_path(path.toUtf8().constData());
        gst_discoverer_add_uri(discoverer, g_file_get_uri(file));
        g_object_unref(file);
    }

    // 等待所有媒体处理完成（比超时多1秒）
    g_usleep(6 * GST_SECOND);

    // 停止并释放资源
    gst_discoverer_stop(discoverer);
    g_object_unref(discoverer);
    gst_deinit();

    // 填充表格
    populatePlaylistTable(allTrackMetadata);
}

• 异步处理：元数据加载是异步操作，不能同步遍历直接读取，必须通过信号或回调等待加载完成
• 资源管理：临时的QMediaPlayer或GStreamer资源要记得及时释放，避免内存泄漏
• 错误处理：务必处理媒体加载失败的情况（比如损坏的文件），避免流程卡住
• Ubuntu依赖：确保安装了Qt多媒体插件和GStreamer依赖，执行以下命令安装：

  sudo apt install libqt5multimedia5-plugins gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly
  

内容的提问来源于stack exchange，提问作者Tung