GStreamerVideoSource QML Type
Eine Videoquelle, die von einer benutzerdefinierten GStreamer-Binärdatei unterstützt wird. Mehr...
| Import Statement: | import QtMultimedia |
| In C++: | QGStreamerVideoSource |
Eigenschaften
- active : bool
- gstBinDescription : string
Methoden
Ausführliche Beschreibung
Erstellen Sie die Videoquelle anhand einer GStreamer-Bin-Beschreibung und fügen Sie sie mithilfe der Eigenschaft „ nativeVideoSource “ an „ CaptureSession “ an.
In allen Standardfällen empfehlen wir die Verwendung von ` Camera ` anstelle dieses Typs, es sei denn, Sie benötigen eine GStreamer-spezifische Konfiguration zur Verarbeitung einer benutzerdefinierten Videoquelle.
Standardmäßig ist der Typ nur in meta-qt6-Builds verfügbar. In benutzerdefinierten Builds mit GStreamer-Unterstützung kann die Funktion „ gstreamer_qt_api “ ihn aktivieren.
QtMultimedia Damit diese Klasse funktioniert, muss sie mit dem Medien-Backend „ gstreamer “ ausgeführt werden.
Item {
CaptureSession {
nativeVideoSource: GStreamerVideoSource {
gstElementDescription: "videotestsrc name=testsrc"
active: true
}
videoOutput: preview
}
VideoOutput {
id: preview
}
}Siehe auch „ CaptureSession “ und „ Camera “.
Dokumentation zu den Eigenschaften
active : bool
Gibt an, ob die Videoquelle derzeit aktiv ist.
Wenn die Videoquelle mit einem „ CaptureSession “ verbunden wurde, gibt diese Eigenschaft an, ob die zugrunde liegende „ GstElement “ im Rahmen der Medienaufzeichnungssitzung mit dem „ GstPipeline “ verbunden ist.
gstBinDescription : string [read-only]
Beschreibt die GStreamer-Bin-Beschreibung, die der Videoquelle zugeordnet ist.
In QML ist diese Eigenschaft erforderlich.
Das GStreamer-Backend interpretiert die Beschreibung und erstellt einen Bin, der als Videoquelle für eine Aufnahmesitzung dienen kann.
Informationen zur Syntax der Beschreibungszeichenfolge finden Sie in der GStreamer-Dokumentation.
Ist die angegebene Beschreibung ungültig, sodass kein Bin erstellt werden kann, ist das erstellte „ GStreamerVideoSource “ nicht funktionsfähig, und die Eigenschaft gibt eine leere Zeichenkette zurück.
Hinweis: „ GStreamerVideoSource “ führt keine zusätzliche Validierung der bereitgestellten Bin-Beschreibung durch. Wenn das erstellte „ GstBin “ also keinen Videoeingang für „ GstPipeline “ darstellt, können „ GStreamerVideoSource “ und die zugehörige „ CaptureSession “ möglicherweise nicht ordnungsgemäß funktionieren.
Methodendokumentation
void start()
Startet die Videoquelle.
Entspricht der Einstellung der Eigenschaft „ active “ auf „ true “.
void stop()
Hält die Videoquelle an.
Dies entspricht der Einstellung der Eigenschaft „ active “ auf „ false “.
© 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.