如何基于底层系统环境获取QMediaPlayer支持的视频容器列表

核心原理 #

Qt Multimedia模块的QMediaService接口可直接查询当前运行环境下QMediaPlayer支持的所有容器格式、编解码器信息，查询结果和系统安装的编解码器、Qt使用的多媒体后端（Windows下默认DirectShow、Linux下默认GStreamer、macOS下默认AVFoundation）完全对应，符合动态适配文件过滤器的需求。

代码实现 #

C++ 版本 #

#include <QMediaPlayer>
#include <QMediaService>
#include <QMimeDatabase>
#include <QDebug>

// 在QMediaPlayer初始化完成后调用
QStringList getSupportedVideoMimeTypes(QMediaPlayer* player) {
    QStringList supportedVideoTypes;
    QMediaService* service = player->service();
    if (!service) {
        return supportedVideoTypes;
    }
    // 查询QMediaPlayer支持的所有MIME类型
    QList<QString> allSupportedMimes = service->supportedMimeTypes(QMediaPlayer::Media);
    QMimeDatabase mimeDb;
    for (const QString& mime : allSupportedMimes) {
        // 筛选仅视频类型，过滤纯音频类型
        if (mime.startsWith("video/")) {
            supportedVideoTypes.append(mime);
            // 可同时获取对应文件后缀，用于组装文件过滤器
            QList<QMimeType> mimeTypes = mimeDb.allMimeTypes();
            for (const QMimeType& mt : mimeTypes) {
                if (mt.name() == mime) {
                    qDebug() << "支持格式：" << mime << "后缀：" << mt.suffixes();
                }
            }
        }
    }
    return supportedVideoTypes;
}

PySide2/PyQt 版本 #

from PySide2.QtMultimedia import QMediaPlayer, QMimeDatabase

def get_supported_video_mime_types(player: QMediaPlayer) -> list:
    supported_video_types = []
    service = player.service()
    if not service:
        return supported_video_types
    all_supported_mimes = service.supportedMimeTypes(QMediaPlayer.Media)
    mime_db = QMimeDatabase()
    for mime in all_supported_mimes:
        if mime.startsWith("video/"):
            supported_video_types.append(mime)
            # 打印对应后缀
            mt = mime_db.mimeTypeForName(mime)
            print(f"支持格式：{mime}，后缀：{mt.suffixes()}")
    return supported_video_types

结果使用 #

拿到支持的后缀列表后，可直接组装成QFileDialog的过滤器字符串，仅展示当前环境可播放的视频文件，避免用户选择不支持的格式触发报错。

MP4播放异常补充说明 #

Windows环境下Qt默认使用DirectShow作为多媒体后端，原生仅支持有限的编码格式，MP4文件通常需要H.264解码支持，若系统未安装对应编解码器包就会触发ResourceError且无明确报错信息，可在程序中提示用户安装通用编解码器包解决该问题。

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