QMediaFormat Class
Décrit un format d'encodage pour un fichier ou un flux multimédia. Plus d'informations...
| 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 certain format de média peut être utilisé pour l'encodage ou le décodage à l'aide de QMediaFormat.
Type de membre Documentation
enum class QMediaFormat::AudioCodec
Décrit le codec audio utilisé dans le fichier ou le flux multimédia.
| Constante | Valeur | Description du codec |
|---|---|---|
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 gratuit sans perte |
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 ont des capacités asymétriques et peuvent souvent décoder plus de formats ou de codecs qu'ils ne peuvent en encoder. Cette énumération décrit le mode de conversion à utiliser pour vérifier si un certain format de fichier ou codec est pris en charge.
| Constante | Valeur | Description du mode de conversion |
|---|---|---|
QMediaFormat::Encode | 0 | Utilisé pour vérifier si un certain format de fichier ou codec peut être encodé. |
QMediaFormat::Decode | 1 | Utilisé pour vérifier si un certain format de fichier ou codec peut être décodé. |
Voir également supportedFileFormats, supportedAudioCodecs, et supportedVideoCodecs.
enum QMediaFormat::FileFormat
Décrit le format de conteneur utilisé dans un fichier ou un flux multimédia.
| Constante | Valeur | Description du format |
|---|---|---|
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 | Entrelacement audio-vidéo |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4 Part 3 ou MPEG-4 Audio (officiellement ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | Codec audio gratuit sans perte |
QMediaFormat::UnspecifiedFormat | -1 | Le format n'est pas spécifié. |
enum QMediaFormat::ResolveFlags
Décrit les exigences relatives à la détermination d'un format approprié pour QMediaRecorder.
| Constante | Valeur | Description de l'exigence |
|---|---|---|
QMediaFormat::NoFlags | 0 | Aucune exigence |
QMediaFormat::RequiresVideo | 1 | Un codec vidéo est requis |
Voir également resolveForEncoding().
enum class QMediaFormat::VideoCodec
Décrit le codage vidéo utilisé dans le fichier ou le flux multimédia.
| Constante | Valeur | Description |
|---|---|---|
QMediaFormat::VideoCodec::VP8 | 5 | VP8 |
QMediaFormat::VideoCodec::MPEG2 | 1 | MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 | 0 | MPEG-1 |
QMediaFormat::VideoCodec::WMV | 9 | Vidéo Windows Media |
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 média.
Fonctions d'accès :
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
Voir aussi QMediaFormat::AudioCodec.
fileFormat : FileFormat
Cette propriété contient le format de fichier (conteneur) du média.
Fonctions d'accès :
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
Voir aussi QMediaFormat::FileFormat.
videoCodec : VideoCodec
Cette propriété contient le codec vidéo du média.
Fonctions d'accès :
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
Voir également QMediaFormat::VideoCodec.
Documentation des fonctions membres
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
Construit un objet QMediaFormat pour format.
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
Construit un objet QMediaFormat en le copiant à partir de other.
[constexpr noexcept] QMediaFormat::QMediaFormat(QMediaFormat &&other)
Construit un objet QMediaFormat en passant de other.
[noexcept] QMediaFormat::~QMediaFormat()
Détruit l'objet QMediaFormat.
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
Renvoie le codec audio utilisé dans ce format.
Remarque : fonction Getter pour la propriété audioCodec.
Voir aussi setAudioCodec() et QMediaFormat::AudioCodec.
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
Renvoie une description pour codec.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
Renvoie un nom basé sur une chaîne de caractères pour codec.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
Renvoie une description pour fileFormat.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
Renvoie un nom basé sur une chaîne de caractères pour fileFormat.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QMimeType QMediaFormat::mimeType() const
Renvoie le type MIME du format de fichier utilisé dans ce format de média.
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
Résout le format, basé 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 qui ne sont pas pris en charge par l'enregistreur seront modifiés en fonction de la correspondance la plus proche qui est prise en charge.
Lors de la résolution, la priorité est donnée dans l'ordre suivant :
- Format de fichier
- Codec vidéo
- Codec audio
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
Définit le codec audio à codec.
Note : Fonction de définition de la propriété audioCodec.
Voir aussi audioCodec() et QMediaFormat::AudioCodec.
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
Définit le codec vidéo à codec.
Remarque : fonction de définition de la propriété videoCodec.
Voir aussi videoCodec() et QMediaFormat::VideoCodec.
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
Renvoie une liste de codecs audio pour le format de fichier et le codec vidéo choisis (m).
Pour obtenir tous les codecs audio pris en charge, exécutez cette requête sur une construction par défaut QMediaFormat.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
Renvoie une liste de formats de fichiers 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 une construction par défaut QMediaFormat.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
Renvoie une liste de codecs vidéo pour le format de fichier et le codec audio choisis (m).
Pour obtenir tous les codecs vidéo pris en charge, exécutez cette requête sur un MediaFormat construit par défaut.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QMediaFormat::ConversionMode.
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
Remplace le format du support par other.
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
Renvoie le codec vidéo utilisé dans ce format.
Remarque : fonction Getter pour la propriété videoCodec.
Voir aussi setVideoCodec() et QMediaFormat::VideoCodec.
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
Renvoie une description pour codec.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
Renvoie un nom basé sur une chaîne de caractères pour codec.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
bool QMediaFormat::operator!=(const QMediaFormat &other) const
Renvoie true si other ne correspond pas au format de média actuel, sinon renvoie false.
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
Déplace other dans cet objet QMediaFormat.
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
Copie other dans l'objet QMediaFormat.
bool QMediaFormat::operator==(const QMediaFormat &other) const
Renvoie true si other correspond au format actuel du média, 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.
