为媒体文件提供元数据。 更多...
头: | #include <QMediaMetaData> |
CMake: |
find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
qmake: | QT += multimedia |
enum | 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 |
注释 | 关于媒体的用户评论。 | QString |
描述 | 媒体的描述。 | QString |
Genre | 媒体的流派。 | QStringList |
Date | 媒体的日期。 | QDateTime . |
语言 | 媒体的语言。 | QLocale::Language |
Publisher | 媒体的出版商。 | QString |
Copyright | 媒体的版权声明。 | QString |
Url | 指向媒体来源的 Url。 | QUrl |
媒体属性 | ||
MediaType | 媒体的类型 (音频、视频、等)。 | QString |
FileFormat | 媒体的文件格式。 | QMediaFormat::FileFormat |
Duration | 媒体的持续时间 (以毫秒为单位)。 | qint64 |
音频属性 | ||
AudioBitRate | 媒体音频流的比特率 (以位每秒为单位)。 | int |
AudioCodec | 媒体音频流的编解码器。 | QMediaFormat::AudioCodec |
视频属性 | ||
VideoFrameRate | 媒体视频流的帧速率。 | 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 |
音乐属性 | ||
AlbumTitle | 媒体所属的专辑标题。 | QString |
AlbumArtist | 媒体所属专辑的亲代艺术家。 | QString |
ContributingArtist | 媒体的贡献艺术家。 | QStringList |
TrackNumber | 媒体轨道编号。 | int |
Composer | 媒体的作曲家。 | QStringList |
LeadPerformer | The lead performer in the media. | QStringList |
ThumbnailImage | An embedded thumbnail image if present in metadata. | QImage |
CoverArtImage | 嵌入的封面艺术图像。 | QImage |
图像和视频属性 | ||
取向 | The rotation angle of an image or video. | int |
Resolution | 图像或视频的尺度。 | QSize |
The following meta data keys can be used:
常量 | 值 | 描述 |
---|---|---|
QMediaMetaData::Title
|
0
|
Media title |
QMediaMetaData::Author
|
1
|
Media author |
QMediaMetaData::Comment
|
2
|
注释 |
QMediaMetaData::Description
|
3
|
Brief desripttion |
QMediaMetaData::Genre
|
4
|
Genre the media belongs to |
QMediaMetaData::Date
|
5
|
Creation date |
QMediaMetaData::Language
|
6
|
Media language |
QMediaMetaData::Publisher
|
7
|
Media publisher info. |
QMediaMetaData::Copyright
|
8
|
Media copyright info. |
QMediaMetaData::Url
|
9
|
Publisher's website URL |
QMediaMetaData::Duration
|
10
|
Media playback duration |
QMediaMetaData::MediaType
|
11
|
Type of the media |
QMediaMetaData::FileFormat
|
12
|
文件格式 |
QMediaMetaData::AudioBitRate
|
13
|
|
QMediaMetaData::AudioCodec
|
14
|
|
QMediaMetaData::VideoBitRate
|
15
|
|
QMediaMetaData::VideoCodec
|
16
|
|
QMediaMetaData::VideoFrameRate
|
17
|
|
QMediaMetaData::AlbumTitle
|
18
|
Album's title |
QMediaMetaData::AlbumArtist
|
19
|
Artist's info. |
QMediaMetaData::ContributingArtist
|
20
|
|
QMediaMetaData::TrackNumber
|
21
|
|
QMediaMetaData::Composer
|
22
|
Media composer's info. |
QMediaMetaData::LeadPerformer
|
23
|
|
QMediaMetaData::ThumbnailImage
|
24
|
Media thumbnail image (if embedded in metadata) |
QMediaMetaData::CoverArtImage
|
25
|
Media cover art |
QMediaMetaData::Orientation
|
26
|
|
QMediaMetaData::Resolution
|
27
|
[invokable]
void
QMediaMetaData::
clear
()
从元数据对象移除所有数据。
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[invokable]
void
QMediaMetaData::
insert
(
QMediaMetaData::Key
k
, const
QVariant
&
value
)
插入 value 进键: k .
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[invokable]
bool
QMediaMetaData::
isEmpty
() const
返回
true
若元数据不包含项:否则返回
false
.
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[static protected]
QMetaType
QMediaMetaData::
keyType
(
QMediaMetaData::Key
key
)
Returns the meta type used to store data for Key key .
[invokable]
QList
<
QMediaMetaData::Key
> QMediaMetaData::
keys
() const
返回 QList of QMediaMetaData::Keys.
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[static invokable]
QString
QMediaMetaData::
metaDataKeyToString
(
QMediaMetaData::Key
key
)
返回字符串表示为 key ,其可以被使用当向用户呈现元数据时。
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[invokable]
void
QMediaMetaData::
remove
(
QMediaMetaData::Key
k
)
移除元数据从键: k .
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[invokable]
QString
QMediaMetaData::
stringValue
(
QMediaMetaData::Key
key
) const
返回元数据为键 key 作为 QString .
这主要意味着是将元数据向用户呈现的简化。
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
[invokable]
QVariant
QMediaMetaData::
value
(
QMediaMetaData::Key
key
) const
返回元数据值为键 key ,或 null QVariant 若没有可用的键元数据。
注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .
Returns data stored at the Key k .
QMediaMetaData rockBallad1; rockBalad[QMediaMetaData::Genre]="Rock"
此变量保持元数据。
注意:
this is a
protected
member of its class.
Compares two meta data objects
a
and
b
,并返回
false
if they are identical or
true
若它们不同。
Compares two meta data objects
a
and
b
,并返回
true
if they are identical or
false
若它们不同。