# Audio 3D

El audio **espacial** permite situar y mover fuentes sonoras dentro de un espacio tridimensional, recreando entornos envolventes y realistas donde la posición, la distancia y la dirección influyen directamente en la percepción.

En conjunto, `Binaural` y `BinauralDatabase`, junto con `Listener`, `SpatialAlgorithm` y `SpatialAttenuation`, conforman el ecosistema de audio espacial de **I/O**.

El diseño permite escalar desde un *sistema estéreo convencional* hasta un **entorno** **3D** completo con **simulación acústica**, manteniendo un equilibrio entre precisión, eficiencia de procesamiento y expresividad auditiva en tiempo real.

#### Introducción

**I/O** utiliza un único oyente que define el punto de escucha y su orientación mediante vectores de posición *(position)*, dirección *(forward)* y eje vertical *(up)*.&#x20;

El oyente actúa como referencia para todos los cálculos espaciales, y sus parámetros —como la velocidad del sonido o el factor **Doppler**— pueden sincronizarse dinámicamente para mantener coherencia con la escena acústica o física.&#x20;

Tanto el **oyente** como las **fuentes** usan coordenadas cartesianas, donde el eje **Y** positivo apunta hacia arriba, y las magnitudes son invariantes respecto a unidades físicas.

#### Modelado Binaural

El nodo `Binaural` extiende el comportamiento del `Spatializer` utilizando Head-Related Transfer Functions que modelan precisamente cómo el sonido interactúa con la forma de la cabeza y los oídos del oyente para lograr **experiencias inmersivas**.

Este nodo realiza una *convolución* en tiempo real con datos provistos por la base de datos: `BinauralDatabase`. La base de datos puede cargarse de forma **síncrona o asíncrona**, permitiendo la inicialización progresiva en contextos de renderizado en vivo.&#x20;

Además, el `Binaural` incorpora propiedades de directividad que define un **cono acústico** tridimensional con zonas de ganancia variable, simulando fuentes que proyectan sonido con mayor intensidad hacia una dirección determinada.

El sistema también ofrece control sobre el **modelo de atenuación** que determina cómo disminuye el volumen conforme aumenta la distancia entre la *fuente y el oyente*.

{% hint style="info" %}
Para profundizar en las *estructuras, componentes y ejemplos de implementación*, se recomienda consultar la [**documentación oficial**](https://community.comdigis.com/documentation/io/io/) donde cada concepto se detalla con mayor amplitud.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.comdigis.com/i-o/audio-3d.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
