Qt Multimedia

Qt Multimedia est un module complémentaire qui fournit un riche ensemble de types QML et de classes C++ pour gérer le contenu multimédia. Il contient une API facile à utiliser pour lire des fichiers audio et vidéo et les afficher à l'écran, ainsi qu'une API complète pour l'enregistrement audio et vidéo à partir de diverses sources, y compris les caméras et les microphones du système, les captures d'écran ou de fenêtre, et les tampons de mémoire audio ou vidéo.

Les fonctionnalités de ce module sont réparties dans les sous-modules suivants :

Pour commencer

Si vous passez de Qt 5 à Qt 6, consultez les modifications apportées à Qt Multimedia.

Si vous n'avez jamais utilisé Qt Multimedia, les types QML peuvent être importés dans une application à l'aide de l'instruction suivante dans votre fichier .qml.

import QtMultimedia

Pour établir un lien avec les bibliothèques C++, ajoutez ce qui suit au fichier CMakeLists.txt de votre projet. Remplacez my_project par le nom de votre projet.

find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(my_project PRIVATE Qt6::Multimedia)

Voir Construire Qt Multimedia à partir des sources pour obtenir des conseils sur la construction de Qt Multimedia à partir des sources.

Aperçus et sujets importants

• Changements dans Qt 6
• Vue d'ensemble du multimédia
• Vue d'ensemble de l'audio
• Aperçu de l'audio spatial
• Vue d'ensemble de la vidéo
• Aperçu de la caméra
• Formats de médias pris en charge

Types de QML

Le tableau suivant présente quelques types de QML importants.

Classes C

Le tableau suivant présente quelques classes C++ importantes.

Pour la lecture de l'audio et de la vidéo, QMediaPlayer, QAudioOutput, et QVideoWidget contiennent toutes les fonctionnalités nécessaires. D'autres classes sont dédiées à la capture de contenu audio et vidéo, QMediaCaptureSession étant la classe centrale qui gère l'ensemble du processus de capture et d'enregistrement.

Licences et attributions

Le module Qt Multimedia est disponible sous licence commerciale auprès de The Qt Company. En outre, il est disponible sous des licences de logiciel libre. Depuis Qt 5.6, ces licences de logiciel libre sont la GNU Lesser General Public License, version 3, ou la GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.

En outre, Qt Multimedia dans Qt 6.11.0 peut contenir des modules tiers sous les licences permissives suivantes :

Notez que les normes de compression vidéo, telles que la norme de compression multimédia H.264, peuvent être couvertes par des brevets et donner lieu à des redevances. Cela peut s'appliquer à toute implémentation, même si l'implémentation est fournie en tant que service du système d'exploitation, par le biais d'une bibliothèque tierce ou de l'un des backends de Qt Multimedia. Les licences Qt ne couvrent pas ces frais.

Notes sur la plate-forme cible et le backend

Qt Multimedia Qt offre des API conviviales et multiplateformes pour la lecture, l'enregistrement et la gestion des appareils multimédias. La mise en œuvre des API de base, notamment QMediaDevices, QAudioDevice, QSoundEffect, QAudioSink et QAudioSource, est intégrée dans la bibliothèque principale Qt Multimedia, ce qui évite d'avoir recours à des bibliothèques supplémentaires. D'autres API de Qt Multimedia sont mises en œuvre à l'aide de bibliothèques d'extension connues sous le nom de "media backends". Le principal backend média, construit sur FFmpeg, garantit une fonctionnalité multiplateforme transparente et est la valeur par défaut sur toutes les plateformes, à l'exception de WebAssembly et de Linux/Boot2Qt embarqué. Avec Boot2Qt, le backend par défaut est construit au-dessus de GStreamer, mais le backend média FFmpeg peut être activé en utilisant la variable d'environnement QT_MEDIA_BACKEND.

Le backend FFmpeg

