mediaFormat QML Value Type
MediaFormat décrit le format d'un fichier multimédia. Plus d'informations...
| 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 et 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 site MediaRecorder. L'extrait ci-dessous montre un exemple qui configure l'enregistreur pour créer une vidéo mpeg4 avec un codec audio AAC et un codec vidéo H265 :
CaptureSession {
... // setup inputs
MediaRecorder {
mediaFormat {
fileFormat: MediaFormat.MPEG4
audioCodec: MediaFormat.AudioCodec.AAC
videoCodec: MediaFormat.VideoCodec.H265
}
}
}Si le mediaFormat spécifié n'est pas pris en charge, le site MediaRecorder essaiera 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 le fichier ou le flux multimédia. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Description |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| FormatMédia.AC3 | Dolby Digital |
| FormatMédia.AAC | Codage audio avancé |
| MediaFormat.ALAC | Codec audio Apple Lossless |
| MediaFormat.DolbyTrueHD | Dolby TrueHD |
| FormatMédia.EAC3 | Dolby Digital Plus (EAC3) |
| FormatMédia.MP3 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
| MediaFormat.Wave | Format de fichier audio de forme d'onde |
| MediaFormat.Vorbis | Ogg Vorbis |
| MediaFormat.FLAC | Codec audio gratuit sans perte |
| MediaFormat.Opus | Format audio Opus |
| MediaFormat.Unspecified | Codec non spécifié |
fileFormat : enumeration
Décrit le format de conteneur utilisé dans un fichier ou un flux multimédia. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Valeur de la propriété |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AAC | Codage audio avancé |
| FormatMédia.Matroska | Matroska (MKV) |
| FormatMédia.WMV | Vidéo Windows Media |
| FormatMédia.MP3 | MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III |
| MediaFormat.Wave | Format de fichier audio de forme d'onde |
| MediaFormat.Ogg | Ogg |
| FormatMédia.MPEG4 | MPEG-4 |
| FormatMédia.AVI | Audio Video Interleave |
| FormatMédia.QuickTime | QuickTime |
| FormatMédia.WebM | WebM |
| MediaFormat.Mpeg4Audio | MPEG-4 Part 3 ou MPEG-4 Audio (officiellement ISO/IEC 14496-3) |
| FormatMédia.FLAC | Codec audio gratuit sans perte |
| MediaFormat.UnspecifiedFormat | Le format n'est pas spécifié. |
videoCodec : enumeration
Décrit le codec vidéo utilisé dans le fichier ou le flux multimédia. Il peut prendre l'une des valeurs suivantes :
| Valeur de la propriété | Description |
|---|---|
| MediaFormat.VP8 | VP8 |
| FormatMédia.MPEG2 | MPEG-2 |
| FormatMédia.MPEG1 | MPEG-1 |
| FormatMédia.WMV | Vidéo Windows Media |
| FormatMédia.H265 | Codage vidéo à haute efficacité (HEVC) |
| FormatMédia.H264 | Codage vidéo avancé |
| FormatMédia.MPEG4 | MPEG-4 |
| FormatMédia.AV1 | AOMedia Video 1 |
| FormatMédia.MotionJPEG | MotionJPEG |
| FormatMédia.VP9 | VP9 |
| FormatMédia.Theora | Theora |
| FormatMédia.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 basé sur une chaîne de caractères pour codec.
string fileFormatDescription(fileFormat)
Renvoie une description pour fileFormat.
string fileFormatName(fileFormat)
Renvoie un nom basé sur une chaîne de caractères pour fileFormat.
list<AudioCodec> supportedAudioFormats(conversionMode)
Renvoie une liste de codecs audio pour le format de fichier et le codec vidéo choisis (conversionMode).
Pour obtenir tous les codecs audio pris en charge, exécutez cette requête sur un MediaFormat construit par défaut. Pour obtenir une liste des codecs audio pris en charge pour une combinaison spécifique d'un format de fichier et d'un 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 de formats de fichiers 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 MediaFormat construit par défaut. Pour obtenir une liste de formats de fichiers prenant en charge une combinaison spécifique d'un codec audio et vidéo, vous pouvez définir les propriétés audioCodec et videoCodec avant d'exécuter cette requête.
Voir aussi QMediaFormat::ConversionMode.
list<VideoCodec> supportedVideoCodecs(conversionMode)
Renvoie une liste de codecs vidéo pour le format de fichier et le codec audio choisis (conversionMode).
Pour obtenir tous les codecs vidéo pris en charge, exécutez cette requête sur un MediaFormat construit par défaut. Pour obtenir une liste des codecs vidéo pris en charge pour une combinaison spécifique d'un format de fichier et d'un 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 basé sur une 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.