En esta página

QMediaMetaData Class

Proporciona metadatos para los archivos multimedia. Más...

Encabezado: #include <QMediaMetaData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia

Tipos públicos

enum Key { Title, Author, Comment, Description, Genre, …, HasHdrContent }

Funciones públicas

(since 6.9) auto asKeyValueRange() const
void clear()
void insert(QMediaMetaData::Key k, const QVariant &value)
bool isEmpty() const
QList<QMediaMetaData::Key> keys() const
void remove(QMediaMetaData::Key k)
QString stringValue(QMediaMetaData::Key key) const
QVariant value(QMediaMetaData::Key key) const
QVariant &operator[](QMediaMetaData::Key k)

Miembros públicos estáticos

QString metaDataKeyToString(QMediaMetaData::Key key)

Variables protegidas

QHash<QMediaMetaData::Key, QVariant> data

Miembros estáticos protegidos

QMetaType keyType(QMediaMetaData::Key key)
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)

Descripción detallada

Nota: No todos los identificadores son compatibles con todas las plataformas.

Atributos comunes
ValorDescripciónTipo
TítuloEl título del contenido multimedia.QString
AutorLos autores del material multimedia.QStringList
ComentarioUn comentario de un usuario sobre el contenido multimedia.QString
DescripciónUna descripción del contenido multimedia.QString
GéneroEl género del medio.QStringList
FechaLa fecha y hora de grabación del archivo multimedia, o la fecha y hora de codificación del flujo multimedia.QDateTime.
IdiomaEl idioma del archivo multimedia.QLocale::Language
EditorEl editor del contenido multimedia.QString
Derechos de autorAviso de derechos de autor del medio.QString
URLUna URL que apunta al origen del contenido multimedia.QUrl
Atributos del contenido multimedia
MediaTypeEl tipo de archivo multimedia (audio, vídeo, etc.).QString
FileFormatEl formato de archivo del contenido multimedia.QMediaFormat::FileFormat
DuraciónLa duración del archivo multimedia en milisegundos.qint64
Atributos de audio
AudioBitRateLa tasa de bits de la secuencia de audio del archivo multimedia, expresada en bits por segundo.int
AudioCodecEl códec del flujo de audio del contenido multimedia.QMediaFormat::AudioCodec
Atributos de vídeo
VideoFrameRateLa frecuencia de fotogramas del flujo de vídeo del archivo multimedia.qreal
VideoBitRateLa tasa de bits de la secuencia de vídeo del archivo multimedia, expresada en bits por segundo.int
VideoCodecEl códec del flujo de vídeo del archivo multimedia.QMediaFormat::VideoCodec
HasHdrContentVerdadero si el vídeo está pensado para visualización HDR (solo en los backends multimedia FFmpeg y Darwin).bool
Atributos de música
AlbumTitleEl título del álbum al que pertenece el archivo multimedia.QString
AlbumArtistEl artista principal del álbum al que pertenece el contenido multimedia.QString
ContributingArtistLos artistas que han colaborado en el archivo multimedia.QStringList
TrackNumberEl número de pista del archivo multimedia.int
CompositorEl compositor del material multimedia.QStringList
LeadPerformerEl intérprete principal del contenido multimedia.QStringList
CoverArtImageUna imagen de portada incrustada.QImage
ThumbnailImageUna imagen en miniatura incrustada. (obsoleta desde la versión 6.12; utilice CoverArtImage en su lugar)QImage
Atributos de imagen y vídeo
OrientaciónEl ángulo de rotación de una imagen o un vídeo.int
ResoluciónLas dimensiones de una imagen o un vídeo.QSize

Documentación sobre tipos de miembro

enum QMediaMetaData::Key

Se pueden utilizar las siguientes claves de metadatos:

ConstanteValorDescripción
QMediaMetaData::Title0Título del medio
QMediaMetaData::Author1Autor del contenido multimedia
QMediaMetaData::Comment2Comentario
QMediaMetaData::Description3Breve descripción
QMediaMetaData::Genre4Género al que pertenece el medio
QMediaMetaData::Date5Fecha de creación
QMediaMetaData::Language6Idioma del medio
QMediaMetaData::Publisher7Información sobre el editor del contenido multimedia
QMediaMetaData::Copyright8Información sobre los derechos de autor del medio
QMediaMetaData::Url9URL del sitio web del editor
QMediaMetaData::Duration10Duración de la reproducción del contenido multimedia
QMediaMetaData::MediaType11Tipo del archivo multimedia
QMediaMetaData::FileFormat12Formato de archivo
QMediaMetaData::AudioBitRate13 
QMediaMetaData::AudioCodec14 
QMediaMetaData::VideoBitRate15 
QMediaMetaData::VideoCodec16 
QMediaMetaData::VideoFrameRate17 
QMediaMetaData::AlbumTitle18Título del álbum
QMediaMetaData::AlbumArtist19Información sobre el artista.
QMediaMetaData::ContributingArtist20 
QMediaMetaData::TrackNumber21 
QMediaMetaData::Composer22Información sobre el compositor multimedia.
QMediaMetaData::LeadPerformer23 
QMediaMetaData::ThumbnailImage24Imagen en miniatura del archivo multimedia (obsoleta desde la versión 6.12; idéntica a CoverArtImage para garantizar la compatibilidad con versiones anteriores)
QMediaMetaData::CoverArtImageLeadPerformer + 2Carátula del archivo multimedia
QMediaMetaData::Orientation26 
QMediaMetaData::Resolution27 
QMediaMetaData::HasHdrContent (since Qt 6.8)28El vídeo puede contener contenido HDR (solo lectura, solo con los backends multimedia FFmpeg y Darwin)

Documentación de las funciones de miembro

[since 6.9] auto QMediaMetaData::asKeyValueRange() const

Devuelve un objeto de rango que permite recorrer este hash como pares clave/valor.

Esta función se introdujo en Qt 6.9.

[invokable] void QMediaMetaData::clear()

Elimina todos los datos del objeto de metadatos.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)

Inserta un objeto « value » en una clave: k.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QMediaMetaData::isEmpty() const

Devuelve « true » si los metadatos no contienen ningún elemento; en caso contrario, devuelve « false ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)

Devuelve el metatipo utilizado para almacenar los datos de la clave « key ».

[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const

Devuelve un objeto ` QList ` de tipo `QMediaMetaData::Keys`.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)

Devuelve una representación en forma de cadena de ` key ` que se puede utilizar a la hora de mostrar metadatos a los usuarios.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)

Elimina los metadatos de una clave: k.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const

Devuelve los metadatos de la clave « key » en formato « QString ».

Esto tiene como objetivo principal simplificar la presentación de los metadatos al usuario.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const

Devuelve el valor de los metadatos correspondientes a la clave « key », o un valor nulo « QVariant » si no hay metadatos disponibles para dicha clave.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)

Devuelve los datos almacenados en la clave « k ».

QMediaMetaData rockBallad1;
rockBalad[QMediaMetaData::Genre]="Rock"

Documentación de variables de miembro

QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data

Esta variable contiene los metadatos.

Nota: se trata de un miembro de tipo « protected » de su clase.

Elementos no miembros relacionados

bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)

Compara dos objetos de metadatos a y b, y devuelve false si son idénticos o true si difieren.

bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)

Compara dos objetos de metadatos a y b, y devuelve true si son idénticos o false si difieren.

© 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.