Le backend média FFmpeg s'appuie sur les bibliothèques FFmpeg 7.1.3, qui sont incluses dans le site Qt Online Installer et testées par les mainteneurs. Les paquets binaires de l'installateur en ligne utilisent la liaison dynamique avec FFmpeg. Par conséquent, les applications doivent soit intégrer les binaires FFmpeg dans leur programme d'installation, soit dépendre de l'installation de FFmpeg sur le système d'exploitation. Les bibliothèques FFmpeg sont automatiquement déployées à l'aide des outils de déploiement de Qt, comme décrit dans la documentation Déploiement des applications Qt, sauf pour Linux/X11. Les applications peuvent également déployer leur propre version de FFmpeg, sous forme de bibliothèques partagées ou statiques, à condition que la version majeure de FFmpeg corresponde à la version utilisée par Qt.

Bien que Qt Multimedia exploite le backend média FFmpeg sur la plupart des systèmes d'exploitation, des différences fonctionnelles ou visuelles spécifiques à la plate-forme peuvent apparaître entre les applications sur différentes plates-formes. FFmpeg n'offre pas une prise en charge identique des codecs et des formats sur toutes les plateformes, et les performances des fonctionnalités de Qt Multimedia peuvent dépendre d'une prise en charge matérielle qui n'est disponible que sur certaines plateformes. Par exemple, FFmpeg rencontre des problèmes spécifiques avec l'accélération matérielle sur les cibles Linux avec des architectures ARM. Il est donc recommandé de tester les applications Qt Multimedia sur toutes les plateformes cibles.

Pour faciliter le développement et le débogage, certaines fonctionnalités de FFmpeg sont configurables via des variables d'environnement qui font partie de l'API privée Qt Multimedia.

Backends natifs

Pour assurer la compatibilité avec les applications existantes, nous maintenons des backends médias natifs pour chaque système d'exploitation :

• GStreamer sur Embedded Linux
• AVFoundation sur macOS et iOS
• Windows Media Foundation sur Windows (obsolète depuis Qt 6.10)
• MediaCodec framework sur Android
• WebAudio et WebVideo sur WebAssembly

Les responsables de Qt s'efforceront de résoudre les problèmes critiques avec les backends natifs, mais ne garantissent pas la résolution des problèmes mineurs, y compris les comportements incohérents entre les plates-formes. Les nouvelles fonctionnalités ne seront implémentées que sur le backend média FFmpeg, à l'exception de WebAssembly.

Le backend GStreamer dispose de certaines API privées permettant un contrôle plus fin. Cependant, il existe des bogues connus dans le backend GStreamer. Plus de détails peuvent être trouvés dans les notes de plateforme pour le backend GStreamer.

Les limitations des backends seront documentées et leur statut sera maintenu dans les classes respectives.

Changement de backend

En cas de problèmes avec le backend FFmpeg par défaut, nous suggérons de tester avec un backend natif. Vous pouvez passer à un backend natif en définissant la variable d'environnement QT_MEDIA_BACKEND à windows, gstreamer (sur Embedded Linux), darwin (sur macOS et iOS), ou android:

export QT_MEDIA_BACKEND=darwin

Pour forcer l'assignation de FFmpeg comme backend utilisé, définissez la variable à ffmpeg:

export QT_MEDIA_BACKEND=ffmpeg

Lors de la compilation de Qt Multimedia, le backend média par défaut peut être configuré via la variable cmake QT_DEFAULT_MEDIA_BACKEND.

Notes sur les plates-formes cibles

Les pages suivantes répertorient les problèmes liés à des plates-formes cibles spécifiques.

• macOS et iOS
• WebAssembly
• Windows
• Linux
• Backend GStreamer pour Linux embarqué

Permissions

À partir de Qt 6.6, le module Qt Multimedia utilise la nouvelle API QPermission pour gérer les permissions camera et microphone. Cela signifie que Qt lui-même ne demande plus ces permissions, ce qui doit être fait directement à partir de l'application cliente.

Veuillez vous référer à la page Permissions de l'application pour un exemple d'intégration de la nouvelle API QPermission dans l'application.

Références et exemples

• QML Types
• Classes C++
• Exemples de classes C