Sur cette page

mediaFormat QML Value Type

MediaFormat décrit le format d'un fichier multimédia. Plus d'informations...

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