Sur cette page

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.SpatialAudio

Pour 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.

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

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

Eigen, version 5.0.1

Licence publique Mozilla 2.0 et licence BSD à 3 clauses « nouvelle » ou « révisée »

Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553

Licence Apache 2.0

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

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.