Qt Spatial Audio
Qt Spatial Audio es un módulo adicional que proporciona un rico conjunto de tipos QML y clases C++ para implementar campos sonoros en el espacio 3D. Contiene una API fácil de usar para situar a un oyente en el espacio, añadir fuentes de sonido localizadas alrededor del oyente y emular salas virtuales con reverberación y reflexiones.
Introducción
Si es la primera vez que utiliza Qt Spatial Audio, los tipos QML pueden importarse en una aplicación utilizando la siguiente sentencia en su archivo .qml.
import QtQuick3D.SpatialAudio
Para enlazar con las librerías C++, añada lo siguiente al archivo CMakeLists.txt de su proyecto. Sustituya my_project por el nombre de su proyecto.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)Spatial Audio Overview proporciona una descripción más detallada sobre cómo utilizar las diferentes clases que se enumeran a continuación.
Tipos QML
La siguiente tabla describe algunos tipos QML importantes.
| Tipo | Descripción |
|---|---|
| AudioEngine | El motor que procesa la escena de audio |
| SpatialSound | Una fuente de sonido situada en un espacio 3D. |
| AmbientSound | Una pista de sonido estéreo independiente de la ubicación. |
| AudioRoom | Define una sala que genera reverberación y reflexiones de audio. |
Clases C
La siguiente tabla muestra algunas clases C++ importantes
| Clase | Descripción |
|---|---|
| QAudioEngine | El motor que realiza el procesamiento de la escena de audio |
| QSpatialSound | Una fuente de sonido localizada en el espacio 3D. |
| QAmbientSound | Una pista de sonido estéreo independiente de la ubicación. |
| QAudioRoom | Define una sala que genera reverberación y reflexiones de audio. |
Licencias y atribuciones
El módulo Qt Spatial Audio está disponible bajo licencia comercial de The Qt Company. Además, está disponible bajo licencias de software libre. Estas licencias de software libre son GNU Lesser General Public License, versión 3, o la GNU General Public License, versión 3. Consulte Licencias de Qt para obtener más información.
Tenga en cuenta que Qt Spatial Audio no está disponible bajo la Licencia Pública General GNU, versión 2.
Además, Qt Spatial Audio en Qt 6.11.0 contiene módulos de terceros bajo las siguientes licencias permisivas:
Mozilla Public License 2.0 y BSD 3-Clause "New" or "Revised" License | |
Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553 | Licencia Apache 2.0 |
Licencia BSD de 3 cláusulas "Nueva" o "Revisada |
Referencia y ejemplos
© 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.
