Provides meta-data for media files. More...
Header: | #include <QMediaMetaData> |
CMake: | find_package(Qt6 COMPONENTS Multimedia REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
qmake: | QT += multimedia |
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) |
QString | metaDataKeyToString(QMediaMetaData::Key key) |
QHash<QMediaMetaData::Key, QVariant> | data |
bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
Note: Not all identifiers are supported on all platforms.
Common attributes | ||
---|---|---|
Value | Description | Type |
Title | The title of the media. | QString |
Author | The authors of the media. | QStringList |
Comment | A user comment about the media. | QString |
Description | A description of the media. | QString |
Genre | The genre of the media. | QStringList |
Date | The date of the media. | QDate. |
Language | The language of media. | QLocale::Language |
Publisher | The publisher of the media. | QString |
Copyright | The media's copyright notice. | QString |
Url | A Url pointing to the origin of the media. | QUrl |
Media attributes | ||
MediaType | The type of the media (audio, video, etc). | QString |
FileFormat | The file format of the media. | QMediaFormat::FileFormat |
Duration | The duration in millseconds of the media. | qint64 |
Audio attributes | ||
AudioBitRate | The bit rate of the media's audio stream in bits per second. | int |
AudioCodec | The codec of the media's audio stream. | QMediaForma::AudioCodec |
Video attributes | ||
VideoFrameRate | The frame rate of the media's video stream. | qreal |
VideoBitRate | The bit rate of the media's video stream in bits per second. | int |
VideoCodec | The codec of the media's video stream. | QMediaFormat::VideoCodec |
Music attributes | ||
AlbumTitle | The title of the album the media belongs to. | QString |
AlbumArtist | The principal artist of the album the media belongs to. | QString |
ContributingArtist | The artists contributing to the media. | QStringList |
TrackNumber | The track number of the media. | int |
Composer | The composer of the media. | QStringList |
LeadPerformer | The lead performer in the media. | QStringList |
ThumbnailImage | An embedded thumbnail image. | QImage |
CoverArtImage | An embedded cover art image. | QImage |
Image and video attributes | ||
Resolution | The dimensions of an image or video. | QSize |
[invokable]
void QMediaMetaData::clear()
Removes all data from the meta data object.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
Inserts a value into a Key: k.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
bool QMediaMetaData::isEmpty() const
Returns true
if the meta data contains no items: otherwise returns false
.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
QList<QMediaMetaData::Key> QMediaMetaData::keys() const
Returns a QList of QMediaMetaData::Keys.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[static invokable]
QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
returns a string representation of key that can be used when presenting meta data to users.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
void QMediaMetaData::remove(QMediaMetaData::Key k)
Removes meta data from a Key: k.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
Returns the meta data for key key as a QString.
This is mainly meant to simplify presenting the meta data to a user.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
[invokable]
QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
Returns the meta data value for Key key, or a null QVariant if no meta data for the key is available.
Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.
Returns data stored at the Key k.
QMediaMetaData rockBallad1; rockBalad[QMediaMetaData::Genre]="Rock"
This variable holds the meta data.
Note: this is a protected
member of its class.
Compares two meta data objects a and b, and returns false
if they are identical or true
if they differ.
Compares two meta data objects a and b, and returns true
if they are identical or false
if they differ.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qmediametadata.html