AudioListener

Visualizza obsoleti

*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

Camera Listener

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à

Metodi

Eventi

Proprietà

AngleAttenuation

BinaryString
Sicurezza Roblox
Lettura Parallela

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

Lettura Parallela

Controlli che AudioEmitters sono audibili a questo AudioListener . Emettitori che condividono un gruppo di interazione possono essere ascoltati da questo Ascoltatore.

DistanceAttenuation

BinaryString
Sicurezza Roblox
Lettura Parallela

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.

Lettura Parallela

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.

GetAudibilityFor

Parametri

emitter: AudioEmitter
Valore predefinito: ""

Restituzioni

GetConnectedWires

Instances

Restituisce un array di Wires che sono connessi al pin specificato. AudioListener ha un pin "Output".

Parametri

pin: string
Valore predefinito: ""

Restituzioni

Instances

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

GetInputPins


Restituzioni

GetInteractingEmitters

Instances

Restituzioni

Instances

GetOutputPins


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

curve: Dictionary
Valore predefinito: ""

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

curve: Dictionary
Valore predefinito: ""

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

connected: boolean

Se l'istanza è stata connessa o disconnessa.

pin: string

Il pin sul AudioListener che i bersagli Wire .

wire: Wire

Il Wire tra la AudioListener e l'altra esempio.

instance: Instance

L'altra istanza che è o era connessa attraverso il Wire .