QMediaMetaData Class
Proporciona metadatos para archivos multimedia. Más...
| Cabecera: | #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) |
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 | Título del soporte. | QString |
| Autor | Los autores del medio. | QStringList |
| Comentario | Un comentario del usuario sobre el medio. | QString |
| Descripción | Una descripción del medio. | QString |
| Género | El género del medio. | QStringList |
| Fecha | La fecha de grabación del archivo multimedia o la fecha de codificación del flujo multimedia. | QDateTime. |
| Idioma | El idioma del medio. | QLocale::Language |
| Editor | El editor del medio. | QString |
| Derechos de autor | Aviso de copyright del medio de comunicación. | QString |
| Url | Url que apunta al origen del medio. | QUrl |
| Atributos del medio | ||
| MediaType | Tipo de soporte (audio, vídeo, etc.). | QString |
| FileFormat | El formato de archivo del medio. | QMediaFormat::FileFormat |
| Duración | La duración en milisegundos del medio. | qint64 |
| Atributos de audio | ||
| AudioBitRate | La tasa de bits del flujo de audio del medio en bits por segundo. | int |
| AudioCodec | El códec del flujo de audio del medio. | QMediaFormat::AudioCodec |
| Atributos de vídeo | ||
| VideoFrameRate | Frecuencia de imagen del flujo de vídeo del medio. | qreal |
| VideoBitRate | La tasa de bits del flujo de vídeo del medio en bits por segundo. | int |
| VideoCodec | El códec del flujo de vídeo del medio. | QMediaFormat::VideoCodec |
| HasHdrContent | True si el vídeo está destinado a la visualización HDR (sólo FFmpeg y Darwin). | bool |
| Atributos de música | ||
| AlbumTitle | El título del álbum al que pertenece el medio. | QString |
| AlbumArtist | El artista principal del álbum al que pertenece el medio. | QString |
| ContributingArtist | Los artistas que contribuyen al medio. | QStringList |
| TrackNumber | El número de pista del medio. | int |
| Compositor | El compositor del medio. | QStringList |
| LeadPerformer | El intérprete principal del medio. | QStringList |
| ThumbnailImage | Una imagen en miniatura incrustada si está presente en los metadatos. | QImage |
| CoverArtImage | Una imagen de portada incrustada. | 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 vídeo. | QSize |
Documentación de los tipos de miembros
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 medio |
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 |
QMediaMetaData::Copyright | 8 | Información sobre los derechos de autor |
QMediaMetaData::Url | 9 | URL del sitio web del editor |
QMediaMetaData::Duration | 10 | Duración de la reproducción |
QMediaMetaData::MediaType | 11 | Tipo de medio |
QMediaMetaData::FileFormat | 12 | Formato del 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 del artista |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | Información del compositor |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | Imagen en miniatura del medio (si está incluida en los metadatos) |
QMediaMetaData::CoverArtImage | 25 | Carátula del medio |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | El vídeo puede tener contenido HDR (sólo lectura, sólo FFmpeg y Darwin) |
Documentación de las funciones de los miembros
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
Devuelve un objeto range que permite iterar sobre 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 puede invocarse 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 value en una Clave: k.
Nota: Esta función puede invocarse 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 elementos; en caso contrario, devuelve false.
Nota: Esta función puede invocarse 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 datos para Clave key.
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
Devuelve un QList de QMediaMetaData::Keys.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
devuelve una representación de cadena de key que puede utilizarse al presentar metadatos a los usuarios.
Nota: Esta función puede invocarse 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 puede invocarse 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 como QString.
El objetivo principal es simplificar la presentación de los metadatos al usuario.
Nota: Esta función puede invocarse 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 de la clave key, o un valor nulo QVariant si no hay metadatos disponibles para la clave.
Nota: Esta función puede invocarse 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 miembro
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
Esta variable contiene los metadatos.
Nota: este es un miembro protected de su clase.
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.
