Saltar al contenido principal

AudioZoneElement

Representa una zona de audio espacial que define cómo se comporta y atenúa el audio en un área específica. Soporta conos de sonido direccionales, modelos de atenuación por distancia y eventos de transición.

inOut: boolean

Indica si debe activarse un evento de transición de "dentro a fuera" cuando el oyente sale de la zona.

Ejemplo:

    audioZone.inOut = true;

outIn: boolean

Indica si debe activarse un evento de transición de "fuera a dentro" cuando el oyente entra en la zona.

Ejemplo:

    audioZone.outIn = true;

distanceModel: string

El modelo de distancia usado para la atenuación del audio dentro de la zona. Modelos comunes incluyen "linear", "inverse" y "exponential".

Ejemplo:

    audioZone.distanceModel = 'inverse';

refDistance: number

Distancia de referencia para los cálculos de reducción de volumen. A esta distancia, el volumen del audio estará en su máximo antes de comenzar la atenuación.

Ejemplo:

    audioZone.refDistance = 5;

maxDistance: number

La distancia máxima a la que se puede escuchar el audio antes de que se atenúe por completo.

Ejemplo:

    audioZone.maxDistance = 50;

coneInnerAngle: number

El ángulo interno (en grados) del cono direccional de audio donde el volumen se mantiene al 100%.

Ejemplo:

    audioZone.coneInnerAngle = 60;

coneOuterAngle: number

El ángulo externo (en grados) del cono direccional de audio donde el volumen disminuye hasta el valor definido en coneOuterGain.

Ejemplo:

    audioZone.coneOuterAngle = 120;

coneOuterGain: number

La ganancia (multiplicador de volumen) aplicada fuera del ángulo externo del cono. Controla cuánto más bajo se escucha el audio al estar fuera del cono direccional.

Ejemplo:

    audioZone.coneOuterGain = 0.5;