Qt6中如何检测给定文件的音频格式是否受支持？

安全阿岳

2026-8-2

解决Qt6中获取媒体文件音频编码的问题

可行方案

方案1：使用QMediaFormat::fromFile直接检测文件

QMediaFormat提供了fromFile静态方法，可以直接从文件中解析出媒体格式信息，进而获取音频编码：

#include <QMediaFormat>
#include <QDebug>

void getAudioCodecFromFile(const QString &filePath) {
    QMediaFormat format = QMediaFormat::fromFile(filePath);
    if (format.isValid()) {
        QMediaFormat::AudioCodec codec = format.audioCodec();
        qDebug() << "Audio codec:" << QMediaFormat::audioCodecName(codec);
    } else {
        qDebug() << "Failed to parse media file";
    }
}

该方法无需启动媒体播放，适合仅需获取文件格式信息的场景。

方案2：通过QMediaPlayer加载后获取元数据

如果需要结合QMediaPlayer使用，需等待媒体加载完成后，从元数据中提取音频编码：

#include <QMediaPlayer>
#include <QMediaMetaData>
#include <QDebug>

void setupMediaPlayer(const QString &filePath) {
    QMediaPlayer *player = new QMediaPlayer;
    player->setSource(QUrl::fromLocalFile(filePath));

    QObject::connect(player, &QMediaPlayer::mediaStatusChanged, [player](QMediaPlayer::MediaStatus status) {
        if (status == QMediaPlayer::LoadedMedia) {
            QVariant codecVariant = player->metaData(QMediaMetaData::AudioCodec);
            if (codecVariant.isValid()) {
                QString codecName = codecVariant.toString();
                // 可将名称转换为QMediaFormat::AudioCodec枚举值
                QMediaFormat::AudioCodec codec = QMediaFormat::audioCodecFromString(codecName);
                qDebug() << "Audio codec:" << codecName << "(" << static_cast<int>(codec) << ")";
            } else {
                qDebug() << "Audio codec metadata not available";
            }
        }
    });
}

注意：部分平台或文件格式可能无法提供完整元数据，此时方案1的兼容性更优。