Qt Multimedia Backend GStreamer
Cette page couvre les limitations du backend GStreamer de Qt Multimedia.
Limites et problèmes connus
GStreamer n'est pas fourni avec Qt, mais il est généralement déployé avec la distribution Linux.
- Certains bogues peuvent être dus à la version de GStreamer utilisée. Nous recommandons d'utiliser la dernière version de GStreamer qui corrige les bogues sur votre plateforme.
- Certains bogues peuvent également être liés aux bibliothèques utilisées par GStreamer, comme Pulseaudio. Pulseaudio v16 a notamment un bogue connu qui provoque le blocage du pipeline GStreamer et nécessite des rétro-portages de ces deux correctifs :
- https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/745
- https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/764
Ce bogue affecte actuellement la plupart des distributions Linux grand public, y compris Ubuntu 22.04, 23.10 et 24.04, Debian 11 et 12, ainsi que Fedora 39 et 40.
- Les bogues connus concernent la recherche, les taux de lecture, la boucle et les puits de commutation.
- Les fonctionnalités audio nécessitent PulseAudio. Voir les notes relatives à la plate-forme Linux pour plus de détails.
Points de personnalisation
Qt Multimedia fournit certains points de personnalisation pour permettre l'accès au pipeline GStreamer sous-jacent. Ces points de personnalisation sont considérés comme des API privées et peuvent faire l'objet de modifications. Le point d'entrée est class QGStreamerPlatformSpecificInterface.
Accès brut au pipeline
Il est possible d'accéder à GstPipeline qui sous-tend QMediaPlayer et QMediaCaptureSession.
Attention : Il s'agit d'une API non sécurisée, car le pipeline est toujours géré par l'implémentation de Qt. Il convient d'être très prudent lors de l'utilisation de cette API.
#include <QtMultimedia/private/qgstreamer_platformspecificinterface_p.h> [...] QMediaMediaPlayer player; GstPipeline *pipeline = QGStreamerPlatformSpecificInterface::instance()->gstPipeline(&player); [...] QMediaCaptureSession session; GstPipeline *pipeline = QGSreamerPlatformSpecificInterface::instance()->gstPipeline(&session);
Éléments GStreamer personnalisés en tant que sources et puits
Il est possible de créer des éléments GStreamer à partir de la description d'un pipeline GStreamer et de les envelopper dans un QCamera ou un QAudioDevice:
#include <QtMultimedia/private/qgstreamer_platformspecificinterface_p.h> [...] QByteArray pipelineString = "videotestsrc is-live=true ! gamma gamma=2.0"; QMediaCaptureSession session; session.setVideoSink(wid.videoSink()); QCamera *cam = QGStreamerPlatformSpecificInterface::instance()->makeCustomGStreamerCamera( pipelineString, &session); session.setCamera(cam);
QMediaPlayer : sources personnalisées
Le site QMediaPlayer accepte une description de pipeline GStreamer comme URI source :
QMediaPlayer player; player.setSource(u"gstreamer-pipeline: videotestsrc name=testsrc"_s);
Il essaiera de compiler la description du pipeline pour l'utiliser comme source dans le QMediaPlayer et sera automatiquement connecté aux puits du QMediaPlayer.
Avertissement : Hic sunt dracones ! Les pipelines personnalisés sont une fonctionnalité expérimentale : les pipelines personnalisés ne correspondent pas bien aux API de QMediaPlayer, notamment l'état des médias, les API de métadonnées et l'état du transport. La plupart des appels seront directement liés au pipeline GStreamer, ce qui peut conduire à un comportement indéfini en fonction du pipeline. Dans la plupart des cas, le site gstreamer-pipeline: n'est pas le bon choix pour le code de l'application : pour les sources vidéo arbitraires, le site QMediaCaptureSession avec une caméra personnalisée (voir ci-dessus) est le meilleur choix. Pour les pipelines arbitrairement complexes qui veulent seulement dessiner dans une interface graphique Qt/QML, qml6glsink de GStreamer (voir ci-dessous) peut être un choix plus robuste.
Considérations architecturales.
Qt Multimedia GStreamer n'est pas un framework de streaming généraliste et n'est pas nécessairement la meilleure façon d'utiliser GStreamer avec Qt sur le plan architectural. Les développeurs qui ont besoin d'un haut degré de contrôle sur le pipeline GStreamer, mais qui veulent seulement montrer la sortie vidéo Qt, peuvent envisager d'utiliser qml6glsink de GStreamer.
© 2025 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.