QMediaMetaData Class
Fournit des métadonnées pour les fichiers multimédias. Plus d'informations...
| 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) |
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 identificateurs ne sont pas pris en charge sur toutes les plates-formes.
| Attributs communs | ||
|---|---|---|
| Valeur | Description de l'attribut | Type d'identifiant |
| Titre | Le titre du média. | QString |
| Auteur | Les auteurs du média. | QStringList |
| Commentaire | Un commentaire de l'utilisateur sur le média. | QString |
| Description | Une description du média. | QString |
| Genre | Le genre du média. | QStringList |
| Date | La date d'enregistrement du fichier multimédia ou la date d'encodage du flux multimédia. | QDateTime. |
| Langue | La langue du média. | QLocale::Language |
| Éditeur | L'éditeur du média. | QString |
| Droits d'auteur | La notice de copyright du média. | QString |
| Url | Une Url pointant vers l'origine du média. | QUrl |
| Attributs du média | ||
| MediaType | Le type de média (audio, vidéo, etc.). | QString |
| FileFormat | Le format de fichier du média. | QMediaFormat::FileFormat |
| Durée | La durée en millisecondes du média. | qint64 |
| Attributs audio | ||
| AudioBitRate | Le débit 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 | 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 | True si la vidéo est destinée à un affichage HDR (FFmpeg et Darwin media backends uniquement). | bool |
| Attributs musicaux | ||
| AlbumTitle | Le titre de l'album auquel appartient le média. | QString |
| AlbumArtist | L'artiste principal de l'album auquel appartient le média. | QString |
| ContributingArtist | Les artistes ayant contribué au média. | QStringList |
| TrackNumber | Le numéro de piste du média. | int |
| Compositeur | Le compositeur du média. | QStringList |
| LeadPerformer | L'interprète principal du média. | QStringList |
| ThumbnailImage | Une vignette intégrée si elle est présente dans les métadonnées. | QImage |
| CoverArtImage | Une image de couverture intégrée. | QImage |
| Attributs des images et des vidéos | ||
| Orientation | Angle de rotation d'une image ou d'une vidéo. | int |
| Résolution | Dimensions de l'image ou de la vidéo. | QSize |
Documentation des types de membres
enum QMediaMetaData::Key
Les clés de métadonnées suivantes peuvent être utilisées :
| Constante | Valeur | Description de l'article |
|---|---|---|
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 le copyright 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 de 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 du média |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | Image miniature du média (si elle est incluse dans les métadonnées) |
QMediaMetaData::CoverArtImage | 25 | Pochette du média |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | La vidéo peut avoir un contenu HDR (lecture seule, FFmpeg et Darwin media backends uniquement) |
Documentation des fonctions membres
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
Renvoie un objet range qui permet d'itérer sur 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 invoquée via le système des méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
Insère un value dans une clé : k.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QMediaMetaData::isEmpty() const
Renvoie true si les métadonnées ne contiennent aucun élément ; sinon, renvoie false.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)
Renvoie le méta type utilisé pour stocker les données de la clé key.
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
Renvoie une adresse QList de QMediaMetaData::Keys.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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 qui peut être utilisée lors de la présentation des métadonnées aux utilisateurs.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)
Supprime les métadonnées d'une clé : k.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
Renvoie les métadonnées de la clé key sous la forme d'un fichier QString.
Cette fonction est principalement destinée à simplifier la présentation des métadonnées à l'utilisateur.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
Renvoie la valeur des métadonnées pour la clé key, ou une valeur nulle QVariant si aucune métadonnée n'est disponible pour la clé.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
Renvoie les données stockées dans 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 protected de sa classe.
Non-membres apparenté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.
