QMediaMetaData Class
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 |
Public Functions
| 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) |
Static Public Members
| QString | metaDataKeyToString(QMediaMetaData::Key key) |
Protected Variables
| QHash<QMediaMetaData::Key, QVariant> | data |
Related Non-Members
| bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
| bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
Detailed Description
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 |
Member Function Documentation
[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.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
Returns data stored at the Key k.
QMediaMetaData rockBallad1; rockBalad[QMediaMetaData::Genre]="Rock"
Member Variable Documentation
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
This property holds the metaData.
Note: this is a protected member of its class.
Related Non-Members
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
Compares two meta data objects a and b, and returns false if they are identical or true if they differ.
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
Compares two meta data objects a and b, and returns true if they are identical or false if they differ.