Sur cette page

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.

TypeDescription
AudioEngineLe moteur qui traite la scène audio
SpatialSoundUne source sonore située dans l'espace 3D.
AmbientSoundUne piste sonore stéréo indépendante de l'emplacement.
AudioRoomDé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

ClasseDescription
QAudioEngineLe moteur qui traite la scène audio
QSpatialSoundUne source sonore située dans l'espace 3D.
QAmbientSoundUne piste sonore stéréo indépendante de l'emplacement.
QAudioRoomDé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 :

Eigen, version 5.1.0

Mozilla Public License 2.0 et BSD 3-Clause "New" ou "Revised" License

Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553

Licence Apache 2.0

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

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.