mediaFormat QML Value Type
MediaFormat describe el formato de un archivo multimedia. Más información...
| Import Statement: | import QtMultimedia |
Propiedades
- audioCodec : enumeration
- fileFormat : enumeration
- videoCodec : enumeration
Métodos
- 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)
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 propiedad | Descripción |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AC3 | Dolby Digital |
| MediaFormat.AAC | Codificación de audio avanzada |
| MediaFormat.ALAC | Códec de audio sin pérdidas de Apple |
| MediaFormat.DolbyTrueHD | Dolby TrueHD |
| MediaFormat.EAC3 | Dolby Digital Plus (EAC3) |
| MediaFormat.MP3 | MPEG-1 Audio Layer III o MPEG-2 Audio Layer III |
| MediaFormat.Wave | Formato de archivo de audio Waveform |
| MediaFormat.Vorbis | Ogg Vorbis |
| MediaFormat.FLAC | Códec de audio sin pérdidas gratuito |
| MediaFormat.Opus | Formato de audio Opus |
| MediaFormat.Sin especificar | Có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 propiedad | Descripción |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AAC | Codificación de audio avanzada |
| MediaFormat.Matroska | Matroska (MKV) |
| MediaFormat.WMV | Vídeo de Windows Media |
| MediaFormat.MP3 | MPEG-1 Audio Layer III o MPEG-2 Audio Layer III |
| MediaFormat.Wave | Formato de archivo de audio Waveform |
| MediaFormat.Ogg | Ogg |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AVI | Intercalación de audio y vídeo |
| Formato multimedia.QuickTime | QuickTime |
| MediaFormat.WebM | WebM |
| MediaFormat.Mpeg4Audio | MPEG-4 Parte 3 o MPEG-4 Audio (formalmente ISO/IEC 14496-3) |
| MediaFormat.FLAC | Códec de audio sin pérdidas gratuito |
| MediaFormat.UnspecifiedFormat | El 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 propiedad | Descripción |
|---|---|
| MediaFormat.VP8 | VP8 |
| MediaFormat.MPEG2 | MPEG-2 |
| MediaFormat.MPEG1 | MPEG-1 |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.H265 | Codificación de vídeo de alta eficiencia (HEVC) |
| MediaFormat.H264 | Codificación de vídeo avanzada |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AV1 | AOMedia Video 1 |
| MediaFormat.MotionJPEG | MotionJPEG |
| MediaFormat.VP9 | VP9 |
| MediaFormat.Theora | Theora |
| MediaFormat.Sin especificar | Có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.