QGStreamerVideoSource Class
La clase QGStreamerVideoSource proporciona una fuente de vídeo basada en un elemento GStreamer personalizado. Más información...
| Encabezado: | #include <QGStreamerVideoSource> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Desde: | Qt 6.12 |
| En QML: | GStreamerVideoSource |
| Heredan de: | QObject |
Propiedades
- active : bool
- gstBinDescription : const QString
Funciones públicas
| QGStreamerVideoSource(GstElement *gstElement, QObject *parent = nullptr) | |
| QGStreamerVideoSource(const QString &gstBinDescription, QObject *parent = nullptr) | |
| QString | gstBinDescription() const |
| GstElement * | gstElement() const |
| bool | isActive() const |
Ranuras públicas
Señales
| void | activeChanged(bool active) |
Descripción detallada
Advertencia: La clase ` GStreamerVideoSource ` ofrece garantías de compatibilidad limitadas. No hay garantías de compatibilidad ni a nivel de código fuente ni de binarios para estas clases, lo que significa que solo se garantiza que la API funcione con la versión de Qt con la que se ha desarrollado la aplicación. No obstante, se pretende que los cambios incompatibles se reduzcan al mínimo y solo se realizarán en versiones menores. Para utilizar la clase en una aplicación, enlaza con Qt::MultimediaPrivate (si utilizas CMake) e incluye el encabezado #include <spi/qgstreamervideosource.h>.
Crea un objeto `QGStreamerVideoSource` a partir de una descripción bin de GStreamer o de un ` GstElement ` existente y conéctalo a ` QMediaCaptureSession ` mediante ` QMediaCaptureSession::setNativeVideoSource()`.
En cualquier caso estándar, recomendamos utilizar ` QCamera ` en lugar de esta clase, a menos que se necesite una configuración específica de GStreamer para gestionar cualquier fuente de vídeo personalizada.
Por defecto, la clase está disponible en las compilaciones meta-qt6. En compilaciones personalizadas con soporte para GStreamer, la función « gstreamer_qt_api » permite habilitarla.
QtMultimedia Para que esta clase funcione, debe ejecutarse con el backend multimedia gstreamer.
QMediaCaptureSession session;
QGStreamerVideoSource videoSource(QStringLiteral("videotestsrc name=testsrc"));
session.setNativeVideoSource(&videoSource);
videoSource.start();Véase también QMediaCaptureSession y QCamera.
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 « QMediaCaptureSession », esta propiedad indica si el « GstElement » subyacente está vinculado al « GstPipeline » dentro de la sesión de captura multimedia.
Funciones de acceso:
| bool | isActive() const |
| void | setActive(bool active) |
Señal de notificación:
| void | activeChanged(bool active) |
[read-only] gstBinDescription : const QString
Describe la descripción del archivo bin de GStreamer asociada a la fuente de vídeo.
Si la fuente de vídeo no funciona o se ha creado a partir de un « GstElement » ya existente, la cadena de la propiedad estará vacía.
Funciones de acceso:
| QString | gstBinDescription() const |
Documentación de las funciones miembro
[explicit] QGStreamerVideoSource::QGStreamerVideoSource(GstElement *gstElement, QObject *parent = nullptr)
Crea un objeto `QGStreamerVideoSource` a partir de un ` gstElement ` ya existente y un ` parent`.
El elemento debe proporcionar una fuente de vídeo que pueda utilizar una sesión de captura. El tipo ` GstElement ` se declara de forma anticipada en el encabezado ` QGStreamerVideoSource `, por lo que debe utilizarse el tipo correspondiente de la biblioteca GStreamer.
Si el elemento especificado es nulo, la fuente de vídeo creada no funcionará.
Nota: La clase no realiza ninguna validación adicional del elemento proporcionado, por lo que si el elemento especificado no representa una entrada de vídeo para GstPipeline, QGStreamerVideoSource y el QMediaCaptureSession asociado pueden comportarse de forma incorrecta.
Nota: `QGStreamerVideoSource ` comparte la propiedad del ` GstElement ` proporcionado con el llamante.
[explicit] QGStreamerVideoSource::QGStreamerVideoSource(const QString &gstBinDescription, QObject *parent = nullptr)
Crea un objeto `QGStreamerVideoSource` a partir de la descripción del bin de GStreamer ` gstBinDescription ` y un objeto ` parent`.
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. Utiliza el método gstElement() para acceder al bin creado.
Consulte la documentación de GStreamer para conocer la sintaxis de la cadena de descripción.
Si no es capaz de analizar la descripción especificada, lo que impide que se cree el GstBin, el objeto QGStreamerVideoSource creado no funcionará, gstElement() devolverá nullptr y gstBinDescription() devolverá una cadena vacía.
Nota: QGStreamerVideoSource no realiza ninguna validación adicional de la descripción bin proporcionada, por lo que, si el GstBin creado no representa una entrada de vídeo para GstPipeline, QGStreamerVideoSource y el QMediaCaptureSession asociado pueden comportarse de forma incorrecta.
Para un mejor control del elemento GStreamer subyacente, puedes crear QGStreamerVideoSource a partir de un GstElement ya existente.
Véase también gstElement() y gstBinDescription().
GstElement *QGStreamerVideoSource::gstElement() const
Devuelve el ` GstElement ` subyacente utilizado por la fuente de vídeo, o ` nullptr ` si la fuente de vídeo no funciona.
Si la fuente de vídeo se ha creado a partir de una descripción bin de GStreamer, el objeto ` GstElement ` devuelto se puede convertir en la subclase ` GstBin `.
Nota: El método no transfiere la propiedad del ` GstElement`.
[slot] void QGStreamerVideoSource::start()
Inicia la fuente de vídeo.
Equivale a establecer la propiedad « active » en « true ».
[slot] void QGStreamerVideoSource::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.