En esta página

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

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.

ConstanteValorDescripción
QMediaFormat::AudioCodec::WMA9Windows Media Audio
QMediaFormat::AudioCodec::AC32Dolby Digital
QMediaFormat::AudioCodec::AAC1Codificación de audio avanzada
QMediaFormat::AudioCodec::ALAC10Códec de audio sin pérdidas de Apple
QMediaFormat::AudioCodec::DolbyTrueHD5Dolby TrueHD
QMediaFormat::AudioCodec::EAC33Dolby Digital Plus (EAC3)
QMediaFormat::AudioCodec::MP30MPEG-1 Audio Layer III o MPEG-2 Audio Layer III
QMediaFormat::AudioCodec::Wave8Formato de archivo de audio Waveform
QMediaFormat::AudioCodec::Vorbis7Ogg Vorbis
QMediaFormat::AudioCodec::FLAC4Códec de audio sin pérdidas libre
QMediaFormat::AudioCodec::Opus6Formato de audio Opus
QMediaFormat::AudioCodec::Unspecified-1Có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.

ConstanteValorDescripción
QMediaFormat::Encode0Se utiliza para comprobar si un determinado formato de archivo o códec se puede codificar.
QMediaFormat::Decode1Se 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.

ConstanteValorDescripción
QMediaFormat::WMA9Windows Media Audio
QMediaFormat::AAC8Codificación de audio avanzada
QMediaFormat::Matroska2Matroska (MKV)
QMediaFormat::WMV0Windows Media Video
QMediaFormat::MP310MPEG-1 Audio Layer III o MPEG-2 Audio Layer III
QMediaFormat::Wave12Formato de archivo de audio Waveform
QMediaFormat::Ogg4Ogg
QMediaFormat::MPEG43MPEG-4
QMediaFormat::AVI1Audio y vídeo entrelazados
QMediaFormat::QuickTime5QuickTime
QMediaFormat::WebM6WebM
QMediaFormat::Mpeg4Audio7MPEG-4 Parte 3 o MPEG-4 Audio (oficialmente ISO/IEC 14496-3)
QMediaFormat::FLAC11Códec de audio sin pérdidas libre
QMediaFormat::UnspecifiedFormat-1El formato no está especificado.

enum QMediaFormat::ResolveFlags

Describe los requisitos para determinar un formato adecuado para QMediaRecorder.

ConstanteValorDescripción
QMediaFormat::NoFlags0Sin requisitos
QMediaFormat::RequiresVideo1Se 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.

ConstanteValorDescripción
QMediaFormat::VideoCodec::VP85VP8
QMediaFormat::VideoCodec::MPEG21MPEG-2
QMediaFormat::VideoCodec::MPEG10MPEG-1
QMediaFormat::VideoCodec::WMV9Windows Media Video
QMediaFormat::VideoCodec::H2654Codificación de vídeo de alta eficiencia (HEVC)
QMediaFormat::VideoCodec::H2643Codificación de vídeo avanzada
QMediaFormat::VideoCodec::MPEG42MPEG-4
QMediaFormat::VideoCodec::AV17AOMedia Video 1
QMediaFormat::VideoCodec::MotionJPEG10MotionJPEG
QMediaFormat::VideoCodec::VP96VP9
QMediaFormat::VideoCodec::Theora8Theora
QMediaFormat::VideoCodec::Unspecified-1Có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:

  1. Formato de archivo
  2. Códec de vídeo
  3. 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.