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 Media Audio |
QMediaFormat::AudioCodec::AC3 | 2 | ドルビーデジタル |
QMediaFormat::AudioCodec::AAC | 1 | Advanced Audio Coding |
QMediaFormat::AudioCodec::ALAC | 10 | Apple Lossless Audio Codec |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | ドルビーTrueHD |
QMediaFormat::AudioCodec::EAC3 | 3 | ドルビー・デジタル・プラス (EAC3) |
QMediaFormat::AudioCodec::MP3 | 0 | MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III |
QMediaFormat::AudioCodec::Wave | 8 | Waveform Audio File Format |
QMediaFormat::AudioCodec::Vorbis | 7 | Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC | 4 | Free Lossless Audio Codec |
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 | Advanced Audio Coding |
QMediaFormat::Matroska | 2 | Matroska (MKV) |
QMediaFormat::WMV | 0 | Windows Media Video |
QMediaFormat::MP3 | 10 | MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III |
QMediaFormat::Wave | 12 | Waveform Audio File Format |
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 Part 3 または MPEG-4 Audio(正式名称:ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | Free Lossless Audio Codec |
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 | Windows Media Video |
QMediaFormat::VideoCodec::H265 | 4 | 高効率ビデオ符号化 (HEVC) |
QMediaFormat::VideoCodec::H264 | 3 | 高度映像符号化 |
QMediaFormat::VideoCodec::MPEG4 | 2 | MPEG-4 |
QMediaFormat::VideoCodec::AV1 | 7 | AOMedia Video 1 |
QMediaFormat::VideoCodec::MotionJPEG | 10 | MotionJPEG |
QMediaFormat::VideoCodec::VP9 | 6 | VP9 |
QMediaFormat::VideoCodec::Theora | 8 | Theora |
QMediaFormat::VideoCodec::Unspecified | -1 | ビデオコーデックが指定されていません |
プロパティのドキュメント
audioCodec : AudioCodec
このプロパティは、メディアのオーディオコーデックを保持します。
アクセス関数:
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
関連項目: QMediaFormat::AudioCodec 。
fileFormat : FileFormat
このプロパティは、メディアのファイル(コンテナ)形式を保持します。
アクセス関数:
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
関連項目: ` QMediaFormat::FileFormat`。
videoCodec : VideoCodec
このプロパティは、メディアのビデオコーデックを保持します。
アクセス関数:
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
関連項目: QMediaFormat::VideoCodec 。
メンバ関数のドキュメント
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
format 用の QMediaFormat オブジェクトを作成します。
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
other からコピーして、QMediaFormat オブジェクトを作成します。
[constexpr noexcept default] 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 を返します。
© 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.