QMediaFormat Class
Décrit un format d'encodage pour un fichier ou un flux multimédia. En savoir plus...
| En-tête : | #include <QMediaFormat> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake : | QT += multimedia |
Types publics
| enum class | AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified } |
| enum | ConversionMode { Encode, Decode } |
| enum | FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat } |
| enum | ResolveFlags { NoFlags, RequiresVideo } |
| enum class | VideoCodec { VP8, MPEG2, MPEG1, WMV, H265, …, Unspecified } |
Propriétés
- audioCodec : AudioCodec
- fileFormat : FileFormat
- videoCodec : VideoCodec
Fonctions publiques
| QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat) | |
| QMediaFormat(const QMediaFormat &other) | |
| QMediaFormat(QMediaFormat &&other) | |
| ~QMediaFormat() | |
| QMediaFormat::AudioCodec | audioCodec() const |
| QMediaFormat::FileFormat | fileFormat() const |
| bool | isSupported(QMediaFormat::ConversionMode mode) const |
| QMimeType | mimeType() const |
| void | resolveForEncoding(QMediaFormat::ResolveFlags flags) |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
| void | setFileFormat(QMediaFormat::FileFormat f) |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
| QList<QMediaFormat::AudioCodec> | supportedAudioCodecs(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::FileFormat> | supportedFileFormats(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::VideoCodec> | supportedVideoCodecs(QMediaFormat::ConversionMode m) |
| void | swap(QMediaFormat &other) |
| QMediaFormat::VideoCodec | videoCodec() const |
| bool | operator!=(const QMediaFormat &other) const |
| QMediaFormat & | operator=(QMediaFormat &&other) |
| QMediaFormat & | operator=(const QMediaFormat &other) |
| bool | operator==(const QMediaFormat &other) const |
Membres publics statiques
| QString | audioCodecDescription(QMediaFormat::AudioCodec codec) |
| QString | audioCodecName(QMediaFormat::AudioCodec codec) |
| QString | fileFormatDescription(QMediaFormat::FileFormat fileFormat) |
| QString | fileFormatName(QMediaFormat::FileFormat fileFormat) |
| QString | videoCodecDescription(QMediaFormat::VideoCodec codec) |
| QString | videoCodecName(QMediaFormat::VideoCodec codec) |
Description détaillée
QMediaFormat décrit un format d’encodage pour un fichier ou un flux multimédia.
Vous pouvez vérifier si un format multimédia donné peut être utilisé pour l'encodage ou le décodage à l'aide de QMediaFormat.
Documentation sur les types de membres
enum class QMediaFormat::AudioCodec
Décrit le codec audio utilisé dans un fichier multimédia ou un flux.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Windows Media Audio |
QMediaFormat::AudioCodec::AC3 | 2 | Dolby Digital |
QMediaFormat::AudioCodec::AAC | 1 | Codage audio avancé |
QMediaFormat::AudioCodec::ALAC | 10 | Codec audio Apple Lossless |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | Dolby TrueHD |
QMediaFormat::AudioCodec::EAC3 | 3 | Dolby Digital Plus (EAC3) |
QMediaFormat::AudioCodec::MP3 | 0 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
QMediaFormat::AudioCodec::Wave | 8 | Format de fichier audio Waveform |
QMediaFormat::AudioCodec::Vorbis | 7 | Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC | 4 | Codec audio sans perte libre |
QMediaFormat::AudioCodec::Opus | 6 | Format audio Opus |
QMediaFormat::AudioCodec::Unspecified | -1 | Codec non spécifié |
enum QMediaFormat::ConversionMode
Dans de nombreux cas, les systèmes présentent des capacités asymétriques et sont souvent capables de décoder davantage de formats ou de codecs qu’ils ne peuvent en encoder. Cette énumération décrit le mode de conversion demandé à utiliser pour vérifier si un format de fichier ou un codec donné est pris en charge.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::Encode | 0 | Permet de vérifier si un format de fichier ou un codec donné peut être encodé. |
QMediaFormat::Decode | 1 | Permet de vérifier si un format de fichier ou un codec donné peut être décodé. |
Voir également supportedFileFormats, supportedAudioCodecs et supportedVideoCodecs.
enum QMediaFormat::FileFormat
Décrit le format de conteneur utilisé dans un fichier multimédia ou un flux.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::WMA | 9 | Windows Media Audio |
QMediaFormat::AAC | 8 | Codage audio avancé |
QMediaFormat::Matroska | 2 | Matroska (MKV) |
QMediaFormat::WMV | 0 | Windows Media Video |
QMediaFormat::MP3 | 10 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
QMediaFormat::Wave | 12 | Format de fichier audio Waveform |
QMediaFormat::Ogg | 4 | Ogg |
QMediaFormat::MPEG4 | 3 | MPEG-4 |
QMediaFormat::AVI | 1 | Audio Video Interleave |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4 Partie 3 ou MPEG-4 Audio (officiellement ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | Codec audio sans perte libre |
QMediaFormat::UnspecifiedFormat | -1 | Le format n'est pas spécifié. |
enum QMediaFormat::ResolveFlags
Décrit les exigences relatives au choix d’un format adapté pour QMediaRecorder.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::NoFlags | 0 | Aucune exigence |
QMediaFormat::RequiresVideo | 1 | Un codec vidéo est requis |
Voir aussi resolveForEncoding().
enum class QMediaFormat::VideoCodec
Décrit le codec vidéo utilisé dans un fichier multimédia ou un flux.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::VideoCodec::VP8 | 5 | VP8 |
QMediaFormat::VideoCodec::MPEG2 | 1 | MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 | 0 | MPEG-1 |
QMediaFormat::VideoCodec::WMV | 9 | Windows Media Video |
QMediaFormat::VideoCodec::H265 | 4 | Codage vidéo à haute efficacité (HEVC) |
QMediaFormat::VideoCodec::H264 | 3 | Codage vidéo avancé |
QMediaFormat::VideoCodec::MPEG4 | 2 | MPEG-4 |
QMediaFormat::VideoCodec::AV1 | 7 | AOMedia Video 1 |
QMediaFormat::VideoCodec::MotionJPEG | 10 | MotionJPEG |
QMediaFormat::VideoCodec::VP9 | 6 | VP9 |
QMediaFormat::VideoCodec::Theora | 8 | Theora |
QMediaFormat::VideoCodec::Unspecified | -1 | Codec vidéo non spécifié |
Documentation sur les propriétés
audioCodec : AudioCodec
Cette propriété contient le codec audio du fichier multimédia.
Fonctions d'accès :
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
Voir également QMediaFormat::AudioCodec.
fileFormat : FileFormat
Cette propriété indique le format de fichier (conteneur) du média.
Fonctions d'accès :
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
Voir également QMediaFormat::FileFormat.
videoCodec : VideoCodec
Cette propriété indique le codec vidéo du fichier multimédia.
Fonctions d'accès :
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
Voir aussi QMediaFormat::VideoCodec.
Documentation des fonctions membres
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
Crée un objet QMediaFormat pour format.
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
Crée un objet QMediaFormat en le copiant à partir de other.
[constexpr noexcept default] QMediaFormat::QMediaFormat(QMediaFormat &&other)
Crée un objet QMediaFormat à partir de other.
[noexcept] QMediaFormat::~QMediaFormat()
Supprime l'objet « QMediaFormat ».
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
Renvoie le codec audio utilisé dans ce format.
Remarque : fonctiongetter pour la propriété audioCodec.
Voir également setAudioCodec() et QMediaFormat::AudioCodec.
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
Renvoie une description pour ` codec`.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
Renvoie un nom sous forme de chaîne de caractères pour codec.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
Renvoie une description de la fonction fileFormat.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
Renvoie un nom sous forme de chaîne de caractères pour fileFormat.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QMediaFormat::isSupported(QMediaFormat::ConversionMode mode) const
Renvoie « true » si Qt Multimedia peut encoder ou décoder ce format, en fonction de mode.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
QMimeType QMediaFormat::mimeType() const
Renvoie le type MIME correspondant au format de fichier utilisé dans ce format multimédia.
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
Convertit le format, en se basant sur flags, en un format pris en charge par QMediaRecorder.
Cette méthode tente de trouver la meilleure correspondance possible pour les paramètres non spécifiés. Les paramètres non pris en charge par l'enregistreur seront modifiés pour correspondre au mieux à ceux qui sont pris en charge.
Lors de la conversion, la priorité est accordée dans l'ordre suivant :
- Format de fichier
- Codec vidéo
- Codec audio
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
Définit le codec audio sur codec.
Remarque : fonctionde définition de la propriété audioCodec.
Voir également audioCodec() et QMediaFormat::AudioCodec.
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
Définit le codec vidéo sur codec.
Remarque : fonctionde définition de la propriété videoCodec.
Voir également videoCodec() et QMediaFormat::VideoCodec.
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
Renvoie une liste des codecs audio disponibles pour le format de fichier et le codec vidéo sélectionnés (m).
Pour obtenir tous les codecs audio pris en charge, exécutez cette requête sur un objet QMediaFormat créé par défaut.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
Renvoie une liste des formats de fichiers pris en charge pour le codec audio et vidéo indiqué par m.
Pour obtenir tous les formats de fichiers pris en charge, exécutez cette requête sur un objet ` QMediaFormat` construit par défaut.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
Renvoie une liste des codecs vidéo disponibles pour le format de fichier et le codec audio sélectionnés (m).
Pour obtenir tous les codecs vidéo pris en charge, exécutez cette requête sur un objet `MediaFormat` créé par défaut.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
Permet de changer de format multimédia à l'aide de other.
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
Renvoie le codec vidéo utilisé dans ce format.
Remarque : fonctiongetter pour la propriété videoCodec.
Voir également setVideoCodec() et QMediaFormat::VideoCodec.
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
Renvoie une description pour ` codec`.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
Renvoie un nom sous forme de chaîne de caractères pour ` codec`.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
bool QMediaFormat::operator!=(const QMediaFormat &other) const
Renvoie « true » si « other » n'est pas égal au format multimédia actuel ; sinon, renvoie « false ».
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
Déplace les objets other vers QMediaFormat.
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
Copie le contenu de ` other ` dans cet objet ` QMediaFormat `.
bool QMediaFormat::operator==(const QMediaFormat &other) const
Renvoie « true » si « other » correspond au format multimédia actuel ; sinon, renvoie « false ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
