QMediaFormat Class
Describe un formato de codificación para un archivo o una secuencia multimedia. Más información...
| Encabezado: | #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.
Mediante QMediaFormat se puede comprobar si un formato multimedia determinado se puede utilizar para la codificación o la decodificación.
Documentación sobre los tipos de miembros
enum class QMediaFormat::AudioCodec
Describe el códec de audio utilizado en un archivo multimedia o en una transmisión.
| Constante | Valor | Descripción |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Windows Media Audio |
QMediaFormat::AudioCodec::AC3 | 2 | Dolby Digital |
QMediaFormat::AudioCodec::AAC | 1 | Codificación de audio avanzada |
QMediaFormat::AudioCodec::ALAC | 10 | Códec de audio sin pérdidas de Apple |
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 libre |
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. Esta enumeración describe el modo de conversión solicitado que se debe 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 un determinado formato de archivo o códec se puede codificar. |
QMediaFormat::Decode | 1 | Se utiliza para comprobar si un determinado formato de archivo o códec se puede decodificar. |
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 | Windows Media Audio |
QMediaFormat::AAC | 8 | Codificación de audio avanzada |
QMediaFormat::Matroska | 2 | Matroska (MKV) |
QMediaFormat::WMV | 0 | Windows Media Video |
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 | Audio y vídeo entrelazados |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4 Parte 3 o MPEG-4 Audio (oficialmente ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | Códec de audio sin pérdidas libre |
QMediaFormat::UnspecifiedFormat | -1 | El formato no está especificado. |
enum QMediaFormat::ResolveFlags
Describe los requisitos para determinar 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 el códec de vídeo utilizado en un archivo multimedia o en una transmisión.
| 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 | Windows Media Video |
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 | AOMedia Video 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 archivo multimedia.
Funciones de acceso:
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
Véase también QMediaFormat::AudioCodec.
fileFormat : FileFormat
Esta propiedad indica el formato de archivo (contenedor) del contenido multimedia.
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 archivo multimedia.
Funciones de acceso:
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
Véase también QMediaFormat::VideoCodec.
Documentación de funciones de miembro
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
Crea un objeto QMediaFormat para format.
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
Crea un objeto QMediaFormat copiando desde other.
[constexpr noexcept default] QMediaFormat::QMediaFormat(QMediaFormat &&other)
Crea un objeto QMediaFormat a partir de other.
[noexcept] QMediaFormat::~QMediaFormat()
Elimina el objeto « QMediaFormat ».
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
Devuelve el códec de audio utilizado en este formato.
Nota: Funcióngetter para la propiedad audioCodec.
Véase también setAudioCodec() y QMediaFormat::AudioCodec.
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
Devuelve una descripción de codec.
Nota: Esta función se puede invocar 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 en forma de cadena para ` codec`.
Nota: Esta función se puede invocar 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 de fileFormat.
Nota: Esta función se puede invocar 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 en forma de cadena para ` fileFormat`.
Nota: Esta función se puede invocar 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 decodificar este formato, en función de ` mode`.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QMimeType QMediaFormat::mimeType() const
Devuelve el tipo MIME del formato de archivo utilizado en este formato multimedia.
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
Convierte el formato, basándose 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 para que se ajusten lo más posible a la opción compatible más cercana.
A la hora de convertir, 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ónde asignación 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ónde asignación 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 seleccionados (m).
Para obtener todos los códecs de audio compatibles, ejecuta esta consulta en un objeto QMediaFormat creado de forma predeterminada.
Nota: Esta función se puede invocar 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, ejecuta esta consulta en un ` QMediaFormat` creado de forma predeterminada.
Nota: Esta función se puede invocar 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 seleccionados (m).
Para obtener todos los códecs de vídeo compatibles, ejecuta esta consulta en un objeto `MediaFormat` creado de forma predeterminada.
Nota: Esta función se puede invocar 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 multimedia con « other ».
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
Devuelve el códec de vídeo utilizado en este formato.
Nota: Funcióngetter para la propiedad videoCodec.
Véase también ` setVideoCodec()` y ` QMediaFormat::VideoCodec`.
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
Devuelve una descripción de « codec ».
Nota: Esta función se puede invocar 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 en forma de cadena para ` codec`.
Nota: Esta función se puede invocar 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 coincide con el formato de medio actual; en caso contrario, devuelve « false ».
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
Traslada « other » a este QMediaFormat objetos.
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
Copia el contenido de « other » en este objeto « QMediaFormat ».
bool QMediaFormat::operator==(const QMediaFormat &other) const
Devuelve « true » si « other » es igual al formato multimedia 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.