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 に対する文字列ベースの名前を返します。


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