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
- active : bool
- gstBinDescription : string
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.