Construire Qt Multimedia à partir des sources

Cette page décrit le processus de configuration et de construction de l'application Qt Multimedia. Cette description suppose d'être familier avec la section Construire les sources Qt qui spécifie les exigences de construction pour votre plateforme, ainsi qu'une vue d'ensemble des options de configuration de Qt. Pour les considérations spécifiques à la plate-forme liées au module Qt Multimedia, voir les notes relatives à la plate-forme ci-dessous.

Construction à partir des sources

La construction de Qt Multimedia avec un support complet des fonctionnalités dépend des en-têtes et des bibliothèques FFmpeg sur la plupart des plateformes. Il est possible de construire Qt Multimedia sans le backend FFmpeg Qt Multimedia, mais cela n'est recommandé que pour les plates-formes où le backend FFmpeg n'est pas pris en charge.

Les bibliothèques de développement FFmpeg nécessaires pour construire Qt Multimedia peuvent être construites à partir des sources ou téléchargées sous forme de paquets binaires. Qt Multimedia peut utiliser un lien statique ou un lien dynamique vers les bibliothèques FFmpeg. Nous recommandons d'utiliser la même version majeure de FFmpeg que celle indiquée dans les notes relatives à la plate-forme et au backend Target. Pour plus d'informations sur la façon de construire les bibliothèques de développement FFmpeg, voir Construire FFmpeg à partir des sources.

Pour construire Qt Multimedia avec le support FFmpeg, spécifiez l'option -ffmpeg-dir sur la ligne de commande configure lors de la construction de Qt.

qt-source/configure -ffmpeg-dir <FFMPEG_DIR>

Ici, <FFMPEG_DIR> est le répertoire contenant les répertoires FFmpeg include, lib et bin. Pour construire Qt Multimedia sans FFmpeg, omettez la variable <FFMPEG_DIR> et spécifiez l'option de configuration -no-feature-ffmpeg.

Si vous préférez ne pas construire tous les sous-modules de Qt XML, vous pouvez réduire les temps de configuration et de construction en utilisant l'option de configuration -submodules. Cela configurera une compilation qui ne construira que Qt Multimedia et ses dépendances.

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR>

Si vous configurez Qt Multimedia contre FFmpeg construit avec des bibliothèques partagées (liaison dynamique), les bibliothèques partagées FFmpeg doivent être dans le chemin de recherche du chargeur de module pour exécuter des tests ou utiliser des exemples.

Si vous n'avez pas déjà ces bibliothèques dans le répertoire path, spécifiez l'option de configuration -ffmpeg-deploy. Avec cette option activée, les binaires FFmpeg nécessaires seront copiés dans le répertoire d'installation de Qt pendant les étapes de construction et d'installation :

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR> -ffmpeg-deploy

Après avoir configuré Qt Multimedia, lisez attentivement le résumé de la configuration (qui se trouve dans le fichier config.summary). Vous pouvez vérifier que FFmpeg se trouve dans la section "Plugin". Ensuite, suivez les étapes normales de construction et d'installation décrites dans la section Construire les sources Qt.

Notes sur les plateformes

iOS

• Lors de la configuration de Qt Multimedia avec le support FFmpeg, le processus de configuration CMake recherche les fichiers .xcframework dans le répertoire FFmpeg fourni. L'utilisation directe des binaires .dylib n'est pas supportée. Voir Construire FFmpeg à partir des sources pour iOS sur macOS et https://developer.apple.com/documentation/xcode/creating-a-multi-platform-binary-framework-bundle pour plus de détails sur la façon d'empaqueter les artefacts de construction de FFmpeg dans des fichiers .xcframework.

Linux

• Lors de la configuration de Qt Multimedia avec FFmpeg activé, le paquetage de développement pipewire ou pulseaudio est requis. Sans l'un de ces paquets, FFmpeg ne sera pas reconnu.
• Lorsque vous utilisez une version de FFmpeg qui est construite avec le support VAAPI, nous recommandons de construire Qt Multimedia avec le support VAAPI également pour rendre possible la conversion des textures matérielles. Pour configurer Qt Multimedia avec le support VAAPI, les bibliothèques de développement VAAPI doivent être installées sur votre système. Vérifiez dans le fichier config.summary que le support VAAPI est activé dans la section "Hardware acceleration and features".
• Lors de la configuration de Qt Multimedia avec le backend GStreamer, GStreamer v1.20 est la configuration minimale requise. Cependant, nous recommandons d'utiliser la dernière version stable de GStreamer en amont si possible.