mediaFormat QML Value Type

MediaFormat beschreibt das Format einer Mediendatei. Mehr...

Import Statement: import QtMultimedia

Eigenschaften

Methoden

Detaillierte Beschreibung

Der Typ MediaFormat beschreibt das Format einer Mediendatei. Er enthält drei Eigenschaften, die den Dateityp und die verwendeten Audio- und Videocodecs beschreiben.

MediaFormat kann verwendet werden, um den Dateityp anzugeben, der von einem MediaRecorder erstellt werden soll. Der folgende Ausschnitt zeigt ein Beispiel, das den Rekorder so einrichtet, dass er ein mpeg4-Video mit AAC-kodiertem Audio und H265-Video erstellt:

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

Wenn das angegebene mediaFormat nicht unterstützt wird, versucht MediaRecorder automatisch, das bestmögliche Ersatzformat zu finden und dieses zu verwenden.

Siehe auch MediaRecorder und CaptureSession.

Eigenschaft Dokumentation

audioCodec : enumeration

Beschreibt den in der Multimediadatei oder dem Stream verwendeten Audiocodec. Sie kann einen der folgenden Werte annehmen:

Eigenschaft WertBeschreibung
MediaFormat.WMAWindows Media Audio
MediaFormat.AC3Dolby Digital
MedienFormat.AACErweiterte Audiocodierung
MedienFormat.ALACApple Lossless Audio Codec
MedienFormat.DolbyTrueHDDolby TrueHD
MedienFormat.EAC3Dolby Digital Plus (EAC3)
MedienFormat.MP3MPEG-1 Audio Layer III oder MPEG-2 Audio Layer III
MedienFormat.WaveWaveform Audio Dateiformat
MedienFormat.VorbisOgg Vorbis
MedienFormat.FLACFreier verlustfreier Audio Codec
MedienFormat.OpusOpus Audio Format
MediaFormat.UnspecifiedNicht spezifizierter Codec

fileFormat : enumeration

Beschreibt das in einer Multimediadatei oder einem Stream verwendete Containerformat. Es kann einen der folgenden Werte annehmen:

EigenschaftswertBeschreibung
MediaFormat.WMAWindows Media Audio
MediaFormat.AACErweiterte Audiocodierung
MedienFormat.MatroskaMatroska (MKV)
MedienFormat.WMVWindows Media Video
MedienFormat.MP3MPEG-1 Audio Layer III oder MPEG-2 Audio Layer III
MedienFormat.WaveWaveform Audio Dateiformat
MedienFormat.OggOgg
MedienFormat.MPEG4MPEG-4
MedienFormat.AVIAudio Video Interleave
MedienFormat.QuickTimeQuickTime
MedienFormat.WebMWebM
MedienFormat.Mpeg4AudioMPEG-4 Teil 3 oder MPEG-4 Audio (formell ISO/IEC 14496-3)
MedienFormat.FLACFreier verlustfreier Audiocodec
MediaFormat.UnspecifiedFormatDas Format ist nicht spezifiziert.

videoCodec : enumeration

Beschreibt den in der Multimediadatei oder dem Stream verwendeten Videocodec. Er kann einen der folgenden Werte annehmen:

EigenschaftswertBeschreibung
MediaFormat.VP8VP8
MediaFormat.MPEG2MPEG-2
MedienFormat.MPEG1MPEG-1
MedienFormat.WMVWindows Media Video
MedienFormat.H265Hocheffiziente Videokodierung (HEVC)
MedienFormat.H264Erweiterte Videokodierung
MedienFormat.MPEG4MPEG-4
MedienFormat.AV1AOMedia Video 1
MedienFormat.MotionJPEGMotionJPEG
MedienFormat.VP9VP9
MedienFormat.TheoraTheora
MediaFormat.UnspecifiedVideo-Codec nicht angegeben

Dokumentation der Methode

string audioCodecDescription(codec)

Gibt eine Beschreibung für codec zurück.


string audioCodecName(codec)

Gibt einen stringbasierten Namen für codec zurück.


string fileFormatDescription(fileFormat)

Gibt eine Beschreibung für fileFormat zurück.


string fileFormatName(fileFormat)

Gibt einen stringbasierten Namen für fileFormat zurück.


list<AudioCodec> supportedAudioFormats(conversionMode)

Gibt eine Liste von Audio-Codecs für das gewählte Dateiformat und den Video-Codec (conversionMode) zurück.

Um alle unterstützten Audiocodecs zu erhalten, führen Sie diese Abfrage für ein standardmäßig konstruiertes MediaFormat aus. Um eine Liste der unterstützten Audiocodecs für eine bestimmte Kombination aus einem Dateiformat und einem Videocodec zu erhalten, können Sie die Eigenschaften fileFormat und videoCodec festlegen, bevor Sie diese Abfrage ausführen.

Siehe auch QMediaFormat::ConversionMode.


list<FileFormat> supportedFileFormats(conversionMode)

Gibt eine Liste von Dateiformaten für den durch conversionMode angegebenen Audio- und Videocodec zurück.

Um alle unterstützten Dateiformate zu erhalten, führen Sie diese Abfrage für ein standardmäßig konstruiertes MediaFormat aus. Um eine Liste von Dateiformaten zu erhalten, die eine bestimmte Kombination von Audio- und Videocodec unterstützen, können Sie die Eigenschaften audioCodec und videoCodec festlegen, bevor Sie diese Abfrage ausführen.

Siehe auch QMediaFormat::ConversionMode.


list<VideoCodec> supportedVideoCodecs(conversionMode)

Gibt eine Liste von Video-Codecs für das gewählte Dateiformat und den Audio-Codec zurück (conversionMode).

Um alle unterstützten Videocodecs zu erhalten, führen Sie diese Abfrage für ein standardmäßig konstruiertes MediaFormat aus. Um eine Liste der unterstützten Videocodecs für eine bestimmte Kombination aus einem Dateiformat und einem Audiocodec zu erhalten, können Sie die Eigenschaften fileFormat und audioCodec festlegen, bevor Sie diese Abfrage ausführen.

Siehe auch QMediaFormat::ConversionMode.


string videoCodecDescription(codec)

Gibt eine Beschreibung für codec zurück.


string videoCodecName(codec)

Gibt einen stringbasierten Namen für codec zurück.


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