Qt Spatial Audio
Qt Spatial Audio est un module complémentaire qui fournit un riche ensemble de types QML et de classes C++ pour 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 émuler des salles virtuelles avec des réverbérations et des réflexions.
Pour commencer
Si vous n'avez jamais utilisé 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.SpatialAudio
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 SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)Ledocument Spatial Audio Overview fournit une description plus détaillée de l'utilisation des différentes classes énumérées ci-dessous.
Types QML
Le tableau suivant présente quelques types QML importants.
| Type | Description |
|---|---|
| AudioEngine | Le moteur qui traite la scène audio |
| SpatialSound | Une source sonore située dans l'espace 3D. |
| AmbientSound | Une piste sonore stéréo indépendante de l'emplacement. |
| AudioRoom | Définit une pièce qui génère des réverbérations et des réflexions audio. |
Classes C
Le tableau suivant présente quelques classes C++ importantes
| Classe | Description |
|---|---|
| QAudioEngine | Le moteur qui traite la scène audio |
| QSpatialSound | Une source sonore située dans l'espace 3D. |
| QAmbientSound | Une piste sonore stéréo indépendante de l'emplacement. |
| QAudioRoom | Définit une pièce qui génère des réverbérations et des réflexions audio. |
Licences et attributions
Le module Qt Spatial Audio est disponible sous licence commerciale auprès de The Qt Company. En outre, il est disponible sous des licences de logiciel libre. Ces licences de logiciel libre sont la GNU Lesser General Public License, version 3, ou la GNU General Public License, version 3. Voir 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.
En outre, Qt Spatial Audio dans Qt 6.11.0 contient des modules tiers sous les licences permissives suivantes :
Mozilla Public License 2.0 et BSD 3-Clause "New" ou "Revised" License | |
Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553 | Licence Apache 2.0 |
Licence BSD à 3 clauses "nouvelle" ou "révisée |
Références 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.