QGStreamerInterface Class
Proporciona puntos de integración específicos de GStreamer para Qt Multimedia. Más información...
| Encabezado: | #include <QGStreamerInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Desde: | Qt 6.12 |
Funciones públicas
| virtual | ~QGStreamerInterface() |
| virtual QVideoFrame | createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfo &videoInfo) = 0 |
| virtual QVideoFrame | createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfoDmaDrm &videoInfo) = 0 |
| virtual GstBuffer * | gstBuffer(const QVideoFrame &frame) = 0 |
| virtual GstPipeline * | gstPipeline(QMediaCaptureSession *session) = 0 |
| virtual GstPipeline * | gstPipeline(QMediaPlayer *player) = 0 |
| virtual QAudioDevice | makeCustomGStreamerAudioInput(const QByteArray &gstreamerPipeline) = 0 |
| virtual QAudioDevice | makeCustomGStreamerAudioOutput(const QByteArray &gstreamerPipeline) = 0 |
Miembros públicos estáticos
| QGStreamerInterface * | instance() |
Descripción detallada
Advertencia: La clase QGStreamerInterface ofrece garantías de compatibilidad limitadas. No hay garantías de compatibilidad ni a nivel de código fuente ni de binarios para esta API, lo que significa que solo se garantiza su funcionamiento con la versión de Qt con la que se ha desarrollado la aplicación. Se pretende reducir al mínimo los cambios incompatibles, que solo se realizarán en versiones menores.
Para utilizar esta clase en una aplicación, enlaza con Qt::MultimediaPrivate (si utilizas CMake) e incluye el encabezado #include <QtMultimedia/spi/qgstreamerinterface.h>.
QVideoFrame QGStreamerInterface es el punto de entrada para personalizar el backend de GStreamer: envolver elementos de pipeline personalizados como dispositivos de audio y vídeo de Qt, acceder a la GstPipeline subyacente de los objetos de alto nivel de Qt y realizar conversiones entre y los búferes de GStreamer.
De forma predeterminada, 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 Debe ejecutarse con el backend multimedia « gstreamer » para obtener una instancia válida de la clase.
Documentación de las funciones miembro
[virtual noexcept] QGStreamerInterface::~QGStreamerInterface()
Destruye la interfaz.
[pure virtual] QVideoFrame QGStreamerInterface::createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfo &videoInfo)
Crea un objeto ` QVideoFrame ` que envuelve un objeto ` buffer ` utilizando el formato descrito en videoInfo.
El marco creado comparte la propiedad del GstBuffer especificado con el llamante.
Véase también createFrameFromGstBuffer(GstBuffer *, const GstVideoInfoDmaDrm &) y gstBuffer().
[pure virtual] QVideoFrame QGStreamerInterface::createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfoDmaDrm &videoInfo)
Crea un objeto « QVideoFrame » que envuelve un objeto « buffer » respaldado por DMA-BUF, utilizando el formato descrito en videoInfo.
Requiere GStreamer 1.24 o posterior con soporte para el formato de vídeo DMA-BUF. Si no es compatible, devuelve un ` QVideoFrame ` no válido y registra una advertencia.
El fotograma creado comparte la propiedad del GstBuffer especificado con el llamante.
Véanse también createFrameFromGstBuffer(GstBuffer *, const GstVideoInfo &) y gstBuffer().
[pure virtual] GstBuffer *QGStreamerInterface::gstBuffer(const QVideoFrame &frame)
Devuelve el búfer de GStreamer que respalda frame, o nullptr si frame no contiene memoria de vídeo respaldada por GStreamer.
La propiedad del búfer devuelto no se transfiere.
Véase también createFrameFromGstBuffer().
[pure virtual] GstPipeline *QGStreamerInterface::gstPipeline(QMediaCaptureSession *session)
Devuelve el canal de GStreamer subyacente para session, o nullptr si session no está respaldado por el backend multimedia de GStreamer.
Advertencia: La canalización sigue siendo propiedad de Qt Multimedia y está controlada por ella. Modificar su estado o topología sin coordinarse con la sesión de captura puede provocar un comportamiento indefinido.
Véase también QMediaCaptureSession.
[pure virtual] GstPipeline *QGStreamerInterface::gstPipeline(QMediaPlayer *player)
Devuelve el canal de GStreamer subyacente para player, o nullptr si player no está respaldado por el backend multimedia de GStreamer.
Advertencia: El canal sigue siendo propiedad de Qt Multimedia y está controlado por este. Modificar su estado o topología sin coordinarse con QMediaPlayer puede provocar un comportamiento indefinido.
Véase también QMediaPlayer.
[static] QGStreamerInterface *QGStreamerInterface::instance()
Devuelve la interfaz de GStreamer correspondiente al backend « Qt Multimedia » activo, o « nullptr » si el backend de GStreamer no está en uso.
[pure virtual] QAudioDevice QGStreamerInterface::makeCustomGStreamerAudioInput(const QByteArray &gstreamerPipeline)
Crea un dispositivo de entrada de audio personalizado a partir de una descripción de canalización de GStreamer.
La cadena « gstreamerPipeline » se analiza como una descripción bin de GStreamer. Los elementos resultantes se conectan como fuente de audio de un « QMediaCaptureSession » cuando el objeto « QAudioDevice » devuelto se pasa a « QAudioInput » y se le asigna mediante « QMediaCaptureSession::setAudioInput()».
Los nombres de los elementos de la descripción pueden utilizarse para localizar nodos en la canalización de la sesión mediante gst_bin_get_by_name() una vez que la sesión de captura esté activa.
#include <QtMultimedia/spi/qgstreamerinterface.h>
QMediaCaptureSession session;
QAudioInput input{
QGStreamerInterface::instance()->makeCustomGStreamerAudioInput(
"audiotestsrc wave=2 freq=200 ! identity name=myConverter") };
session.setAudioInput(&input);Véase también makeCustomGStreamerAudioOutput(), QAudioInput y QMediaCaptureSession.
[pure virtual] QAudioDevice QGStreamerInterface::makeCustomGStreamerAudioOutput(const QByteArray &gstreamerPipeline)
Crea un dispositivo de salida de audio personalizado a partir de una descripción de canalización de GStreamer.
La cadena « gstreamerPipeline » se analiza como una descripción bin de GStreamer. Los elementos resultantes se conectan como el sumidero de audio de un « QMediaCaptureSession » cuando el objeto « QAudioDevice » devuelto se pasa a « QAudioOutput » y se le asigna mediante « QMediaCaptureSession::setAudioOutput()».
Véase también makeCustomGStreamerAudioInput(), QAudioOutput y QMediaCaptureSession.
© 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.