En esta página

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

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

TipoDescripción
AudioEngineEl motor que se encarga del procesamiento de la escena de audio
SpatialSoundUna fuente de sonido situada en el espacio 3D.
AmbientSoundUna pista de sonido estéreo independiente de la ubicación.
AudioRoomDefine una sala que genera reverberación y reflejos de audio.

Clases de C++

La siguiente tabla resume algunas clases importantes de C++

ClaseDescripción
QAudioEngineEl motor que se encarga del procesamiento de la escena de audio
QSpatialSoundUna fuente de sonido situada en el espacio 3D.
QAmbientSoundUna pista de sonido estéreo independiente de la ubicación.
QAudioRoomDefine 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:

Eigen, version 5.0.1

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

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

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.