QMediaMetaData Class
Stellt Metadaten für Mediendateien bereit. Mehr...
| Kopfzeile: | #include <QMediaMetaData> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
Öffentliche Typen
| enum | Key { Title, Author, Comment, Description, Genre, …, HasHdrContent } |
Öffentliche Funktionen
(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) |
Statische öffentliche Elemente
| QString | metaDataKeyToString(QMediaMetaData::Key key) |
Geschützte Variablen
| QHash<QMediaMetaData::Key, QVariant> | data |
Statische geschützte Mitglieder
| QMetaType | keyType(QMediaMetaData::Key key) |
Zugehörige Nicht-Mitglieder
| bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
| bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
Detaillierte Beschreibung
Hinweis: Nicht alle Bezeichner werden auf allen Plattformen unterstützt.
| Allgemeine Attribute | ||
|---|---|---|
| Wert | Beschreibung | Typ |
| Titel | Der Titel des Mediums. | QString |
| Autor | Die Autoren des Mediums. | QStringList |
| Kommentar | Ein Nutzerkommentar zu dem Medium. | QString |
| Beschreibung | Eine Beschreibung des Mediums. | QString |
| Genre | Das Genre des Mediums. | QStringList |
| Datum | Das Aufnahmedatum und die Uhrzeit der Mediendatei oder das Datum und die Uhrzeit der Kodierung des Medienstroms. | QDateTime. |
| Sprache | Die Sprache des Mediums. | QLocale::Language |
| Herausgeber | Der Herausgeber des Mediums. | QString |
| Urheberrecht | Der Urheberrechtshinweis des Mediums. | QString |
| URL | Eine URL, die auf die Quelle des Mediums verweist. | QUrl |
| Medienattribute | ||
| MediaType | Der Typ des Mediums (Audio, Video usw.). | QString |
| FileFormat | Das Dateiformat des Mediums. | QMediaFormat::FileFormat |
| Dauer | Die Dauer des Mediums in Millisekunden. | qint64 |
| Audio-Attribute | ||
| AudioBitRate | Die Bitrate des Audiostreams der Medien in Bit pro Sekunde. | int |
| AudioCodec | Der Codec des Audiostreams des Mediums. | QMediaFormat::AudioCodec |
| Videoattribute | ||
| VideoFrameRate | Die Bildrate des Videostreams des Mediums. | qreal |
| VideoBitRate | Die Bitrate des Videostreams des Mediums in Bit pro Sekunde. | int |
| VideoCodec | Der Codec des Videostreams des Mediums. | QMediaFormat::VideoCodec |
| HasHdrContent | Wahr, wenn das Video für die HDR-Wiedergabe vorgesehen ist (nur FFmpeg- und Darwin-Medien-Backends). | bool |
| Musikattribute | ||
| AlbumTitle | Der Titel des Albums, zu dem das Medium gehört. | QString |
| AlbumArtist | Der Hauptkünstler des Albums, zu dem das Medium gehört. | QString |
| ContributingArtist | Die an der Mediendatei beteiligten Interpreten. | QStringList |
| TrackNumber | Die Titelnummer des Mediums. | int |
| Komponist | Der Komponist des Mediums. | QStringList |
| LeadPerformer | Der Hauptinterpret des Mediums. | QStringList |
| CoverArtImage | Ein eingebettetes Coverbild. | QImage |
| ThumbnailImage | Ein eingebettetes Miniaturbild. (seit Version 6.12 veraltet, verwende stattdessen „ CoverArtImage “) | QImage |
| Bild- und Videoattribute | ||
| Ausrichtung | Der Drehwinkel eines Bildes oder Videos. | int |
| Auflösung | Die Abmessungen eines Bildes oder Videos. | QSize |
Dokumentation zum Mitgliedstyp
enum QMediaMetaData::Key
Die folgenden Metadatenschlüssel können verwendet werden:
| Konstante | Wert | Beschreibung |
|---|---|---|
QMediaMetaData::Title | 0 | Medientitel |
QMediaMetaData::Author | 1 | Medienautor |
QMediaMetaData::Comment | 2 | Kommentar |
QMediaMetaData::Description | 3 | Kurzbeschreibung |
QMediaMetaData::Genre | 4 | Genre, zu dem das Medium gehört |
QMediaMetaData::Date | 5 | Erstellungsdatum |
QMediaMetaData::Language | 6 | Sprache des Mediums |
QMediaMetaData::Publisher | 7 | Informationen zum Herausgeber des Mediums |
QMediaMetaData::Copyright | 8 | Informationen zum Urheberrecht des Mediums |
QMediaMetaData::Url | 9 | URL der Website des Herausgebers |
QMediaMetaData::Duration | 10 | Wiedergabedauer des Mediums |
QMediaMetaData::MediaType | 11 | Art des Mediums |
QMediaMetaData::FileFormat | 12 | Dateiformat |
QMediaMetaData::AudioBitRate | 13 | |
QMediaMetaData::AudioCodec | 14 | |
QMediaMetaData::VideoBitRate | 15 | |
QMediaMetaData::VideoCodec | 16 | |
QMediaMetaData::VideoFrameRate | 17 | |
QMediaMetaData::AlbumTitle | 18 | Albumtitel |
QMediaMetaData::AlbumArtist | 19 | Informationen zum Künstler |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | Informationen zum Medienkomponisten |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | Miniaturbild des Mediums (seit Version 6.12 veraltet, aus Gründen der Abwärtskompatibilität identisch mit „CoverArtImage“) |
QMediaMetaData::CoverArtImage | LeadPerformer + 2 | Medien-Cover |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | Das Video enthält möglicherweise HDR-Inhalte (schreibgeschützt, nur FFmpeg- und Darwin-Medien-Backends) |
Dokumentation der Mitgliedsfunktionen
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
Gibt ein Range-Objekt zurück, mit dem dieser Hash als Schlüssel-Wert-Paare durchlaufen werden kann.
Diese Funktion wurde in Qt 6.9 eingeführt.
[invokable] void QMediaMetaData::clear()
Entfernt alle Daten aus dem Metadatenobjekt.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
Fügt ein „ value “ in einen Schlüssel ein: k.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QMediaMetaData::isEmpty() const
Gibt „ true “ zurück, wenn die Metadaten keine Elemente enthalten; andernfalls wird „ false “ zurückgegeben.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)
Gibt den Metatyp zurück, der zum Speichern von Daten für den Schlüssel „ key “ verwendet wird.
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
Gibt ein ` QList ` vom Typ `QMediaMetaData::Keys` zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
Gibt eine Zeichenfolgenrepräsentation von ` key ` zurück, die bei der Darstellung von Metadaten für Benutzer verwendet werden kann.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)
Entfernt Metadaten aus einem Schlüssel: k.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
Gibt die Metadaten für den Schlüssel „ key “ als „ QString “ zurück.
Dies dient in erster Linie dazu, die Darstellung der Metadaten für den Benutzer zu vereinfachen.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
Gibt den Metadatenwert für den Schlüssel „ key “ zurück oder einen Null- QVariant, falls keine Metadaten für den Schlüssel verfügbar sind.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
Gibt die unter dem Schlüssel „ k “ gespeicherten Daten zurück.
QMediaMetaData rockBallad1;
rockBalad[QMediaMetaData::Genre]="Rock"Dokumentation zu Member-Variablen
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
Diese Variable enthält die Metadaten.
Hinweis: Dies ist ein „ protected “-Element seiner Klasse.
Verwandte Nicht-Mitglieder
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
Vergleicht zwei Metadatenobjekte a und b und gibt false zurück, wenn sie identisch sind, oder true, wenn sie sich unterscheiden.
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
Vergleicht zwei Metadatenobjekte „ a “ und „ b “ und gibt „ true “ zurück, wenn sie identisch sind, oder „ false “, wenn sie sich unterscheiden.
© 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.
