为媒体文件提供元数据。 更多...
| 头: | #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
若它们不同。