Sur cette page

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)
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
ValeurDescriptionType
TitreLe titre du média.QString
AuteurLes auteurs du média.QStringList
CommentaireCommentaire d'un utilisateur sur le média.QString
DescriptionUne description du média.QString
GenreLe genre du média.QStringList
DateDate et heure d'enregistrement du fichier multimédia, ou date et heure d'encodage du flux multimédia.QDateTime.
LangueLa langue du fichier multimédia.QLocale::Language
ÉditeurL'éditeur du média.QString
Droits d'auteurMention des droits d'auteur du média.QString
URLUne URL pointant vers la source du média.QUrl
Attributs du média
MediaTypeLe type du média (audio, vidéo, etc.).QString
FileFormatLe format de fichier du média.QMediaFormat::FileFormat
DuréeLa durée du média en millisecondes.qint64
Attributs audio
AudioBitRateDébit binaire du flux audio du média, en bits par seconde.int
AudioCodecLe codec du flux audio du média.QMediaFormat::AudioCodec
Attributs vidéo
VideoFrameRateLa fréquence d'images du flux vidéo du média.qreal
VideoBitRateLe débit binaire du flux vidéo du média, en bits par seconde.int
VideoCodecLe codec du flux vidéo du média.QMediaFormat::VideoCodec
HasHdrContentVrai si la vidéo est destinée à un affichage HDR (backends multimédia FFmpeg et Darwin uniquement).bool
Attributs musicaux
AlbumTitleLe titre de l’album auquel appartient le fichier multimédia.QString
AlbumArtistL'artiste principal de l'album auquel appartient le média.QString
ContributingArtistLes artistes ayant contribué au fichier multimédia.QStringList
TrackNumberLe numéro de piste du média.int
CompositeurLe compositeur du support.QStringList
LeadPerformerL'interprète principal du média.QStringList
CoverArtImageUne image de pochette intégrée.QImage
ThumbnailImageUne image miniature intégrée. (obsolète depuis la version 6.12, utilisez plutôt CoverArtImage )QImage
Attributs des images et des vidéos
OrientationAngle de rotation d'une image ou d'une vidéo.int
RésolutionLes 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 :

ConstanteValeurDescription
QMediaMetaData::Title0Titre du média
QMediaMetaData::Author1Auteur du média
QMediaMetaData::Comment2Commentaire
QMediaMetaData::Description3Brève description
QMediaMetaData::Genre4Genre auquel appartient le média
QMediaMetaData::Date5Date de création
QMediaMetaData::Language6Langue du média
QMediaMetaData::Publisher7Informations sur l'éditeur du média
QMediaMetaData::Copyright8Informations sur les droits d'auteur du média
QMediaMetaData::Url9URL du site web de l'éditeur
QMediaMetaData::Duration10Durée de lecture du média
QMediaMetaData::MediaType11Type du média
QMediaMetaData::FileFormat12Format du fichier
QMediaMetaData::AudioBitRate13 
QMediaMetaData::AudioCodec14 
QMediaMetaData::VideoBitRate15 
QMediaMetaData::VideoCodec16 
QMediaMetaData::VideoFrameRate17 
QMediaMetaData::AlbumTitle18Titre de l'album
QMediaMetaData::AlbumArtist19Informations sur l'artiste
QMediaMetaData::ContributingArtist20 
QMediaMetaData::TrackNumber21 
QMediaMetaData::Composer22Informations sur le compositeur
QMediaMetaData::LeadPerformer23 
QMediaMetaData::ThumbnailImage24Vignette du média (obsolète depuis la version 6.12, identique à CoverArtImage pour des raisons de compatibilité ascendante)
QMediaMetaData::CoverArtImageLeadPerformer + 2Pochette du média
QMediaMetaData::Orientation26 
QMediaMetaData::Resolution27 
QMediaMetaData::HasHdrContent (since Qt 6.8)28La 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.