Sur cette page

mediaFormat QML Value Type

MediaFormat décrit le format d'un fichier multimédia. En savoir plus...

Import Statement: import QtMultimedia

Propriétés

Méthodes

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.WMAWindows Media Audio
MediaFormat.AC3Dolby Digital
MediaFormat.AACCodage audio avancé
MediaFormat.ALACCodec audio sans perte d'Apple
MediaFormat.DolbyTrueHDDolby TrueHD
MediaFormat.EAC3Dolby Digital Plus (EAC3)
MediaFormat.MP3MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III
MediaFormat.WaveFormat de fichier audio Waveform
MediaFormat.VorbisOgg Vorbis
MediaFormat.FLACCodec audio sans perte libre
MediaFormat.OpusFormat 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.WMAWindows Media Audio
MediaFormat.AACCodage audio avancé
MediaFormat.MatroskaMatroska (MKV)
MediaFormat.WMVWindows Media Video
MediaFormat.MP3MPEG-1 Audio Layer III ou MPEG-2 Audio Layer III
MediaFormat.WaveFormat de fichier audio Waveform
MediaFormat.OggOgg
MediaFormat.MPEG4MPEG-4
MediaFormat.AVIAudio Video Interleave
MediaFormat.QuickTimeQuickTime
MediaFormat.WebMWebM
MediaFormat.Mpeg4AudioMPEG-4 Partie 3 ou MPEG-4 Audio (officiellement ISO/IEC 14496-3)
MediaFormat.FLACCodec audio sans perte libre
MediaFormat.UnspecifiedFormatLe 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.VP8VP8
MediaFormat.MPEG2MPEG-2
MediaFormat.MPEG1MPEG-1
MediaFormat.WMVWindows Media Video
MediaFormat.H265Codage vidéo à haute efficacité (HEVC)
MediaFormat.H264Codage vidéo avancé
MediaFormat.MPEG4MPEG-4
MediaFormat.AV1AOMedia Video 1
MediaFormat.MotionJPEGMotionJPEG
MediaFormat.VP9VP9
MediaFormat.TheoraTheora
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.