このページでは

mediaFormat QML Value Type

MediaFormat はメディアファイルのフォーマットを記述します。詳細...

Import Statement: import QtMultimedia

プロパティ

方法

詳細説明

MediaFormat型はメディアファイルのフォーマットを記述する。MediaFormatタイプは、メディアファイルの形式を記述します。MediaFormatタイプには、ファイルタイプ、使用されるオーディオコーデックとビデオコーデックを記述する3つのプロパティが含まれます。

MediaFormat は、MediaRecorder によって作成されるファイルのタイプを指定するために使用できます。以下のスニペットは、AAC エンコードされたオーディオと H265 ビデオを含む mpeg4 ビデオを作成するようにレコーダーを設定する例を示しています:

CaptureSession {
    ... // setup inputs
    MediaRecorder {
        mediaFormat {
            fileFormat: MediaFormat.MPEG4
            audioCodec: MediaFormat.AudioCodec.AAC
            videoCodec: MediaFormat.VideoCodec.H265
        }
    }
}

指定されたmediaFormatがサポートされていない場合、MediaRecorder は自動的に最適な代替フォーマットを見つけ、代わりにそれを使用しようとします。

MediaRecorder およびCaptureSessionも参照してください

プロパティ文書

audioCodec : enumeration

マルチメディアファイルまたはストリームで使用されるオーディオコーデックを記述する。以下のいずれかの値を取る:

プロパティ値説明
メディアフォーマット.WMAWindowsメディアオーディオ
メディアフォーマット.AC3ドルビーデジタル
メディアフォーマット.AAC高度なオーディオ符号化
メディアフォーマット.ALACアップルロスレスオーディオコーデック
メディアフォーマット.DolbyTrueHDドルビーTrueHD
メディアフォーマット.EAC3ドルビーデジタルプラス (EAC3)
メディアフォーマット.MP3MPEG-1オーディオ・レイヤーIIIまたはMPEG-2オーディオ・レイヤーIII
メディアフォーマット.Wave波形オーディオファイル形式
メディア形式.VorbisOgg Vorbis
メディア形式.FLACフリーのロスレス・オーディオ・コーデック
メディアフォーマット.OpusOpusオーディオフォーマット
メディアフォーマット.Unspecified未指定のコーデック

fileFormat : enumeration

マルチメディアファイルまたはストリームで使用されるコンテナ形式を記述する。以下のいずれかの値を取る:

プロパティ値説明
メディアフォーマット.WMAWindows Media Audio
メディアフォーマット.AAC高度なオーディオ符号化
メディアフォーマット.Matroskaマトロスカ (MKV)
メディアフォーマット.WMVウィンドウズ・メディア・ビデオ
メディアフォーマット.MP3MPEG-1オーディオレイヤーIIIまたはMPEG-2オーディオレイヤーIII
メディアフォーマット.Wave波形オーディオファイル形式
メディア形式.OggOgg
メディア形式.MPEG4MPEG-4
メディアフォーマット.AVIオーディオ・ビデオ・インターリーブ
メディアフォーマット.QuickTimeQuickTime
メディアフォーマット.WebMWebM
メディアフォーマット.Mpeg4AudioMPEG-4 Part 3 または MPEG-4 Audio (正式には ISO/IEC 14496-3)
メディアフォーマット.FLACフリーのロスレス・オーディオ・コーデック
メディアフォーマット.UnspecifiedFormatフォーマットは指定されていません。

videoCodec : enumeration

マルチメディアファイルまたはストリームで使用されるビデオコーデックを記述する。以下のいずれかの値をとる:

プロパティ値説明
メディアフォーマット.VP8VP8
メディアフォーマット.MPEG2MPEG-2
メディアフォーマット.MPEG1MPEG-1
メディアフォーマット.WMVウィンドウズメディアビデオ
メディアフォーマット.H265高効率ビデオ符号化 (HEVC)
メディアフォーマット.H264高度なビデオ符号化
メディアフォーマット.MPEG4MPEG-4
メディアフォーマット.AV1AOMediaビデオ1
メディアフォーマット.MotionJPEGモーションJPEG
メディアフォーマット.VP9VP9
メディアフォーマットテオラ
メディアフォーマット.指定なしビデオコーデックが指定されていない

メソッドのドキュメント

string audioCodecDescription(codec)

codec の説明を返す。

string audioCodecName(codec)

codec の文字列ベースの名前を返します。

string fileFormatDescription(fileFormat)

fileFormat の説明を返す。

string fileFormatName(fileFormat)

fileFormat の文字列ベースの名前を返します。

list<AudioCodec> supportedAudioFormats(conversionMode)

選択したファイル形式とビデオコーデック (conversionMode) に対応する音声コーデックのリストを返します。

サポートされているすべての音声コーデックを取得するには、デフォルトで構築されている MediaFormat に対してこのクエリを実行します。ファイル形式とビデオコーデックの特定の組み合わせに対してサポートされているオーディオコーデックのリストを取得するには、このクエリを実行する前にfileFormat およびvideoCodec プロパティを設定します。

QMediaFormat::ConversionModeも参照してください

list<FileFormat> supportedFileFormats(conversionMode)

conversionMode で示される音声コーデックおよび動画コーデックに対応するファイル形式のリストを返します。

サポートされているすべてのファイル形式を取得するには、デフォルトで構築された MediaFormat に対してこのクエリを実行します。音声コーデックと映像コーデックの特定の組み合わせをサポートするファイル形式の一覧を取得するには、このクエリを実行する前にaudioCodec プロパティとvideoCodec プロパティを設定します。

QMediaFormat::ConversionModeも参照してください

list<VideoCodec> supportedVideoCodecs(conversionMode)

選択したファイル形式と音声コーデック (conversionMode) に対応する動画コーデックの一覧を返します。

サポートされているすべての動画コーデックを取得するには、デフォルトで構築されている MediaFormat に対してこのクエリを実行します。ファイル形式と音声コーデックの特定の組み合わせに対してサポートされている動画コーデックの一覧を取得するには、このクエリを実行する前にfileFormat プロパティとaudioCodec プロパティを設定します。

QMediaFormat::ConversionModeも参照してください

string videoCodecDescription(codec)

codec の説明を返す。

string videoCodecName(codec)

codec の文字列ベースの名前を返します。

© 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.