Qt Spatial Audio
Qt Spatial Audio se encuentra un módulo complementario que ofrece un amplio 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 reflejos.
Primeros pasos
Si eres nuevo en Qt Spatial Audio, los tipos QML se pueden importar a una aplicación utilizando la siguiente instrucción en tu archivo ` .qml `.
import QtQuick3D.SpatialAudioPara vincular las bibliotecas de C++, añade lo siguiente al archivo ` CMakeLists.txt ` de tu proyecto. Sustituye ` mytarget ` por el nombre de tu proyecto.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)La sección «Descripción general del audio espacial» ofrece una descripción más detallada sobre cómo utilizar las diferentes clases que se enumeran a continuación.
Tipos de QML
La siguiente tabla resume algunos tipos QML importantes.
| Tipo | Descripción |
|---|---|
| AudioEngine | El motor que se encarga del procesamiento de la escena de audio |
| SpatialSound | Una fuente de sonido situada en el espacio 3D. |
| AmbientSound | Una pista de sonido estéreo independiente de la ubicación. |
| AudioRoom | Define una sala que genera reverberación y reflejos de audio. |
Clases de C++
La siguiente tabla resume algunas clases importantes de C++
| Clase | Descripción |
|---|---|
| QAudioEngine | El motor que se encarga del procesamiento de la escena de audio |
| QSpatialSound | Una fuente de sonido situada 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 licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Estas licencias de software libre son la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 3. Consulta «Qt Licensing» para obtener más detalles.
Tenga en cuenta que « Qt Spatial Audio » no está disponible bajo la Licencia Pública General de GNU, versión 2.
Además, « Qt Spatial Audio » en Qt 6.12.0 contiene módulos de terceros bajo las siguientes licencias permisivas:
Licencia Pública de Mozilla 2.0 y Licencia BSD de 3 cláusulas «Nueva» o «Revisada» | |
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.