Audio
Beschreibung
Diese Bibliothek enthält Funktionen für die Audiowiedergabe.Audio
Eigentum | Typ | Standard | Beschreibung |
---|---|---|---|
url (Erforderlich) | String | '' | Quelle URL |
Band | Nummer | 1 | Wie laut der Ton abgespielt werden soll. Ein Wert zwischen 0 und 1 |
Schleife | boolean | falsch | Ob der Ton nach Beendigung des Vorgangs neu gestartet wird |
pausiert | boolean | falsch | Ob der Ton gerade pausiert wird |
Stellplatz | Nummer | 1 | Der Faktor, der verwendet wird, um die Tonhöhe des Audios zu ändern. 1 ist die Standardeinstellung. |
Standort | boolean | falsch | ob der Ton positionsabhängig abgespielt wird |
refDistance | Nummer | 1 | Wird nur angewandt, wenn positional true ist. Der Wert, der angibt, ab welcher Entfernung die Lautstärke von dieser Quelle abnimmt, wenn sich der Zuhörer entfernt. Muss ein nicht-negativer Wert sein. |
distanceModel | String | Invers | **Der Algorithmus, der verwendet wird, um die Lautstärke mit zunehmender Entfernung zwischen dieser Audioquelle und dem Zuhörer zu reduzieren. Mögliche Werte sind "linear", "invers" und "exponentiell". |
rolloffFactor | Nummer | 1 | Wird nur angewendet, wenn positional true ist. Wie schnell die Lautstärke mit zunehmender Entfernung zwischen dieser Audioquelle und dem Zuhörer reduziert wird. Der zulässige Wertebereich ändert sich je nach distanceModel wie folgt: linear: 0 bis 1, invers: 0 bis Unendlich, exponentiell: 0 bis Unendlich |
maxDistance | Nummer | 10000 | Wird nur angewandt, wenn positional wahr ist und distanceModel gleich linear ist. Der maximale Abstand zwischen dieser Audioquelle und dem Zuhörer. Danach wird das Volumen nicht mehr reduziert. Muss ein positiver Wert sein. |
Ton
Eigentum | Typ | Beschreibung |
---|---|---|
id | eid | Das Fest des Klangs. |
audioNode | Audio / LageAudio | AudioNode |
Element | HTMLAudioElement | Das HTML-Audio-Element. |
Controller | AbortController | Der Audio-AbortController. |
url | String | Die Quell-URL |
pausiert | boolean | Ob der Ton angehalten ist oder gerade abgespielt wird. |
Eigenschaften
Eigentum | Typ | Beschreibung |
---|---|---|
Hörer | AudioListener | Ein virtueller Hörer für alle positionalen und nicht-positionalen Audioeffekte in der Szene. |
Funktionen
stummschalten
Ton der Szene stummschalten.
world.audio.mute() // -> void
stummschalten
Ton der Szene aufheben.
world.audio.unmute() // -> void
Pause
Ton der Szene anhalten.
world.audio.pause() // -> void
spielen
Ton der Szene abspielen.
world.audio.play() // -> void
setVolume
Lautstärke der Szene einstellen. **Der Parameter sollte einen Wert zwischen 0 und 1 haben.
world.audio.setVolume(newVolume: Zahl) // -> void