QMediaMetaData 类

为媒体文件提供元数据。更多...

头文件	#include <QMediaMetaData>
CMake	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake	QT += multimedia

所有成员列表，包括继承成员

公共类型

枚举	Key { Title, Author, Comment, Description, Genre, …, Resolution }

公共函数

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

静态受保护的成员

QMetaType keyType(QMediaMetaData::Key key)

bool	operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
bool	operator==(const QMediaMetaData &a, const QMediaMetaData &b)

详细描述

注意：不是所有平台都支持所有标识符。

常见属性
值	描述	类型
Title	媒体的标题。	QString
Author	媒体的作者。	QStringList
Comment	有关媒体的用户评论。	QString
描述	媒体描述。	QString
Genre	媒体的类型。	QStringList
Date	媒体的日期。	QDateTime.
Language	媒体的语言。	QLocale::Language
Publisher	媒体出版者。	QString
Copyright	媒体的版权声明。	QString
Url	指向媒体来源的 URL。	QUrl
媒体属性
MediaType	媒体的类型（音频、视频等）。	QString
FileFormat	媒体文件格式。	QMediaFormat::FileFormat
Duration	媒体持续时间的毫秒数。	qint64
音频属性
AudioBitRate	媒体音频流的比特率，以每秒比特数表示。	int
AudioCodec	媒体音频流的编解码器。	QMediaFormat::AudioCodec
视频属性
VideoFrameRate	媒体视频流的帧率。	qreal
VideoBitRate	媒体视频流的比特率，以每秒比特数表示。	int
VideoCodec	媒体视频流的编解码器。	QMediaFormat::VideoCodec
音乐属性
AlbumTitle	该媒体所属专辑的标题。	QString
AlbumArtist	该媒体所属专辑的主要艺术家。	QString
ContributingArtist	为该媒体做出贡献的艺术家。	QStringList
TrackNumber	该媒体的轨道编号。	int
Composer	该媒体的作曲家。	QStringList
LeadPerformer	媒体中的主要表演者。	QStringList
ThumbnailImage	如果元数据中存在，则为嵌入的缩略图图像。	QImage
CoverArtImage	嵌入的封面艺术图像。	QImage
图像和视频属性
Orientation	图像或视频的旋转角度。	int
Resolution	图像或视频的尺寸。	QSize

成员类型文档

enum QMediaMetaData::Key

以下元数据键可以使用

常量	值	描述
`QMediaMetaData::Title`	`0`	媒体标题
`QMediaMetaData::Author`	`1`	媒体作者
`QMediaMetaData::Comment`	`2`	Comment
`QMediaMetaData::Description`	`3`	简短描述
`QMediaMetaData::Genre`	`4`	媒体所属的流派
`QMediaMetaData::Date`	`5`	创建日期
`QMediaMetaData::Language`	`6`	媒体语言
`QMediaMetaData::Publisher`	`7`	媒体出版信息。
`QMediaMetaData::Copyright`	`8`	媒体版权信息。
`QMediaMetaData::Url`	`9`	出版商的网站URL
`QMediaMetaData::Duration`	`10`	媒体播放时长
`QMediaMetaData::MediaType`	`11`	媒体的类型
`QMediaMetaData::FileFormat`	`12`	文件格式
`QMediaMetaData::AudioBitRate`	`13`
`QMediaMetaData::AudioCodec`	`14`
`QMediaMetaData::VideoBitRate`	`15`
`QMediaMetaData::VideoCodec`	`16`
`QMediaMetaData::VideoFrameRate`	`17`
`QMediaMetaData::AlbumTitle`	`18`	专辑的标题
`QMediaMetaData::AlbumArtist`	`19`	艺术家信息。
`QMediaMetaData::ContributingArtist`	`20`
`QMediaMetaData::TrackNumber`	`21`
`QMediaMetaData::Composer`	`22`	媒体作曲家信息。
`QMediaMetaData::LeadPerformer`	`23`
`QMediaMetaData::ThumbnailImage`	`24`	媒体缩略图图像（如果嵌入在元数据中）
`QMediaMetaData::CoverArtImage`	`25`	媒体封面艺术
`QMediaMetaData::Orientation`	`26`
`QMediaMetaData::Resolution`	`27`

成员函数文档

`[可调用]` void QMediaMetaData::clear()

从元数据对象中移除所有数据。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

`[可调用]` void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)

向键： k 插入一个 value。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

`[可调用]` bool QMediaMetaData::isEmpty() const

如果元数据不包含项目，则返回 true；否则返回 false。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

静态保护：`[static protected]` QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)

返回用于存储Key key数据的元类型。

调用：`[invokable]` QList<QMediaMetaData::Key> QMediaMetaData::keys() const

返回一个包含QMediaMetaData::Keys的QList列表。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

静态调用：`[static invokable]` QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)

返回用于向用户展示元数据的key的字符串表示形式。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

调用：`[invokable]` void QMediaMetaData::remove(QMediaMetaData::Key k)

从Key k中删除元数据。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

调用：`[invokable]` QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const

将key key的元数据作为QString返回。

这主要是为了简化向用户展示元数据。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

调用：`[invokable]` QVariant QMediaMetaData::value(QMediaMetaData::Key key) const

返回Key key的元数据值，如果没有可用的元数据则为空QVariant。

注意：此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。

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

返回Key k存储的数据。

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

成员变量文档

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

此变量持有元数据。

注意：这是一个类中的protected成员。

相关非成员

bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)

比较两个元数据对象a和b，如果它们相同则返回false，如果它们不同则返回true。

bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)

比较两个元数据对象a和b，如果它们相同则返回true，如果它们不同则返回false。

© 2024 The Qt Company Ltd. 本文件中的文档贡献的版权属于其各自的拥有者。所提供的文档根据免费软件基金会发布的 GNU自由文档许可协议1.3版进行许可。Qt及其相关商标是芬兰和/或在全世界其他国家的The Qt Company Ltd.的商标。所有其他商标均为其各自所有者的财产。