En esta página

Descripción general del audio espacial

La API de Qt Spatial Audio proporciona una serie de clases que permiten crear escenas sonoras tridimensionales. Estas se definen mediante objetos situados en el espacio 3D que emiten sonido y la geometría circundante, que puede modelarse utilizando una o varias salas. Por último, se puede situar a un oyente en esta escena sonora en una posición y orientación específicas.

Se pueden utilizar tanto las API de C++ como las de QML.

Creación de una escena sonora

Para crear la escena sonora, primero se instancia un ` QAudioEngine`. Este motor procesa los datos de sonido de entrada y las geometrías para crear una representación realista de la escena sonora tal y como la experimentaría una persona situada en una ubicación específica dentro de la escena.

La propiedad ` QAudioEngine::OutputMode ` se puede utilizar para optimizar la salida, ya sea para auriculares mediante renderizado binaural (3D virtual) o para una configuración de altavoces estéreo o envolvente.

El dispositivo de salida se puede seleccionar mediante la propiedad « QAudioEngine::outputDevice ».

Una vez configurado el motor, podemos colocar diversos objetos de sonido en la escena creando objetos ` QSpatialSound ` y especificando una URL a un archivo de sonido mediante la propiedad ` QSpatialSound::source `.

QAudioListener Se puede utilizar para definir la posición y la orientación de una persona que escucha la escena sonora. Se puede utilizar como máximo un oyente por motor. Si no se especifica ningún oyente, el motor asume que el oyente se encuentra en el origen del sistema de coordenadas, mirando en dirección positiva del eje z, con el eje y positivo apuntando hacia arriba.

Además de las fuentes de sonido y un oyente, puedes definir una geometría que influya en cómo percibe el oyente el sonido mediante un conjunto de objetos « QAudioRoom ». Las salas son rectangulares y admiten una amplia variedad de materiales para cada pared, lo que proporciona una experiencia diferente con distintas reflexiones sonoras y reverberación. Los efectos de sala se aplicarán si el oyente se encuentra dentro de una de las salas. Si se encuentra dentro de varias salas, tendrá prioridad la sala con el volumen geométrico más pequeño.

Si necesitas una superposición estéreo que sea independiente de la posición y la orientación del oyente (como música de fondo o una voz en off), puedes utilizar « QAmbientSound » para crear la superposición de sonido.

Para ver un pequeño ejemplo basado en QWidget que muestra una fuente de audio que se puede desplazar por una sala, echa un vistazo al ejemplo de panoramización de audio espacial.

Documentación de referencia

Clases de C++

QAmbientSound

Un sonido superpuesto estéreo

QAudioEngine

Gestiona un campo sonoro tridimensional

QAudioListener

Define la posición y la orientación de la persona que escucha un campo sonoro definido por QAudioEngine

QAudioRoom

QSpatialSound

Un objeto de sonido en el espacio 3D

Tipos QML

AmbientSound

Un sonido superpuesto estéreo

AudioEngine

Gestiona objetos de sonido dentro de una escena 3D

AudioListener

Define la posición y la orientación de la persona que escucha un campo sonoro definido por un AudioEngine

AudioRoom

SpatialSound

Un objeto de sonido en el espacio 3D

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