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