mediaFormat QML Value Type
MediaFormat décrit le format d'un fichier multimédia. En savoir plus...
| Import Statement: | import QtMultimedia |
Propriétés
- audioCodec : enumeration
- fileFormat : enumeration
- videoCodec : enumeration
Méthodes
- string audioCodecDescription(codec)
- string audioCodecName(codec)
- string fileFormatDescription(fileFormat)
- string fileFormatName(fileFormat)
- list<AudioCodec> supportedAudioFormats(conversionMode)
- list<FileFormat> supportedFileFormats(conversionMode)
- list<VideoCodec> supportedVideoCodecs(conversionMode)
- string videoCodecDescription(codec)
- string videoCodecName(codec)
Description détaillée
Le type MediaFormat décrit le format d'un fichier multimédia. Il contient trois propriétés qui décrivent le type de fichier ainsi que les codecs audio et vidéo utilisés.
MediaFormat peut être utilisé pour spécifier le type de fichier qui doit être créé par un enregistreur ( MediaRecorder). L'extrait de code ci-dessous montre un exemple qui configure l'enregistreur pour créer une vidéo MPEG-4 avec un son encodé en AAC et une vidéo H.265 :
CaptureSession {
... // setup inputs
MediaRecorder {
mediaFormat {
fileFormat: MediaFormat.MPEG4
audioCodec: MediaFormat.AudioCodec.AAC
videoCodec: MediaFormat.VideoCodec.H265
}
}
}Si le format mediaFormat spécifié n'est pas pris en charge, l'MediaRecorder tentera automatiquement de trouver le meilleur format de remplacement possible et l'utilisera à la place.
Voir également MediaRecorder et CaptureSession.
Documentation sur les propriétés
audioCodec : enumeration
Décrit le codec audio utilisé dans un fichier multimédia ou un flux. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Description |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AC3 | Dolby Digital |
| MediaFormat.AAC | Codage audio avancé |
| MediaFormat.ALAC | Codec audio sans perte d'Apple |
| MediaFormat.DolbyTrueHD | Dolby TrueHD |
| MediaFormat.EAC3 | Dolby Digital Plus (EAC3) |
| MediaFormat.MP3 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
| MediaFormat.Wave | Format de fichier audio Waveform |
| MediaFormat.Vorbis | Ogg Vorbis |
| MediaFormat.FLAC | Codec audio sans perte libre |
| MediaFormat.Opus | Format audio Opus |
| MediaFormat.Non spécifié | Codec non spécifié |
fileFormat : enumeration
Décrit le format de conteneur utilisé dans un fichier multimédia ou un flux. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Description |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AAC | Codage audio avancé |
| MediaFormat.Matroska | Matroska (MKV) |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.MP3 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
| MediaFormat.Wave | Format de fichier audio Waveform |
| MediaFormat.Ogg | Ogg |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AVI | Audio Video Interleave |
| MediaFormat.QuickTime | QuickTime |
| MediaFormat.WebM | WebM |
| MediaFormat.Mpeg4Audio | MPEG-4 Partie 3 ou MPEG-4 Audio (officiellement ISO/IEC 14496-3) |
| MediaFormat.FLAC | Codec audio sans perte libre |
| MediaFormat.UnspecifiedFormat | Le format n'est pas spécifié. |
videoCodec : enumeration
Décrit le codec vidéo utilisé dans un fichier multimédia ou un flux. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Description |
|---|---|
| MediaFormat.VP8 | VP8 |
| MediaFormat.MPEG2 | MPEG-2 |
| MediaFormat.MPEG1 | MPEG-1 |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.H265 | Codage vidéo à haute efficacité (HEVC) |
| MediaFormat.H264 | Codage vidéo avancé |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AV1 | AOMedia Video 1 |
| MediaFormat.MotionJPEG | MotionJPEG |
| MediaFormat.VP9 | VP9 |
| MediaFormat.Theora | Theora |
| MediaFormat.Non spécifié | Codec vidéo non spécifié |
Documentation de la méthode
string audioCodecDescription(codec)
Renvoie une description pour codec.
string audioCodecName(codec)
Renvoie un nom sous forme de chaîne de caractères pour ` codec`.
string fileFormatDescription(fileFormat)
Renvoie une description pour fileFormat.
string fileFormatName(fileFormat)
Renvoie un nom sous forme de chaîne de caractères pour fileFormat.
list<AudioCodec> supportedAudioFormats(conversionMode)
Renvoie une liste des codecs audio disponibles pour le format de fichier et le codec vidéo sélectionnés (conversionMode).
Pour obtenir tous les codecs audio pris en charge, exécutez cette requête sur un objet MediaFormat créé par défaut. Pour obtenir une liste des codecs audio pris en charge pour une combinaison spécifique de format de fichier et de codec vidéo, vous pouvez définir les propriétés fileFormat et videoCodec avant d'exécuter cette requête.
Voir également QMediaFormat::ConversionMode.
list<FileFormat> supportedFileFormats(conversionMode)
Renvoie une liste des formats de fichiers pris en charge pour le codec audio et vidéo indiqué par ` conversionMode`.
Pour obtenir tous les formats de fichiers pris en charge, exécutez cette requête sur un objet MediaFormat créé par défaut. Pour obtenir une liste des formats de fichiers prenant en charge une combinaison spécifique de codecs audio et vidéo, vous pouvez définir les propriétés audioCodec et videoCodec avant d'exécuter cette requête.
Voir également QMediaFormat::ConversionMode.
list<VideoCodec> supportedVideoCodecs(conversionMode)
Renvoie une liste des codecs vidéo pour le format de fichier et le codec audio sélectionnés (conversionMode).
Pour obtenir tous les codecs vidéo pris en charge, exécutez cette requête sur un objet MediaFormat créé par défaut. Pour obtenir une liste des codecs vidéo pris en charge pour une combinaison spécifique de format de fichier et de codec audio, vous pouvez définir les propriétés fileFormat et audioCodec avant d'exécuter cette requête.
Voir également QMediaFormat::ConversionMode.
string videoCodecDescription(codec)
Renvoie une description pour codec.
string videoCodecName(codec)
Renvoie un nom sous forme de chaîne de caractères pour codec.
© 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.