QMediaMetaData Class
Fournit des métadonnées pour les fichiers multimédias. En savoir plus...
| En-tête : | #include <QMediaMetaData> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake : | QT += multimedia |
Types publics
| enum | Key { Title, Author, Comment, Description, Genre, …, HasHdrContent } |
Fonctions publiques
(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) |
Membres publics statiques
| QString | metaDataKeyToString(QMediaMetaData::Key key) |
Variables protégées
| QHash<QMediaMetaData::Key, QVariant> | data |
Membres statiques protégés
| QMetaType | keyType(QMediaMetaData::Key key) |
Éléments non membres associés
| bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
| bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
Description détaillée
Remarque : tous les identifiantsne sontpas pris en charge sur toutes les plateformes.
| Attributs courants | ||
|---|---|---|
| Valeur | Description | Type |
| Titre | Le titre du média. | QString |
| Auteur | Les auteurs du média. | QStringList |
| Commentaire | Commentaire d'un utilisateur sur le média. | QString |
| Description | Une description du média. | QString |
| Genre | Le genre du média. | QStringList |
| Date | Date et heure d'enregistrement du fichier multimédia, ou date et heure d'encodage du flux multimédia. | QDateTime. |
| Langue | La langue du fichier multimédia. | QLocale::Language |
| Éditeur | L'éditeur du média. | QString |
| Droits d'auteur | Mention des droits d'auteur du média. | QString |
| URL | Une URL pointant vers la source du média. | QUrl |
| Attributs du média | ||
| MediaType | Le type du média (audio, vidéo, etc.). | QString |
| FileFormat | Le format de fichier du média. | QMediaFormat::FileFormat |
| Durée | La durée du média en millisecondes. | qint64 |
| Attributs audio | ||
| AudioBitRate | Débit binaire du flux audio du média, en bits par seconde. | int |
| AudioCodec | Le codec du flux audio du média. | QMediaFormat::AudioCodec |
| Attributs vidéo | ||
| VideoFrameRate | La fréquence d'images du flux vidéo du média. | qreal |
| VideoBitRate | Le débit binaire du flux vidéo du média, en bits par seconde. | int |
| VideoCodec | Le codec du flux vidéo du média. | QMediaFormat::VideoCodec |
| HasHdrContent | Vrai si la vidéo est destinée à un affichage HDR (backends multimédia FFmpeg et Darwin uniquement). | bool |
| Attributs musicaux | ||
| AlbumTitle | Le titre de l’album auquel appartient le fichier multimédia. | QString |
| AlbumArtist | L'artiste principal de l'album auquel appartient le média. | QString |
| ContributingArtist | Les artistes ayant contribué au fichier multimédia. | QStringList |
| TrackNumber | Le numéro de piste du média. | int |
| Compositeur | Le compositeur du support. | QStringList |
| LeadPerformer | L'interprète principal du média. | QStringList |
| CoverArtImage | Une image de pochette intégrée. | QImage |
| ThumbnailImage | Une image miniature intégrée. (obsolète depuis la version 6.12, utilisez plutôt CoverArtImage ) | QImage |
| Attributs des images et des vidéos | ||
| Orientation | Angle de rotation d'une image ou d'une vidéo. | int |
| Résolution | Les dimensions d'une image ou d'une vidéo. | QSize |
Documentation sur les types de membres
enum QMediaMetaData::Key
Les clés de métadonnées suivantes peuvent être utilisées :
| Constante | Valeur | Description |
|---|---|---|
QMediaMetaData::Title | 0 | Titre du média |
QMediaMetaData::Author | 1 | Auteur du média |
QMediaMetaData::Comment | 2 | Commentaire |
QMediaMetaData::Description | 3 | Brève description |
QMediaMetaData::Genre | 4 | Genre auquel appartient le média |
QMediaMetaData::Date | 5 | Date de création |
QMediaMetaData::Language | 6 | Langue du média |
QMediaMetaData::Publisher | 7 | Informations sur l'éditeur du média |
QMediaMetaData::Copyright | 8 | Informations sur les droits d'auteur du média |
QMediaMetaData::Url | 9 | URL du site web de l'éditeur |
QMediaMetaData::Duration | 10 | Durée de lecture du média |
QMediaMetaData::MediaType | 11 | Type du média |
QMediaMetaData::FileFormat | 12 | Format du fichier |
QMediaMetaData::AudioBitRate | 13 | |
QMediaMetaData::AudioCodec | 14 | |
QMediaMetaData::VideoBitRate | 15 | |
QMediaMetaData::VideoCodec | 16 | |
QMediaMetaData::VideoFrameRate | 17 | |
QMediaMetaData::AlbumTitle | 18 | Titre de l'album |
QMediaMetaData::AlbumArtist | 19 | Informations sur l'artiste |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | Informations sur le compositeur |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | Vignette du média (obsolète depuis la version 6.12, identique à CoverArtImage pour des raisons de compatibilité ascendante) |
QMediaMetaData::CoverArtImage | LeadPerformer + 2 | Pochette du média |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | La vidéo peut contenir du contenu HDR (en lecture seule, uniquement avec les backends multimédia FFmpeg et Darwin) |
Documentation des fonctions membres
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
Renvoie un objet « range » permettant de parcourir ce hachage sous forme de paires clé/valeur.
Cette fonction a été introduite dans Qt 6.9.
[invokable] void QMediaMetaData::clear()
Supprime toutes les données de l'objet de métadonnées.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
Insère un objet « value » dans une clé : k.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QMediaMetaData::isEmpty() const
Renvoie « true » si les métadonnées ne contiennent aucun élément ; sinon, renvoie « false ».
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)
Renvoie le type de métadonnées utilisé pour stocker les données de la clé « key ».
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
Renvoie une collection de type « QList » contenant des éléments de type « QMediaMetaData::Keys ».
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
Renvoie une représentation sous forme de chaîne de caractères de ` key ` pouvant être utilisée lors de la présentation des métadonnées aux utilisateurs.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)
Supprime les métadonnées d'une clé : k.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
Renvoie les métadonnées associées à la clé « key » sous la forme d'un objet de type « QString ».
Cette fonction est principalement destinée à simplifier la présentation des métadonnées à l'utilisateur.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
Renvoie la valeur des métadonnées correspondant à la clé key, ou un objet null QVariant si aucune métadonnée n'est disponible pour cette clé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
Renvoie les données stockées sous la clé « k ».
QMediaMetaData rockBallad1;
rockBalad[QMediaMetaData::Genre]="Rock"Documentation sur les variables membres
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
Cette variable contient les métadonnées.
Remarque : il s'agit d'un membre de type « protected » de sa classe.
Éléments non membres associés
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
Compare deux objets de métadonnées a et b, et renvoie false s'ils sont identiques ou true s'ils diffèrent.
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
Compare deux objets de métadonnées a et b, et renvoie true s'ils sont identiques ou false s'ils diffèrent.
© 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.