QMediaMetaData Class
メディアファイルのメタデータを提供する。詳細...
| ヘッダ | #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, …, HasHdrContent } |
パブリック関数
| 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) |
詳細説明
注意: すべてのプラットフォームですべての識別子がサポートされているわけではありません。
| 共通属性 | ||
|---|---|---|
| 値 | 説明 | タイプ |
| タイトル | メディアのタイトル。 | QString |
| 著者名 | メディアの著者 | QStringList |
| コメント | メディアに関するユーザーコメント。 | QString |
| 説明 | メディアの説明。 | QString |
| ジャンル | メディアのジャンル | QStringList |
| 日付 | メディアの日付。 | QDateTime. |
| 言語 | メディアの言語。 | QLocale::Language |
| 発行者 | メディアの発行元。 | QString |
| 著作権 | メディアの著作権表示。 | QString |
| URL | メディアの発行元を指すUrl。 | QUrl |
| メディアの属性 | ||
| MediaType | メディアの種類（オーディオ、ビデオなど）。 | QString |
| FileFormat | メディアのファイル形式 | QMediaFormat::FileFormat |
| 継続時間 | メディアの継続時間（ミリ秒単位）。 | qint64 |
| オーディオ属性 | ||
| AudioBitRate | メディアのオーディオストリームのビットレート。 | int |
| AudioCodec | メディアのオーディオストリームのコーデック。 | QMediaFormat::AudioCodec |
| ビデオ属性 | ||
| VideoFrameRate | メディアのビデオ・ストリームのフレーム・レート。 | qreal |
| VideoBitRate | メディアのビデオストリームのビットレート。 | int |
| VideoCodec | メディアのビデオストリームのコーデック。 | QMediaFormat::VideoCodec |
| HasHdrContent | ビデオが HDR 表示用の場合は真（FFmpeg および Darwin メディアバックエンドのみ）。 | ブール |
| 音楽属性 | ||
| AlbumTitle | メディアが属するアルバムのタイトル。 | QString |
| AlbumArtist | メディアが属するアルバムの主要アーティスト。 | QString |
| ContributingArtist | メディアに貢献しているアーティスト。 | QStringList |
| TrackNumber | メディアのトラック番号。 | int |
| 作曲者 | メディアの作曲者。 | QStringList |
| LeadPerformer | メディアのリードパフォーマー。 | QStringList |
| ThumbnailImage | メタデータに存在する場合、埋め込まれたサムネイル画像。 | QImage |
| CoverArtImage | 埋め込まれたカバーアート画像。 | QImage |
| 画像と動画の属性 | ||
| 向き | 画像や動画の回転角度。 | int |
| 解像度 | 画像や動画のサイズ。 | QSize |
メンバ型のドキュメント
enum QMediaMetaData::Key
以下のメタデータキーを使用できます：
| 定数 | 値 | 説明 |
|---|---|---|
QMediaMetaData::Title | 0 | メディアのタイトル |
QMediaMetaData::Author | 1 | メディア作者 |
QMediaMetaData::Comment | 2 | コメント |
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 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | ビデオにHDRコンテンツがある可能性（読み取り専用、FFmpegおよびDarwinメディアバックエンドのみ） |
メンバー関数ドキュメント
[invokable] void QMediaMetaData::clear()
メタデータオブジェクトからすべてのデータを削除します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
value を Key に挿入する:k 。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QMediaMetaData::isEmpty() const
メタデータに項目がない場合はtrue を返します。そうでない場合はfalse を返します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::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 のメタデータをQString として返す。
これは主に、ユーザにメタデータを提示しやすくするためのものです。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
Keykey のメタデータ値、またはそのキーのメタデータがない場合は nullQVariant を返す。
注： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
Keyk に格納されているデータを返す。
QMediaMetaData rockBallad1; rockBalad[QMediaMetaData::Genre]="Rock"
メンバ変数のドキュメント
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
この変数はメタデータを保持する。
注意： これはそのクラスのprotected メンバです。
関連する非メンバー
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
2つのメタデータ・オブジェクトa とb を比較し、同一であればfalse を、異なればtrue を返す。
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
2つのメタデータ・オブジェクトa とb を比較し、同一であればtrue を、異なればfalse を返す。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
