En esta página

mediaFormat QML Value Type

MediaFormat describe el formato de un archivo multimedia. Más...

Import Statement: import QtMultimedia

Propiedades

Métodos

Descripción detallada

El tipo MediaFormat describe el formato de un archivo multimedia. Contiene tres propiedades que describen el tipo de archivo y los códecs de audio y vídeo utilizados.

MediaFormat puede utilizarse para especificar el tipo de archivo que debe crear un MediaRecorder. El siguiente fragmento muestra un ejemplo que configura la grabadora para crear un vídeo mpeg4 con audio codificado AAC y vídeo H265:

CaptureSession {
    ... // setup inputs
    MediaRecorder {
        mediaFormat {
            fileFormat: MediaFormat.MPEG4
            audioCodec: MediaFormat.AudioCodec.AAC
            videoCodec: MediaFormat.VideoCodec.H265
        }
    }
}

Si el mediaFormat especificado no es compatible, MediaRecorder intentará encontrar automáticamente el mejor formato de sustitución posible y lo utilizará en su lugar.

Véase también MediaRecorder y CaptureSession.

Documentación de propiedades

audioCodec : enumeration

Describe el códec de audio utilizado en el archivo o flujo multimedia. Puede tomar uno de los siguientes valores:

Valor de la propiedadDescripción
MediaFormat.WMAAudio de Windows Media
FormatoMedio.AC3Dolby Digital
FormatoMedio.AACCodificación de audio avanzada
FormatoMedio.ALACCódec de audio Apple Lossless
FormatoMedio.DolbyTrueHDDolby TrueHD
FormatoMedio.EAC3Dolby Digital Plus (EAC3)
FormatoMedios.MP3MPEG-1 Audio Layer III o MPEG-2 Audio Layer III
FormatoMedio.WaveFormato de archivo de audio Waveform
FormatoMedio.VorbisOgg Vorbis
FormatoMedio.FLACCódec de audio gratuito sin pérdidas
MediaFormat.OpusFormato de audio Opus
MediaFormat.UnspecifiedCódec no especificado

fileFormat : enumeration

Describe el formato contenedor utilizado en un archivo o flujo multimedia. Puede tomar uno de los siguientes valores:

Valor de la propiedadDescripción
FormatoMedia.WMAAudio de Windows Media
FormatoMedio.AACCodificación de audio avanzada
FormatoMedio.MatroskaMatroska (MKV)
FormatoMedia.WMVVídeo de Windows Media
FormatoMedios.MP3MPEG-1 Audio Layer III o MPEG-2 Audio Layer III
FormatoMedios.WaveFormato de archivo de audio en forma de onda
FormatoMedio.OggOgg
FormatoMedio.MPEG4MPEG-4
FormatoMedios.AVIIntercalación de audio y vídeo
FormatoMedios.QuickTimeQuickTime
FormatoMedios.WebMWebM
FormatoMedios.Mpeg4AudioMPEG-4 Parte 3 o MPEG-4 Audio (formalmente ISO/IEC 14496-3)
FormatoMedio.FLACCódec de audio gratuito sin pérdidas
FormatoMedio.UnspecifiedFormatEl formato no está especificado.

videoCodec : enumeration

Describe el códec de vídeo utilizado en el archivo o flujo multimedia. Puede tomar uno de los siguientes valores:

Valor de la propiedadDescripción
MediaFormat.VP8VP8
FormatoMedio.MPEG2MPEG-2
FormatoMedios.MPEG1MPEG-1
FormatoMedios.WMVVídeo Windows Media
FormatoMedios.H265Codificación de vídeo de alta eficiencia (HEVC)
FormatoMedios.H264Codificación de vídeo avanzada
FormatoMedio.MPEG4MPEG-4
FormatoMedio.AV1Vídeo AOMedia 1
FormatoMedio.MotionJPEGMotionJPEG
FormatoMedios.VP9VP9
FormatoMedios.TheoraTheora
MediaFormat.UnspecifiedCódec de vídeo no especificado

Documentación del método

string audioCodecDescription(codec)

Devuelve una descripción para codec.

string audioCodecName(codec)

Devuelve un nombre basado en una cadena para codec.

string fileFormatDescription(fileFormat)

Devuelve una descripción para fileFormat.

string fileFormatName(fileFormat)

Devuelve un nombre basado en una cadena para fileFormat.

list<AudioCodec> supportedAudioFormats(conversionMode)

Devuelve una lista de códecs de audio para el formato de archivo y el códec de vídeo elegidos (conversionMode).

Para obtener todos los códecs de audio compatibles, ejecute esta consulta en un MediaFormat construido por defecto. Para obtener una lista de los códecs de audio admitidos para una combinación específica de un formato de archivo y un códec de vídeo, puede establecer las propiedades fileFormat y videoCodec antes de ejecutar esta consulta.

Véase también QMediaFormat::ConversionMode.

list<FileFormat> supportedFileFormats(conversionMode)

Devuelve una lista de formatos de archivo para el códec de audio y vídeo indicado por conversionMode.

Para obtener todos los formatos de archivo compatibles, ejecute esta consulta en un MediaFormat construido por defecto. Para obtener una lista de formatos de archivo compatibles con una combinación específica de un códec de audio y vídeo, puede establecer las propiedades audioCodec y videoCodec antes de ejecutar esta consulta.

Véase también QMediaFormat::ConversionMode.

list<VideoCodec> supportedVideoCodecs(conversionMode)

Devuelve una lista de códecs de vídeo para el formato de archivo y el códec de audio elegidos (conversionMode).

Para obtener todos los códecs de vídeo compatibles, ejecute esta consulta en un MediaFormat construido por defecto. Para obtener una lista de los códecs de vídeo admitidos para una combinación específica de un formato de archivo y un códec de audio, puede establecer las propiedades fileFormat y audioCodec antes de ejecutar esta consulta.

Véase también QMediaFormat::ConversionMode.

string videoCodecDescription(codec)

Devuelve una descripción para codec.

string videoCodecName(codec)

Devuelve un nombre basado en una cadena para 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.