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) |
Elementos no miembros relacionados
| 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 | ||
|---|---|---|
| Valor | Descripción | Tipo |
| Título | El título del contenido multimedia. | QString |
| Autor | Los autores del material multimedia. | QStringList |
| Comentario | Un comentario de un usuario sobre el contenido multimedia. | QString |
| Descripción | Una descripción del contenido multimedia. | QString |
| Género | El género del medio. | QStringList |
| Fecha | La fecha y hora de grabación del archivo multimedia, o la fecha y hora de codificación del flujo multimedia. | QDateTime. |
| Idioma | El idioma del archivo multimedia. | QLocale::Language |
| Editor | El editor del contenido multimedia. | QString |
| Derechos de autor | Aviso de derechos de autor del medio. | QString |
| URL | Una URL que apunta al origen del contenido multimedia. | QUrl |
| Atributos del contenido multimedia | ||
| MediaType | El tipo de archivo multimedia (audio, vídeo, etc.). | QString |
| FileFormat | El formato de archivo del contenido multimedia. | QMediaFormat::FileFormat |
| Duración | La duración del archivo multimedia en milisegundos. | qint64 |
| Atributos de audio | ||
| AudioBitRate | La tasa de bits de la secuencia de audio del archivo multimedia, expresada en bits por segundo. | int |
| AudioCodec | El códec del flujo de audio del contenido multimedia. | QMediaFormat::AudioCodec |
| Atributos de vídeo | ||
| VideoFrameRate | La frecuencia de fotogramas del flujo de vídeo del archivo multimedia. | qreal |
| VideoBitRate | La tasa de bits de la secuencia de vídeo del archivo multimedia, expresada en bits por segundo. | int |
| VideoCodec | El códec del flujo de vídeo del archivo multimedia. | QMediaFormat::VideoCodec |
| HasHdrContent | Verdadero si el vídeo está pensado para visualización HDR (solo en los backends multimedia FFmpeg y Darwin). | bool |
| Atributos de música | ||
| AlbumTitle | El título del álbum al que pertenece el archivo multimedia. | QString |
| AlbumArtist | El artista principal del álbum al que pertenece el contenido multimedia. | QString |
| ContributingArtist | Los artistas que han colaborado en el archivo multimedia. | QStringList |
| TrackNumber | El número de pista del archivo multimedia. | int |
| Compositor | El compositor del material multimedia. | QStringList |
| LeadPerformer | El intérprete principal del contenido multimedia. | QStringList |
| CoverArtImage | Una imagen de portada incrustada. | QImage |
| ThumbnailImage | Una imagen en miniatura incrustada. (obsoleta desde la versión 6.12; utilice CoverArtImage en su lugar) | QImage |
| Atributos de imagen y vídeo | ||
| Orientación | El ángulo de rotación de una imagen o un vídeo. | int |
| Resolución | Las 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:
| Constante | Valor | Descripción |
|---|---|---|
QMediaMetaData::Title | 0 | Título del medio |
QMediaMetaData::Author | 1 | Autor del contenido multimedia |
QMediaMetaData::Comment | 2 | Comentario |
QMediaMetaData::Description | 3 | Breve descripción |
QMediaMetaData::Genre | 4 | Género al que pertenece el medio |
QMediaMetaData::Date | 5 | Fecha de creación |
QMediaMetaData::Language | 6 | Idioma del medio |
QMediaMetaData::Publisher | 7 | Información sobre el editor del contenido multimedia |
QMediaMetaData::Copyright | 8 | Información sobre los derechos de autor del medio |
QMediaMetaData::Url | 9 | URL del sitio web del editor |
QMediaMetaData::Duration | 10 | Duración de la reproducción del contenido multimedia |
QMediaMetaData::MediaType | 11 | Tipo del archivo multimedia |
QMediaMetaData::FileFormat | 12 | Formato de archivo |
QMediaMetaData::AudioBitRate | 13 | |
QMediaMetaData::AudioCodec | 14 | |
QMediaMetaData::VideoBitRate | 15 | |
QMediaMetaData::VideoCodec | 16 | |
QMediaMetaData::VideoFrameRate | 17 | |
QMediaMetaData::AlbumTitle | 18 | Título del álbum |
QMediaMetaData::AlbumArtist | 19 | Información sobre el artista. |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | Información sobre el compositor multimedia. |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | Imagen en miniatura del archivo multimedia (obsoleta desde la versión 6.12; idéntica a CoverArtImage para garantizar la compatibilidad con versiones anteriores) |
QMediaMetaData::CoverArtImage | LeadPerformer + 2 | Carátula del archivo multimedia |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | El 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.