Qt Spatial Audio
Qt Spatial Audio se trouve un module complémentaire qui fournit un ensemble complet de types QML et de classes C++ permettant de mettre en œuvre des champs sonores dans un espace 3D. Il contient une API facile à utiliser pour positionner un auditeur dans l'espace, ajouter des sources sonores localisées autour de l'auditeur et simuler des pièces virtuelles avec réverbération et réflexions.
Pour commencer
Si vous découvrez Qt Spatial Audio, les types QML peuvent être importés dans une application à l’aide de l’instruction suivante dans votre fichier ` .qml `.
import QtQuick3D.SpatialAudioPour lier votre projet aux bibliothèques C++, ajoutez ce qui suit au fichier ` CMakeLists.txt ` de votre projet. Remplacez ` mytarget ` par le nom de votre projet.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)La section «Présentation de l’audio spatial » fournit une description plus détaillée de l’utilisation des différentes classes répertoriées ci-dessous.
Types QML
Le tableau suivant présente certains types QML importants.
| Type | Description |
|---|---|
| AudioEngine | Moteur chargé du traitement de la scène audio |
| SpatialSound | Une source sonore située dans l'espace 3D. |
| AmbientSound | Une piste audio stéréo indépendante de l'emplacement. |
| AudioRoom | Définit une pièce générant une réverbération et des réflexions audio. |
Classes C++
Le tableau suivant présente certaines classes C++ importantes
| Classe | Description |
|---|---|
| QAudioEngine | Le moteur chargé du traitement de la scène audio |
| QSpatialSound | Une source sonore située dans l'espace 3D. |
| QAmbientSound | Une piste audio stéréo indépendante de l'emplacement. |
| QAudioRoom | Définit une pièce générant une réverbération et des réflexions sonores. |
Licences et mentions
Le module « Qt Spatial Audio » est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence de logiciel libre. Ces licences de logiciel libre sont la Licence publique générale restreinte GNU, version 3, ou la Licence publique générale GNU, version 3. Voir la page « Qt Licensing » pour plus de détails.
Notez que « Qt Spatial Audio » n'est pas disponible sous la Licence publique générale GNU, version 2.
Par ailleurs, le module « Qt Spatial Audio » de Qt 6.12.0 contient des modules tiers sous les licences permissives suivantes :
Licence publique Mozilla 2.0 et licence BSD à 3 clauses « nouvelle » ou « révisée » | |
Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553 | Licence Apache 2.0 |
Licence BSD à 3 clauses « New » ou « Revised » |
Référence et exemples
© 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.