QMediaFormat Class
Describe un formato de codificación para un archivo o flujo multimedia. Más...
| Cabecera: | #include <QMediaFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
Tipos públicos
| enum class | AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified } |
| enum | ConversionMode { Encode, Decode } |
| enum | FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat } |
| enum | ResolveFlags { NoFlags, RequiresVideo } |
| enum class | VideoCodec { VP8, MPEG2, MPEG1, WMV, H265, …, Unspecified } |
Propiedades
- audioCodec : AudioCodec
- fileFormat : FileFormat
- videoCodec : VideoCodec
Funciones públicas
| QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat) | |
| QMediaFormat(const QMediaFormat &other) | |
| QMediaFormat(QMediaFormat &&other) | |
| ~QMediaFormat() | |
| QMediaFormat::AudioCodec | audioCodec() const |
| QMediaFormat::FileFormat | fileFormat() const |
| bool | isSupported(QMediaFormat::ConversionMode mode) const |
| QMimeType | mimeType() const |
| void | resolveForEncoding(QMediaFormat::ResolveFlags flags) |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
| void | setFileFormat(QMediaFormat::FileFormat f) |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
| QList<QMediaFormat::AudioCodec> | supportedAudioCodecs(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::FileFormat> | supportedFileFormats(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::VideoCodec> | supportedVideoCodecs(QMediaFormat::ConversionMode m) |
| void | swap(QMediaFormat &other) |
| QMediaFormat::VideoCodec | videoCodec() const |
| bool | operator!=(const QMediaFormat &other) const |
| QMediaFormat & | operator=(QMediaFormat &&other) |
| QMediaFormat & | operator=(const QMediaFormat &other) |
| bool | operator==(const QMediaFormat &other) const |
Miembros públicos estáticos
| QString | audioCodecDescription(QMediaFormat::AudioCodec codec) |
| QString | audioCodecName(QMediaFormat::AudioCodec codec) |
| QString | fileFormatDescription(QMediaFormat::FileFormat fileFormat) |
| QString | fileFormatName(QMediaFormat::FileFormat fileFormat) |
| QString | videoCodecDescription(QMediaFormat::VideoCodec codec) |
| QString | videoCodecName(QMediaFormat::VideoCodec codec) |
Descripción Detallada
QMediaFormat describe un formato de codificación para un archivo o flujo multimedia.
Puede comprobar si un determinado formato multimedia puede ser utilizado para codificar o descodificar utilizando QMediaFormat.
Documentación de tipos de miembros
enum class QMediaFormat::AudioCodec
Describe el códec de audio utilizado en el archivo o flujo multimedia.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Audio de Windows Media |
QMediaFormat::AudioCodec::AC3 | 2 | Dolby Digital |
QMediaFormat::AudioCodec::AAC | 1 | Codificación de audio avanzada |
QMediaFormat::AudioCodec::ALAC | 10 | Códec de audio Apple Lossless |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | Dolby TrueHD |
QMediaFormat::AudioCodec::EAC3 | 3 | Dolby Digital Plus (EAC3) |
QMediaFormat::AudioCodec::MP3 | 0 | MPEG-1 Audio Layer III o MPEG-2 Audio Layer III |
QMediaFormat::AudioCodec::Wave | 8 | Formato de archivo de audio Waveform |
QMediaFormat::AudioCodec::Vorbis | 7 | Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC | 4 | Códec de audio sin pérdidas gratuito |
QMediaFormat::AudioCodec::Opus | 6 | Formato de audio Opus |
QMediaFormat::AudioCodec::Unspecified | -1 | Códec no especificado |
enum QMediaFormat::ConversionMode
En muchos casos, los sistemas tienen capacidades asimétricas y a menudo pueden descodificar más formatos o códecs de los que pueden codificar. Este enum describe el modo de conversión solicitado que se utilizará al comprobar si se admite un determinado formato de archivo o códec.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::Encode | 0 | Se utiliza para comprobar si se puede codificar un determinado formato de archivo o códec. |
QMediaFormat::Decode | 1 | Se utiliza para comprobar si un determinado formato de archivo o códec puede descodificarse. |
Véase también supportedFileFormats, supportedAudioCodecs, y supportedVideoCodecs.
enum QMediaFormat::FileFormat
Describe el formato contenedor utilizado en un archivo o flujo multimedia.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::WMA | 9 | Audio de Windows Media |
QMediaFormat::AAC | 8 | Codificación de audio avanzada |
QMediaFormat::Matroska | 2 | Matroska (MKV) |
QMediaFormat::WMV | 0 | Vídeo de Windows Media |
QMediaFormat::MP3 | 10 | MPEG-1 Audio Layer III o MPEG-2 Audio Layer III |
QMediaFormat::Wave | 12 | Formato de archivo de audio Waveform |
QMediaFormat::Ogg | 4 | Ogg |
QMediaFormat::MPEG4 | 3 | MPEG-4 |
QMediaFormat::AVI | 1 | Intercalación de audio y vídeo |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4 Parte 3 o MPEG-4 Audio (formalmente ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | Códec de audio gratuito sin pérdidas |
QMediaFormat::UnspecifiedFormat | -1 | El formato no está especificado. |
enum QMediaFormat::ResolveFlags
Describe los requisitos para resolver un formato adecuado para QMediaRecorder.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::NoFlags | 0 | Sin requisitos |
QMediaFormat::RequiresVideo | 1 | Se requiere un códec de vídeo |
Véase también resolveForEncoding().
enum class QMediaFormat::VideoCodec
Describe la codificación de vídeo utilizada en el archivo o flujo multimedia.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::VideoCodec::VP8 | 5 | VP8 |
QMediaFormat::VideoCodec::MPEG2 | 1 | MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 | 0 | MPEG-1 |
QMediaFormat::VideoCodec::WMV | 9 | Vídeo Windows Media |
QMediaFormat::VideoCodec::H265 | 4 | Codificación de vídeo de alta eficiencia (HEVC) |
QMediaFormat::VideoCodec::H264 | 3 | Codificación de vídeo avanzada |
QMediaFormat::VideoCodec::MPEG4 | 2 | MPEG-4 |
QMediaFormat::VideoCodec::AV1 | 7 | Vídeo AOMedia 1 |
QMediaFormat::VideoCodec::MotionJPEG | 10 | MotionJPEG |
QMediaFormat::VideoCodec::VP9 | 6 | VP9 |
QMediaFormat::VideoCodec::Theora | 8 | Theora |
QMediaFormat::VideoCodec::Unspecified | -1 | Códec de vídeo no especificado |
Documentación de propiedades
audioCodec : AudioCodec
Esta propiedad contiene el códec de audio del medio.
Funciones de acceso:
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
Véase también QMediaFormat::AudioCodec.
fileFormat : FileFormat
Esta propiedad contiene el formato de archivo (contenedor) del soporte.
Funciones de acceso:
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
Véase también QMediaFormat::FileFormat.
videoCodec : VideoCodec
Esta propiedad contiene el códec de vídeo del soporte.
Funciones de acceso:
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
Véase también QMediaFormat::VideoCodec.
Documentación de las funciones miembro
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
Construye un objeto QMediaFormat para format.
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
Construye un objeto QMediaFormat copiando de other.
[constexpr noexcept] QMediaFormat::QMediaFormat(QMediaFormat &&other)
Construye un objeto QMediaFormat pasando de other.
[noexcept] QMediaFormat::~QMediaFormat()
Destruye el objeto QMediaFormat.
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
Devuelve el códec de audio utilizado en este formato.
Nota: Función Getter para la propiedad audioCodec.
Véase también setAudioCodec() y QMediaFormat::AudioCodec.
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
Devuelve una descripción para codec.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
Devuelve un nombre basado en una cadena para codec.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
Devuelve una descripción para fileFormat.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
Devuelve un nombre basado en una cadena para fileFormat.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QMediaFormat::isSupported(QMediaFormat::ConversionMode mode) const
Devuelve true si Qt Multimedia puede codificar o descodificar este formato, dependiendo de mode.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QMimeType QMediaFormat::mimeType() const
Devuelve el tipo MIME para el formato de archivo utilizado en este formato multimedia.
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
Resuelve el formato, basado en flags, a un formato compatible con QMediaRecorder.
Este método intenta encontrar la mejor coincidencia posible para los ajustes no especificados. Los ajustes que no sean compatibles con la grabadora se modificarán a la coincidencia más cercana que sea compatible.
Al resolver, se da prioridad en el siguiente orden:
- Formato de archivo
- Códec de vídeo
- Códec de audio
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
Establece el códec de audio en codec.
Nota: Función Setter para la propiedad audioCodec.
Véase también audioCodec() y QMediaFormat::AudioCodec.
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
Establece el códec de vídeo en codec.
Nota: Función Setter para la propiedad videoCodec.
Véase también videoCodec() y QMediaFormat::VideoCodec.
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
Devuelve una lista de códecs de audio para el formato de archivo y el códec de vídeo elegidos (m).
Para obtener todos los códecs de audio soportados, ejecute esta consulta en un QMediaFormat construido por defecto.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
Devuelve una lista de formatos de archivo para el códec de audio y vídeo indicado por m.
Para obtener todos los formatos de archivo compatibles, ejecute esta consulta en un QMediaFormat construido por defecto.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
Devuelve una lista de códecs de vídeo para el formato de archivo y el códec de audio elegidos (m).
Para obtener todos los códecs de vídeo soportados, ejecute esta consulta en un MediaFormat construido por defecto.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QMediaFormat::ConversionMode.
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
Cambia el formato del soporte con other.
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
Devuelve el códec de vídeo utilizado en este formato.
Nota: Función Getter para la propiedad videoCodec.
Véase también setVideoCodec() y QMediaFormat::VideoCodec.
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
Devuelve una descripción para codec.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
Devuelve un nombre basado en una cadena para codec.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
bool QMediaFormat::operator!=(const QMediaFormat &other) const
Devuelve true si other no es igual al formato de soporte actual, en caso contrario devuelve false.
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
Mueve other a este QMediaFormat objetos.
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
Copia other en este objeto QMediaFormat.
bool QMediaFormat::operator==(const QMediaFormat &other) const
Devuelve true si other es igual al formato de soporte actual, en caso contrario devuelve false.
© 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.
