AudioListener
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
AudioListener registra uno stream audio dal suo ambiente AudioEmitters nel Mondo3D.Fornisce un singolo Output pin che può essere collegato ad altri pin tramite Wires .Se il padre è un , , o , il mondo del parentverrà utilizzato per l'ascolto.Se il genitore non è una di queste Classi, il AudioListener effettivamente non sente nulla.
Campioni di codice
local listener = Instance.new("AudioListener")
local output = Instance.new("AudioDeviceOutput")
local wire = Instance.new("Wire")
listener.Parent = workspace.Camera
wire.Parent = listener
output.Parent = wire
wire.SourceInstance = listener
wire.TargetInstance = output
Sommario
Proprietà
Rappresenta come cambia il volume percepito del suono emesso in base all'angolo tra un AudioEmitter e il LookVector associato al AudioListener .
Controlli che AudioEmitters sono audibili a questo AudioListener .
Rappresenta come cambia il volume percepito dei suoni emessi a misura che aumenta la distanza tra AudioEmitters e AudioListener.
Controlla quanto dettagliata debba essere la simulazione audio per questo AudioListener .
Metodi
Ottiene la curva di attenuazione dell'angolo che il AudioListener sta utilizzando, o una tabella vuota se sta utilizzando la curva predefinita.
Restituisce un array di Wires che sono connessi al pin specificato.
Ottiene la curva di attenuamento della distanza che il AudioListener sta utilizzando, o una tabella vuota se sta utilizzando la curva predefinita.
Imposta la curva di attenuazione dell'angolo che il AudioListener dovrebbe utilizzare, o utilizza una curva costante di volume 1 se non viene fornita.
Imposta la curva di attenuazione della distanza che il AudioListener deve utilizzare, o utilizza una curva di rolloff inversa se non viene fornita.
Eventi
Si accende quando un'altra istanza è connessa o disconnessa dal AudioListener attraverso un Wire .
Proprietà
AngleAttenuation
Rappresenta una curva volume-over-angelo che influisce sul volume con cui un AudioListener ascolterà il AudioEmitter , in base all'angolo tra loro e il LookVector associato al AudioListener .
Questa proprietà è interna e non può essere accessibile dagli script; esiste per supportare la replicazione. Vedi SetAngleAttenuation() per i dettagli dell'uso.
AudioInteractionGroup
Controlli che AudioEmitters sono audibili a questo AudioListener . Emettitori che condividono un gruppo di interazione possono essere ascoltati da questo Ascoltatore.
DistanceAttenuation
Rappresenta una curva volume-over-distance che influisce sul volume con cui AudioListener sente qualsiasi AudioEmitters , in base alla distanza tra loro.
Questa proprietà è interna e non può essere accessibile dagli script; esiste per supportare la replicazione. Vedi SetDistanceAttenuation() per i dettagli dell'uso.
SimulationFidelity
Controlla quanto dettagliata debba essere la simulazione audio per questo AudioListener , simile a MeshPart.CollisionFidelity o MeshPart.RenderFidelity .
AudioListeners e AudioEmitters che non sono d'accordo sul livello di dettaglio necessario utilizzeranno l'opzione meno dettagliata.
Metodi
GetAngleAttenuation
Restituisce un angolo di mappatura del tavolo al volume.Le chiavi sono numeri compresi tra 0 e 180 (inclusi), mentre i valori sono numeri compresi tra 0 e 1 (inclusi) che descrivono come il volume si attenua a seconda della direzione.Questo metodo restituisce una tabella vuota se viene utilizzata la curva di attenuazione angolare predefinita.
Restituzioni
Angolo di mappatura della tabella al volume, come descritto sopra.
GetConnectedWires
Restituisce un array di Wires che sono connessi al pin specificato. AudioListener ha un pin "Output".
Parametri
Restituzioni
GetDistanceAttenuation
Restituisce una distanza di mappatura del tavolo al volume.Le chiavi sono numeri maggiori o uguali a 0, mentre i valori sono numeri tra 0 e 1 (inclusi) che descrivono come il volume si attenua a distanza.Questo metodo restituisce una tabella vuota se viene utilizzata la curva di attenuazione predefinita della distanza.
Restituzioni
GetInteractingEmitters
Restituzioni
SetAngleAttenuation
Imposta una curva di volume-over-angolo che influisce sul modo in cui AudioListener sentirà forte il AudioEmitter , in base all'angolo tra loro e il LookVector associato al AudioListener .
La curva è rappresentata da chiavi di mappatura di tabelle per gli angoli ai valori di volume.Si prevede che le chiavi siano numeri unici tra 0 e 180 (inclusi), mentre si prevede che i valori siano numeri tra 0 e 1 (inclusi).Sono supportate tabelle che contengono fino a 400 coppie chiave-valore.
Il volume di un AudioEmitter da parte della prospettiva del AudioListener ad un angolo a è determinato dall'interpolazione lineare tra i livelli di volume per i punti sulla curva i cui valori di angolo sono direttamente sopra e sotto a .Se non c'è alcun punto al di sotto di a o nessun punto al di sopra di a, viene scelto il livello di volume dell'altro punto.Fondamentalmente, la curva è una sequenza di punti connessi da linee dritte, e oltre ai suoi estremi sinistra e destra, la curva si estende verso l'esterno ai loro rispettivi livelli di volume.
Questo volume sarà moltiplicato con i volumi di tutte le altre curve di attenuazione (incluse quelle sull'invio AudioEmitter ) per ottenere l'audibilità finale.
Se la tabella è vuota o nil , il AudioEmitter predefinito utilizza una curva di attenuazione dell'angolo con il valore costante del volume di 1 .
Parametri
Restituzioni
SetDistanceAttenuation
Imposta una curva di volume a distanza che influisce sul volume con cui l'AudioListener ascolterà qualsiasi AudioEmitters, in base alla distanza tra loro.
La curva è rappresentata da chiavi di mappatura di tabella per le distanze ai valori del volume.Le chiavi sono destinate ad essere numeri unici maggiori o uguali a 0, mentre i valori sono destinati ad essere numeri tra 0 e 1 (inclusi).Sono supportate tabelle che contengono fino a 400 coppie chiave-valore.
Il volume di un AudioEmitter da parte della prospettiva del AudioListener a una distanza d è determinato dall'interpolazione lineare tra i livelli di volume per i punti sulla curva i cui valori di distanza sono direttamente sopra e sotto d .Se non c'è alcun punto al di sotto di d o nessun punto al di sopra di d, viene scelto il livello di volume dell'altro punto.Fondamentalmente, la curva è una sequenza di punti connessi da linee dritte, e oltre ai suoi estremi sinistra e destra, la curva si estende all'infinito verso l'esterno ai loro rispettivi livelli di volume.
Questo volume sarà moltiplicato con i volumi di tutte le altre curve di attenuazione (incluse quelle sull'invio AudioEmitter ) per ottenere l'audibilità finale.
Se la tabella è vuota o nil , il AudioListener predefinito applica una costante volume di 1 ovunque.
Parametri
Restituzioni
Eventi
WiringChanged
Evento che si attiva dopo che un Wire diventa connesso o disconnesso, e che Wire è ora o era precedentemente connesso a un pin sulla AudioListener e a qualche altra esempiowirable.
Parametri
Se l'istanza è stata connessa o disconnessa.
Il pin sul AudioListener che i bersagli Wire .
Il Wire tra la AudioListener e l'altra esempio.