En esta página

GStreamerVideoSource QML Type

Una fuente de vídeo respaldada por un binario personalizado de GStreamer. Más información...

Import Statement: import QtMultimedia
In C++: QGStreamerVideoSource

Propiedades

Métodos

Descripción detallada

Crea la fuente de vídeo a partir de una descripción bin de GStreamer y adjúntala a CaptureSession utilizando su propiedad nativeVideoSource.

En cualquier caso estándar, recomendamos utilizar « Camera » en lugar de este tipo, a menos que se necesite una configuración específica de GStreamer para gestionar cualquier fuente de vídeo personalizada.

Por defecto, este tipo solo está disponible en compilaciones meta-qt6. En compilaciones personalizadas con soporte para GStreamer, la función « gstreamer_qt_api » permite habilitarlo.

QtMultimedia Para que esta clase funcione, debe ejecutarse con el backend multimedia « gstreamer ».

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

    VideoOutput {
        id: preview
    }
}

Véase también CaptureSession y Camera.

Documentación de propiedades

active : bool

Indica si la fuente de vídeo está activa en este momento.

Si la fuente de vídeo se ha conectado a un « CaptureSession », esta propiedad indica si el « GstElement » subyacente está vinculado al « GstPipeline » dentro de la sesión de captura de medios.

gstBinDescription : string [read-only]

Describe la descripción del archivo bin de GStreamer asociada a la fuente de vídeo.

En QML, esta propiedad es obligatoria.

El backend de GStreamer interpreta la descripción y crea un «bin», que puede actuar como fuente de vídeo para una sesión de captura.

Consulta la documentación de GStreamer para conocer la sintaxis de la cadena de descripción.

Si la descripción especificada no es válida, lo que impide que se cree un bin, el GStreamerVideoSource construido no funciona y la propiedad devuelve una cadena vacía.

Nota: ` GStreamerVideoSource ` no realiza ninguna validación adicional de la descripción del bin proporcionada, por lo que, si el ` GstBin ` creado no representa una entrada de vídeo para ` GstPipeline`, ` GStreamerVideoSource ` y el ` CaptureSession ` asociado pueden comportarse de forma incorrecta.

Documentación del método

void start()

Inicia la fuente de vídeo.

Equivale a establecer la propiedad « active » en « true ».

void stop()

Detiene la fuente de vídeo.

Es lo mismo que establecer la propiedad « active » en « 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.