QMediaFormat Class
マルチメディアファイルやストリームのエンコード形式を記述する。詳細...
| ヘッダ | #include <QMediaFormat> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake： | QT += multimedia |
パブリックタイプ
| enum class | AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified } |
| enum | ConversionMode { Encode, Decode } |
| enum | FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat } |
| enum | ResolveFlags { NoFlags, RequiresVideo } |
| enum class | VideoCodec { VP8, MPEG2, MPEG1, WMV, H265, …, Unspecified } |
プロパティ
- audioCodec : AudioCodec
- fileFormat : FileFormat
- videoCodec : VideoCodec
パブリック関数
| QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat) | |
| QMediaFormat(const QMediaFormat &other) | |
| QMediaFormat(QMediaFormat &&other) | |
| ~QMediaFormat() | |
| QMediaFormat::AudioCodec | audioCodec() const |
| QMediaFormat::FileFormat | fileFormat() const |
| bool | isSupported(QMediaFormat::ConversionMode mode) const |
| QMimeType | mimeType() const |
| void | resolveForEncoding(QMediaFormat::ResolveFlags flags) |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
| void | setFileFormat(QMediaFormat::FileFormat f) |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
| QList<QMediaFormat::AudioCodec> | supportedAudioCodecs(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::FileFormat> | supportedFileFormats(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::VideoCodec> | supportedVideoCodecs(QMediaFormat::ConversionMode m) |
| void | swap(QMediaFormat &other) |
| QMediaFormat::VideoCodec | videoCodec() const |
| bool | operator!=(const QMediaFormat &other) const |
| QMediaFormat & | operator=(QMediaFormat &&other) |
| QMediaFormat & | operator=(const QMediaFormat &other) |
| bool | operator==(const QMediaFormat &other) const |
静的パブリックメンバ
| QString | audioCodecDescription(QMediaFormat::AudioCodec codec) |
| QString | audioCodecName(QMediaFormat::AudioCodec codec) |
| QString | fileFormatDescription(QMediaFormat::FileFormat fileFormat) |
| QString | fileFormatName(QMediaFormat::FileFormat fileFormat) |
| QString | videoCodecDescription(QMediaFormat::VideoCodec codec) |
| QString | videoCodecName(QMediaFormat::VideoCodec codec) |
詳細説明
QMediaFormat は、マルチメディアファイルやストリームのエンコード形式を記述します。
QMediaFormat を使用して、特定のメディア形式をエンコードまたはデコードに使用できるかどうかを確認できます。
メンバ型ドキュメント
enum class QMediaFormat::AudioCodec
マルチメディアファイルまたはストリームで使用されるオーディオコーデックを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Windowsメディアオーディオ |
QMediaFormat::AudioCodec::AC3 | 2 | ドルビーデジタル |
QMediaFormat::AudioCodec::AAC | 1 | 高度なオーディオコーディング |
QMediaFormat::AudioCodec::ALAC | 10 | Apple ロスレス・オーディオ・コーデック |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | ドルビーTrueHD |
QMediaFormat::AudioCodec::EAC3 | 3 | ドルビーデジタルプラス（EAC3） |
QMediaFormat::AudioCodec::MP3 | 0 | MPEG-1オーディオ・レイヤーIIIまたはMPEG-2オーディオ・レイヤーIII |
QMediaFormat::AudioCodec::Wave | 8 | 波形オーディオファイル形式 |
QMediaFormat::AudioCodec::Vorbis | 7 | Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC | 4 | フリーのロスレス・オーディオ・コーデック |
QMediaFormat::AudioCodec::Opus | 6 | Opusオーディオ・フォーマット |
QMediaFormat::AudioCodec::Unspecified | -1 | 未指定のコーデック |
enum QMediaFormat::ConversionMode
多くの場合、システムは非対称的な能力を持ち、エンコード可能なフォーマットやコーデックよりも多くのフォーマットやコーデックをデコードできることが多い。この列挙型は、あるファイルフォーマットやコーデックがサポートされているかどうかをチェックするときに使われる、要求された変換モードを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::Encode | 0 | あるファイルフォーマットやコーデックがエンコード可能かどうかをチェックするために使用されます。 |
QMediaFormat::Decode | 1 | あるファイル形式またはコーデックがデコードできるかどうかをチェックするために使用される。 |
supportedFileFormats 、supportedAudioCodecs 、supportedVideoCodecsも参照 。
enum QMediaFormat::FileFormat
マルチメディアファイルやストリームで使用されるコンテナ形式を記述する。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::WMA | 9 | Windows Media Audio |
QMediaFormat::AAC | 8 | 高度なオーディオ符号化 |
QMediaFormat::Matroska | 2 | マトロスカ (MKV) |
QMediaFormat::WMV | 0 | Windowsメディア・ビデオ |
QMediaFormat::MP3 | 10 | MPEG-1オーディオ・レイヤーIIIまたはMPEG-2オーディオ・レイヤーIII |
QMediaFormat::Wave | 12 | 波形オーディオファイル形式 |
QMediaFormat::Ogg | 4 | Ogg |
QMediaFormat::MPEG4 | 3 | MPEG-4 |
QMediaFormat::AVI | 1 | オーディオビデオインターリーブ |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4パート3またはMPEG-4オーディオ（正式にはISO/IEC 14496-3） |
QMediaFormat::FLAC | 11 | フリーのロスレス・オーディオ・コーデック |
QMediaFormat::UnspecifiedFormat | -1 | フォーマットは指定されていません。 |
enum QMediaFormat::ResolveFlags
QMediaRecorder に適したフォーマットを解決するための要件を記述する。
| 定数 | 値 | 記述 |
|---|---|---|
QMediaFormat::NoFlags | 0 | 要件なし |
QMediaFormat::RequiresVideo | 1 | ビデオコーデックが必要 |
resolveForEncoding()も参照 。
enum class QMediaFormat::VideoCodec
マルチメディアファイルまたはストリームで使用されるビデオコード。
| 定数 | 値 | 記述 |
|---|---|---|
QMediaFormat::VideoCodec::VP8 | 5 | VP8 |
QMediaFormat::VideoCodec::MPEG2 | 1 | MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 | 0 | MPEG-1 |
QMediaFormat::VideoCodec::WMV | 9 | ウィンドウズ・メディア・ビデオ |
QMediaFormat::VideoCodec::H265 | 4 | 高効率ビデオコーディング（HEVC） |
QMediaFormat::VideoCodec::H264 | 3 | 高度なビデオコーディング |
QMediaFormat::VideoCodec::MPEG4 | 2 | MPEG-4 |
QMediaFormat::VideoCodec::AV1 | 7 | AOMediaビデオ1 |
QMediaFormat::VideoCodec::MotionJPEG | 10 | モーションJPEG |
QMediaFormat::VideoCodec::VP9 | 6 | VP9 |
QMediaFormat::VideoCodec::Theora | 8 | セオラ |
QMediaFormat::VideoCodec::Unspecified | -1 | ビデオコーデック指定なし |
プロパティのドキュメント
audioCodec : AudioCodec
このプロパティは、メディアのオーディオコーデックを保持する。
アクセス関数：
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
fileFormat : FileFormat
このプロパティは、メディアのファイル（コンテナ）フォーマットを保持する。
アクセス関数：
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
videoCodec : VideoCodec
このプロパティは、メディアのビデオコーデックを保持する。
アクセス関数：
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
メンバ関数ドキュメント
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
format 用の QMediaFormat オブジェクトを構築する。
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
other からコピーして QMediaFormat オブジェクトを構築する。
[noexcept] QMediaFormat::QMediaFormat(QMediaFormat &&other)
other から移動して QMediaFormat オブジェクトを構築します。
[noexcept] QMediaFormat::~QMediaFormat()
QMediaFormat オブジェクトを破棄する。
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
このフォーマットで使用されている音声コーデックを返す。
注： プロパティ audioCodec のゲッター関数。
setAudioCodec() およびQMediaFormat::AudioCodecも参照 。
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
codec の説明を返す。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
codec の文字列ベースの名前を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
fileFormat の説明を返す。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
fileFormat の文字列ベースの名前を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QMediaFormat::isSupported(QMediaFormat::ConversionMode mode) const
Qt Multimedia がこのフォーマットをエンコードまたはデコードできる場合、mode に応じてtrue を返す。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMimeType QMediaFormat::mimeType() const
このメディアフォーマットで使用されているファイルフォーマットのMIME タイプを返します。
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
flags に基づく書式を、QMediaRecorder がサポートする書式に解決する。
このメソッドは、未指定の設定に対して可能な限り最良の一致を見つけようとします。レコーダーがサポートしていない設定は、サポートされている最も近い一致に修正される。
解決に際しては、以下の順序で優先順位が与えられます：
- ファイル形式
- ビデオコーデック
- 音声コーデック
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
オーディオコーデックをcodec に設定する。
注： audioCodec プロパティのセッター関数。
audioCodec() およびQMediaFormat::AudioCodecも参照 。
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
ビデオコーデックをcodec に設定する。
注: プロパティvideoCodec のセッター関数。
videoCodec() およびQMediaFormat::VideoCodecも参照 。
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
選択したファイル形式とビデオコーデック (m) に対応するオーディオコーデックのリストを返す。
サポートされているすべてのオーディオコーデックを取得するには、デフォルトで構築されたQMediaFormat に対してこのクエリを実行してください。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMediaFormat::ConversionModeも参照して ください。
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
m で示されるオーディオおよびビデオコーデックに対応するファイル形式のリストを返す。
サポートされているすべてのファイル形式を取得するには、デフォルトで構築されたQMediaFormat に対してこのクエリを実行してください。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMediaFormat::ConversionModeも参照して ください。
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
選択したファイル形式と音声コーデック (m) に対応する動画コーデックの一覧を返します。
サポートされているすべてのビデオコーデックを取得するには、デフォルトで構築された MediaFormat に対してこのクエリを実行してください。
注意: この関数は、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照。
QMediaFormat::ConversionModeも参照して ください。
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
メディアフォーマットをother と入れ替える。
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
このフォーマットで使用されているビデオコーデックを返す。
注： プロパティ videoCodec のゲッター関数。
setVideoCodec() およびQMediaFormat::VideoCodecも参照 。
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
codec の説明を返す。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
codec の文字列ベースの名前を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
bool QMediaFormat::operator!=(const QMediaFormat &other) const
other が現在のメディアフォーマットと等しくない場合はtrue を返し、そうでない場合はfalse を返す。
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
other をこのQMediaFormat オブジェクトに移動する。
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
other をこのQMediaFormat オブジェクトにコピーする。
bool QMediaFormat::operator==(const QMediaFormat &other) const
other が現在のメディアフォーマットと等しい場合は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.
