Sur cette page

GStreamerVideoSource QML Type

Une source vidéo prise en charge par un binaire GStreamer personnalisé. En savoir plus…

Import Statement: import QtMultimedia
In C++: QGStreamerVideoSource

Propriétés

Méthodes

Description détaillée

Construisez la source vidéo à partir d'une description de fichier binaire GStreamer et associez-la à CaptureSession à l'aide de sa propriété nativeVideoSource.

Dans tous les cas standard, nous recommandons d’utiliser ` Camera ` plutôt que ce type, sauf si vous avez besoin d’une configuration spécifique à GStreamer pour gérer une source vidéo personnalisée.

Par défaut, ce type n’est disponible que dans les versions meta-qt6. Dans les versions personnalisées prenant en charge GStreamer, la fonctionnalité « gstreamer_qt_api » permet de l’activer.

QtMultimedia Pour que cette classe fonctionne, il faut l’exécuter avec le backend multimédia « gstreamer ».

Item {
    CaptureSession {
        nativeVideoSource: GStreamerVideoSource {
            gstElementDescription: "videotestsrc name=testsrc"
            active: true
        }
        videoOutput: preview
    }

    VideoOutput {
        id: preview
    }
}

Voir également CaptureSession et Camera.

Documentation des propriétés

active : bool

Indique si la source vidéo est actuellement active.

Si la source vidéo a été connectée à un « CaptureSession », cette propriété indique si l'GstElement sous-jacente est associée à l’« GstPipeline » au sein de la session de capture multimédia.

gstBinDescription : string [read-only]

Décrit la description du fichier binaire GStreamer associée à la source vidéo.

En QML, cette propriété est obligatoire.

Le backend GStreamer interprète la description et crée un bin pouvant servir de source vidéo pour une session de capture.

Consultez la documentation de GStreamer pour connaître la syntaxe de la chaîne de description.

Si la description spécifiée n'est pas valide, empêchant ainsi la création d'un « bin », l'GStreamerVideoSource ainsi construit est inopérant et la propriété renvoie une chaîne vide.

Remarque : ` GStreamerVideoSource ` n’effectue aucune validation supplémentaire de la description du « bin » fournie ; par conséquent, si l’ GstBin créé ne correspond pas à une entrée vidéo pour ` GstPipeline`, ` GStreamerVideoSource ` et la méthode associée ` CaptureSession ` peuvent ne pas fonctionner correctement.

Documentation de la méthode

void start()

Lance la source vidéo.

Cela revient à définir la propriété « active » sur « true ».

void stop()

Arrête la source vidéo.

Cela revient à définir la propriété « active » sur « 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.