このページでは

mediaFormat QML Value Type

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

Import Statement: import QtMultimedia

プロパティ

方法

詳細な説明

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

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

プロパティ値説明
MediaFormat.WMAWindows Media Audio
MediaFormat.AC3ドルビーデジタル
MediaFormat.AACAdvanced Audio Coding
MediaFormat.ALACApple Lossless Audio Codec
MediaFormat.DolbyTrueHDドルビー・トゥルーHD
MediaFormat.EAC3ドルビー・デジタル・プラス (EAC3)
MediaFormat.MP3MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III
MediaFormat.WaveWaveform Audio File Format
MediaFormat.VorbisOgg Vorbis
MediaFormat.FLACFree Lossless Audio Codec
MediaFormat.OpusOpus オーディオ形式
MediaFormat.Unspecified未指定のコーデック

fileFormat : enumeration

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

プロパティ値説明
MediaFormat.WMAWindows Media Audio
MediaFormat.AACAdvanced Audio Coding
MediaFormat.MatroskaMatroska (MKV)
MediaFormat.WMVWindows Media Video
MediaFormat.MP3MPEG-1 オーディオレイヤー III または MPEG-2 オーディオレイヤー III
MediaFormat.WaveWaveform Audio File Format
MediaFormat.OggOgg
MediaFormat.MPEG4MPEG-4
MediaFormat.AVIオーディオ・ビデオ・インターリーブ
MediaFormat.QuickTimeQuickTime
MediaFormat.WebMWebM
MediaFormat.Mpeg4AudioMPEG-4 Part 3 または MPEG-4 オーディオ(正式名称:ISO/IEC 14496-3)
MediaFormat.FLACFree Lossless Audio Codec
MediaFormat.UnspecifiedFormatフォーマットは指定されていません。

videoCodec : enumeration

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

プロパティ値説明
MediaFormat.VP8VP8
MediaFormat.MPEG2MPEG-2
MediaFormat.MPEG1MPEG-1
MediaFormat.WMVWindows Media Video
MediaFormat.H265高効率映像符号化 (HEVC)
MediaFormat.H264高度映像符号化
MediaFormat.MPEG4MPEG-4
MediaFormat.AV1AOMedia Video 1
MediaFormat.MotionJPEGMotionJPEG
MediaFormat.VP9VP9
MediaFormat.TheoraTheora
MediaFormat.Unspecifiedビデオコーデックが指定されていません

メソッドのドキュメント

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.