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;