En esta página

mediaFormat QML Value Type

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

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 que se utilizan.

MediaFormat se puede utilizar para especificar el tipo de archivo que debe crear un MediaRecorder. El fragmento de código siguiente muestra un ejemplo en el que se configura la grabadora para crear un vídeo MPEG-4 con audio codificado en AAC y vídeo H.265:

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

Si el «mediaFormat» especificado no es compatible, el « MediaRecorder » intentará automáticamente encontrar el mejor formato sustitutivo posible y lo utilizará en su lugar.

Véase también MediaRecorder y CaptureSession.

Documentación de la propiedad

audioCodec : enumeration

Describe el códec de audio utilizado en un archivo multimedia o en una transmisión. Puede adoptar uno de los siguientes valores:

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

fileFormat : enumeration

Describe el formato contenedor utilizado en un archivo multimedia o en una secuencia multimedia. Puede adoptar uno de los siguientes valores:

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

videoCodec : enumeration

Describe el códec de vídeo utilizado en un archivo multimedia o en una transmisión. Puede adoptar uno de los siguientes valores:

Valor de la propiedadDescripción
MediaFormat.VP8VP8
MediaFormat.MPEG2MPEG-2
MediaFormat.MPEG1MPEG-1
MediaFormat.WMVWindows Media Video
MediaFormat.H265Codificación de vídeo de alta eficiencia (HEVC)
MediaFormat.H264Codificación de vídeo avanzada
MediaFormat.MPEG4MPEG-4
MediaFormat.AV1AOMedia Video 1
MediaFormat.MotionJPEGMotionJPEG
MediaFormat.VP9VP9
MediaFormat.TheoraTheora
MediaFormat.Sin especificarCódec de vídeo no especificado

Documentación del método

string audioCodecDescription(codec)

Devuelve una descripción de codec.

string audioCodecName(codec)

Devuelve un nombre en forma de cadena para « codec ».

string fileFormatDescription(fileFormat)

Devuelve una descripción de fileFormat.

string fileFormatName(fileFormat)

Devuelve un nombre en forma de 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 seleccionados (conversionMode).

Para obtener todos los códecs de audio compatibles, ejecuta esta consulta en un objeto `MediaFormat` creado de forma predeterminada. Para obtener una lista de los códecs de audio compatibles con una combinación específica de formato de archivo y códec de vídeo, puedes 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, ejecuta esta consulta en un objeto `MediaFormat` creado de forma predeterminada. Para obtener una lista de los formatos de archivo compatibles con una combinación específica de códecs de audio y vídeo, puedes 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 seleccionados (conversionMode).

Para obtener todos los códecs de vídeo compatibles, ejecuta esta consulta en un MediaFormat creado de forma predeterminada. Para obtener una lista de los códecs de vídeo compatibles con una combinación específica de formato de archivo y códec de audio, puedes establecer las propiedades fileFormat y audioCodec antes de ejecutar esta consulta.

Véase también QMediaFormat::ConversionMode.

string videoCodecDescription(codec)

Devuelve una descripción de « codec ».

string videoCodecName(codec)

Devuelve un nombre en forma de 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.