mediaFormat QML Value Type

„MediaFormat“ beschreibt das Format einer Mediendatei. Mehr...

Eigenschaften

• audioCodec : enumeration
• fileFormat : enumeration
• videoCodec : enumeration

Methoden

• string audioCodecDescription(codec)
• string audioCodecName(codec)
• string fileFormatDescription(fileFormat)
• string fileFormatName(fileFormat)
• list<AudioCodec> supportedAudioFormats(conversionMode)
• list<FileFormat> supportedFileFormats(conversionMode)
• list<VideoCodec> supportedVideoCodecs(conversionMode)
• string videoCodecDescription(codec)
• string videoCodecName(codec)

Ausführliche Beschreibung

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

Mit „MediaFormat“ lässt sich der Dateityp festlegen, der von einem „ MediaRecorder “ erstellt werden soll. Der folgende Codeausschnitt zeigt ein Beispiel, in dem der Recorder so konfiguriert wird, dass er ein MPEG-4-Video mit AAC-kodiertem Audio und H.265-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 der „ MediaRecorder “ automatisch, das bestmögliche Ersatzformat zu finden und dieses stattdessen zu verwenden.

Siehe auch „ MediaRecorder “ und „ CaptureSession “.

Dokumentation zu den Eigenschaften

audioCodec : enumeration

Beschreibt den in einer Multimediadatei oder einem Stream verwendeten Audio-Codec. Er kann einen der folgenden Werte annehmen:

fileFormat : enumeration

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

videoCodec : enumeration

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

Methodendokumentation

string audioCodecDescription(codec)

Gibt eine Beschreibung für „ codec “ zurück.

string audioCodecName(codec)

Gibt einen als Zeichenfolge formatierten Namen für „ codec “ zurück.

string fileFormatDescription(fileFormat)

Gibt eine Beschreibung für „ fileFormat “ zurück.

string fileFormatName(fileFormat)

Gibt einen als Zeichenfolge dargestellten Namen für „ fileFormat “ zurück.

list<AudioCodec> supportedAudioFormats(conversionMode)

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

Um alle unterstützten Audio-Codecs abzurufen, führen Sie diese Abfrage für ein standardmäßig erstelltes `MediaFormat` aus. Um eine Liste der unterstützten Audio-Codecs für eine bestimmte Kombination aus Dateiformat und Video-Codec zu erhalten, können Sie vor der Ausführung dieser Abfrage die Eigenschaften ` fileFormat ` und ` videoCodec ` festlegen.

Siehe auch QMediaFormat::ConversionMode.

list<FileFormat> supportedFileFormats(conversionMode)

Gibt eine Liste der Dateiformate für den durch ` conversionMode` angegebenen Audio- und Video-Codec zurück.

Um alle unterstützten Dateiformate abzurufen, führen Sie diese Abfrage für ein standardmäßig erstelltes `MediaFormat` aus. Um eine Liste der Dateiformate zu erhalten, die eine bestimmte Kombination aus Audio- und Video-Codec unterstützen, können Sie vor der Ausführung dieser Abfrage die Eigenschaften ` audioCodec ` und ` videoCodec ` festlegen.

Siehe auch QMediaFormat::ConversionMode.

list<VideoCodec> supportedVideoCodecs(conversionMode)

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

Um alle unterstützten Videocodecs abzurufen, führen Sie diese Abfrage für ein standardmäßig erstelltes `MediaFormat` aus. Um eine Liste der unterstützten Videocodecs für eine bestimmte Kombination aus Dateiformat und Audiocodec zu erhalten, können Sie vor der Ausführung dieser Abfrage die Eigenschaften ` fileFormat ` und ` audioCodec ` festlegen.

Siehe auch „ QMediaFormat::ConversionMode “.

string videoCodecDescription(codec)

Gibt eine Beschreibung für „ codec “ zurück.

string videoCodecName(codec)

Gibt einen als Zeichenfolge formatierten Namen für „ codec “ zurück.