audio
Descripción
Esta biblioteca incluye funciones que gestionan la reproducción de audio.Audio
| Propiedad | Tipo | Por defecto | Descripción |
|---|---|---|---|
| url (Obligatorio) | cadena | '' | Fuente URL |
| volumen | número | 1 | El volumen al que se reproducirá el audio. Un valor entre 0 y 1 |
| bucle | booleano | falso | Si el audio se reinicia al terminar |
| en pausa | booleano | falso | Si el audio está en pausa |
| paso | número | 1 | El factor utilizado para cambiar el tono del audio. 1 es el tono por defecto. |
| posicional | booleano | falso | si el audio se reproduce en posición |
| refDistancia | número | 1 | Sólo se aplica si posicional es verdadero. El valor que indica a qué distancia el volumen de esta fuente comenzará a reducirse a medida que el oyente se aleja. Debe ser un valor no negativo. |
| distanciaModelo | cadena | inverso | **El algoritmo utilizado para reducir el volumen a medida que aumenta la distancia entre esta fuente de audio y el oyente. Los valores posibles son "lineal", "inverso" y "exponencial". |
| rolloffFactor | número | 1 | Sólo se aplica si posicional es verdadero. Con qué rapidez se reduce el volumen a medida que aumenta la distancia entre esta fuente de audio y el oyente. El rango aceptable de valores cambia en función de la distanciaModelo, que se muestra de la siguiente manera: lineal: 0 a 1, inversa: 0 a Infinito, exponencial: 0 a Infinito |
| maxDistancia | número | 10000 | Sólo se aplica si posicional es verdadero y distanceModel es igual a lineal. La distancia máxima entre esta fuente de audio y el oyente. El volumen no se reduce después de este punto. Debe ser un valor positivo. |
Sonido
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | eid | El eid del sonido. |
| audioNodo | Audio / PositionalAudio | NodoAudio |
| elemento | HTMLAudioElement | El elemento de audio HTML. |
| controlador | AbortController | El AbortController de audio. |
| url | cadena | La URL de origen |
| en pausa | booleano | Si el audio está en pausa o en reproducción. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| oyente | AudioListener | Un oyente virtual de todos los efectos de audio posicionales y no posicionales de la escena. |
Funciones
silenciar
Silencia el audio de la escena.
world.audio.mute() // -> void
unmute
Desactiva el audio de la escena.
world.audio.unmute() // -> void
pausa
Pausa el audio de la escena.
world.audio.pause() // -> void
jugar
Reproduce el audio de la escena.
world.audio.play() // -> void
setVolume
Ajusta el volumen del audio de la escena. El parámetro debe ser un valor entre 0 y 1.
world.audio.setVolume(newVolume: number) // -> void