QMediaMetaData Class

Liefert Metadaten für Mediendateien. 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

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 Mitglieder

QString metaDataKeyToString(QMediaMetaData::Key key)

Geschützte Variablen

QHash<QMediaMetaData::Key, QVariant> data

Statische geschützte Mitglieder

QMetaType keyType(QMediaMetaData::Key key)
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.

Gemeinsame Attribute
WertBeschreibungTyp
TitelDer Titel des Mediums.QString
AutorDie Autoren des Mediums.QStringList
KommentarEin Benutzerkommentar zu den Medien.QString
BeschreibungEine Beschreibung des Mediums.QString
GenreDas Genre des Mediums.QStringList
DatumDas Datum des Mediums.QDateTime.
SpracheDie Sprache des Mediums.QLocale::Language
HerausgeberDer Herausgeber des Mediums.QString
UrheberrechtDer Copyright-Vermerk des Mediums.QString
UrlEine Url, die auf den Ursprung des Mediums verweist.QUrl
Medien-Attribute
MediaTypeDer Typ des Mediums (Audio, Video, etc.).QString
FileFormatDas Dateiformat des Mediums.QMediaFormat::FileFormat
DauerDie Dauer des Mediums in Millisekunden.qint64
Audio-Attribute
AudioBitRateDie Bitrate des Audiostroms des Mediums in Bits pro Sekunde.int
AudioCodecDer Codec des Audiostroms des Mediums.QMediaFormat::AudioCodec
Video-Attribute
VideoFrameRateDie Bildrate des Video-Streams des Mediums.qreal
VideoBitRateDie Bitrate des Video-Streams des Mediums in Bits pro Sekunde.int
VideoCodecDer Codec des Video-Streams des Mediums.QMediaFormat::VideoCodec
HasHdrContentTrue, wenn das Video für die HDR-Anzeige bestimmt ist (nur FFmpeg und Darwin Media Backends).bool
Musik-Attribute
AlbumTitleDer Titel des Albums, zu dem das Medium gehört.QString
AlbumArtistDer Hauptinterpret des Albums, zu dem das Medium gehört.QString
ContributingArtistDie Künstler, die an dem Medium mitgewirkt haben.QStringList
TrackNumberDie Titelnummer des Mediums.int
KomponistDer Komponist des Mediums.QStringList
LeadPerformerDer Hauptdarsteller in den Medien.QStringList
ThumbnailImageEin eingebettetes Miniaturbild, falls in den Metadaten vorhanden.QImage
CoverArtImageEin eingebettetes Titelbild.QImage
Bild- und Videoattribute
AusrichtungDer Drehwinkel eines Bildes oder Videos.int
AuflösungDie Abmessungen eines Bildes oder eines Videos.QSize

Dokumentation der Mitgliedstypen

enum QMediaMetaData::Key

Die folgenden Metadatenschlüssel können verwendet werden:

KonstanteWertBeschreibung
QMediaMetaData::Title0Titel des Mediums
QMediaMetaData::Author1Autor des Mediums
QMediaMetaData::Comment2Kommentar
QMediaMetaData::Description3Kurzbeschreibung
QMediaMetaData::Genre4Genre, zu dem das Medium gehört
QMediaMetaData::Date5Datum der Erstellung
QMediaMetaData::Language6Sprache des Mediums
QMediaMetaData::Publisher7Informationen zum Herausgeber des Mediums.
QMediaMetaData::Copyright8Copyright-Informationen zum Medium.
QMediaMetaData::Url9URL der Website des Herausgebers
QMediaMetaData::Duration10Dauer der Medienwiedergabe
QMediaMetaData::MediaType11Typ des Mediums
QMediaMetaData::FileFormat12Dateiformat
QMediaMetaData::AudioBitRate13
QMediaMetaData::AudioCodec14
QMediaMetaData::VideoBitRate15
QMediaMetaData::VideoCodec16
QMediaMetaData::VideoFrameRate17
QMediaMetaData::AlbumTitle18Titel des Albums
QMediaMetaData::AlbumArtist19Angaben zum Künstler.
QMediaMetaData::ContributingArtist20
QMediaMetaData::TrackNumber21
QMediaMetaData::Composer22Info des Medienkomponisten.
QMediaMetaData::LeadPerformer23
QMediaMetaData::ThumbnailImage24Medien-Thumbnail-Bild (falls in Metadaten eingebettet)
QMediaMetaData::CoverArtImage25Medien-Covergrafik
QMediaMetaData::Orientation26
QMediaMetaData::Resolution27
QMediaMetaData::HasHdrContent (since Qt 6.8)28Video kann HDR-Inhalt haben (nur lesen, nur FFmpeg und Darwin Media Backends)

Dokumentation der Mitgliedsfunktionen

[invokable] void QMediaMetaData::clear()

Entfernt alle Daten aus dem Metadatenobjekt.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)

Fügt eine value in einen Schlüssel ein: k.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QMediaMetaData::isEmpty() const

Gibt true zurück, wenn die Metadaten keine Elemente enthalten; andernfalls false.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 Key key verwendet wird.

[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const

Gibt eine QList von QMediaMetaData::Keys zurück.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)

gibt eine String-Darstellung von key zurück, die bei der Präsentation von Metadaten für Benutzer verwendet werden kann.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus 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 vor allem dazu, die Darstellung der Metadaten für den Benutzer zu vereinfachen.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 eine Null QVariant, wenn keine Metadaten für den Schlüssel verfügbar sind.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)

Gibt die im Schlüssel k gespeicherten Daten zurück.

QMediaMetaData rockBallad1;
rockBalad[QMediaMetaData::Genre]="Rock"

Dokumentation der Mitgliedsvariablen

QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data

Diese Variable enthält die Metadaten.

Hinweis: Dies ist ein protected Mitglied 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.

© 2025 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.