このページでは

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 }

プロパティ

パブリック関数

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::WMA9Windows Media Audio
QMediaFormat::AudioCodec::AC32ドルビーデジタル
QMediaFormat::AudioCodec::AAC1Advanced Audio Coding
QMediaFormat::AudioCodec::ALAC10Apple Lossless Audio Codec
QMediaFormat::AudioCodec::DolbyTrueHD5ドルビーTrueHD
QMediaFormat::AudioCodec::EAC33ドルビー・デジタル・プラス (EAC3)
QMediaFormat::AudioCodec::MP30MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III
QMediaFormat::AudioCodec::Wave8Waveform Audio File Format
QMediaFormat::AudioCodec::Vorbis7Ogg Vorbis
QMediaFormat::AudioCodec::FLAC4Free Lossless Audio Codec
QMediaFormat::AudioCodec::Opus6Opus オーディオ形式
QMediaFormat::AudioCodec::Unspecified-1未指定のコーデック

enum QMediaFormat::ConversionMode

多くの場合、システムには非対称な機能があり、エンコードできる形式やコーデックよりも多くの形式やコーデックをデコードできることがよくあります。この列挙型は、特定のファイル形式やコーデックがサポートされているかどうかを確認する際に使用する、要求された変換モードを表します。

定数値説明
QMediaFormat::Encode0特定のファイル形式またはコーデックをエンコードできるかどうかを確認するために使用されます。
QMediaFormat::Decode1特定のファイル形式やコーデックをデコードできるかどうかを確認するために使用されます。

supportedFileFormats 、supportedAudioCodecs 、およびsupportedVideoCodecsも参照してください 。

enum QMediaFormat::FileFormat

マルチメディアファイルまたはストリームで使用されるコンテナ形式について説明します。

定数値説明
QMediaFormat::WMA9Windows Media Audio
QMediaFormat::AAC8Advanced Audio Coding
QMediaFormat::Matroska2Matroska (MKV)
QMediaFormat::WMV0Windows Media Video
QMediaFormat::MP310MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III
QMediaFormat::Wave12Waveform Audio File Format
QMediaFormat::Ogg4Ogg
QMediaFormat::MPEG43MPEG-4
QMediaFormat::AVI1オーディオ・ビデオ・インターリーブ
QMediaFormat::QuickTime5QuickTime
QMediaFormat::WebM6WebM
QMediaFormat::Mpeg4Audio7MPEG-4 Part 3 または MPEG-4 Audio(正式名称:ISO/IEC 14496-3)
QMediaFormat::FLAC11Free Lossless Audio Codec
QMediaFormat::UnspecifiedFormat-1このフォーマットは未指定です。

enum QMediaFormat::ResolveFlags

QMediaRecorder に対して適切なフォーマットを決定するための要件について説明します。

定数値説明
QMediaFormat::NoFlags0要件なし
QMediaFormat::RequiresVideo1ビデオコーデックが必要です

関連項目: resolveForEncoding()。

enum class QMediaFormat::VideoCodec

マルチメディアファイルまたはストリームで使用されるビデオコーデットについて説明します。

定数値説明
QMediaFormat::VideoCodec::VP85VP8
QMediaFormat::VideoCodec::MPEG21MPEG-2
QMediaFormat::VideoCodec::MPEG10MPEG-1
QMediaFormat::VideoCodec::WMV9Windows Media Video
QMediaFormat::VideoCodec::H2654高効率ビデオ符号化 (HEVC)
QMediaFormat::VideoCodec::H2643高度映像符号化
QMediaFormat::VideoCodec::MPEG42MPEG-4
QMediaFormat::VideoCodec::AV17AOMedia Video 1
QMediaFormat::VideoCodec::MotionJPEG10MotionJPEG
QMediaFormat::VideoCodec::VP96VP9
QMediaFormat::VideoCodec::Theora8Theora
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 でサポートされている形式に変換します。

このメソッドは、指定されていない設定について、可能な限り最適な設定を見つけようとします。レコーダーでサポートされていない設定は、サポートされている設定の中で最も近いものに変更されます。

変換を行う際、以下の順序で優先順位が付けられます:

  1. ファイル形式
  2. ビデオコーデック
  3. オーディオコーデック

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.