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 } |
パブリック関数
(since 6.9) auto | asKeyValueRange() const |
| 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 表示を想定している場合に true になります（FFmpeg および Darwin メディアバックエンドのみ）。 | bool |
| 音楽の属性 | ||
| AlbumTitle | メディアが属するアルバムのタイトル。 | QString |
| AlbumArtist | メディアが属するアルバムのメインアーティスト。 | QString |
| ContributingArtist | そのメディアに参加しているアーティスト。 | QStringList |
| TrackNumber | メディアのトラック番号。 | int |
| 作曲者 | そのメディアの作曲者。 | QStringList |
| LeadPerformer | メディアのメイン演奏者。 | QStringList |
| CoverArtImage | 埋め込まれたカバーアート画像。 | QImage |
| ThumbnailImage | 埋め込まれたサムネイル画像。（6.12 以降では非推奨。代わりに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 | メディアのサムネイル画像（バージョン6.12以降では非推奨。下位互換性のため、CoverArtImageと同一） |
QMediaMetaData::CoverArtImage | LeadPerformer + 2 | メディアのカバーアート |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | 動画にHDRコンテンツが含まれている場合がある（読み取り専用、FFmpegおよびDarwinメディアバックエンドのみ） |
メンバー関数のドキュメント
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
このハッシュをキー/値のペアとして反復処理できる範囲オブジェクトを返します。
この関数は Qt 6.9 で導入されました。
[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)
キーからメタデータを削除します：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 を参照してください。
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
キー「k 」に格納されているデータを返します。
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 ` を返します。
© 2026 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.
