AudioEmitter

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 AudioEmitter .

Questa proprietà è interna e non può essere accessibile dagli script; esiste per supportare la replicazione. Vedi SetAngleAttenuation() per i dettagli dell'uso.

Se un AudioEmitter e un AudioListener condividono un gruppo di interazione, allora l'ascoltatore è in grado di sentire l'emittente.

Rappresenta una curva volume-over-distance che influisce sul volume con cui un AudioListener ascolterà il AudioEmitter, 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.

Controlla quanto dettagliata debba essere la simulazione audio per questo AudioEmitter , simile a MeshPart.CollisionFidelity o MeshPart.RenderFidelity .

AudioEmitters e AudioListeners che non sono d'accordo sul livello di dettaglio necessario utilizzeranno l'opzione meno dettagliata.

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

Calcola quanto sia udibile questo emittente per un particolare AudioListener .Il volume risultante, che va da 0 a 1, rappresenta l'attenuazione della distanza e dell'angolo sia sull'emittente che sul ricevitore.

Parametri

Restituzioni

Restituisce un array di Wires che sono connessi al pin specificato. AudioEmitter ha un pin "Input".

Parametri

Restituzioni

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

Restituzioni

Restituisce un array di AudioListeners che condivide un AudioInteractionGroup con l'Emitter.

Restituzioni

Restituzioni

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 AudioEmitter .

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 del AudioEmitter da parte della prospettiva di un AudioListener a 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 sul ricevitore AudioListener ) 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

Imposta una curva di volume a distanza che influisce sul volume con cui un AudioListener ascolterà il AudioEmitter, 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 del AudioEmitter da parte della prospettiva di un 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 sul ricevitore AudioListener ) per ottenere l'audibilità finale.

Se la tabella è vuota o nil , il AudioEmitter predefinito utilizza una curva di attenuamento della distanza determinata dalla legge inversa-quadrato.

Parametri

Restituzioni

local Players = game:GetService("Players")

local emitterPart = Instance.new("Part")
emitterPart.Anchored = true
emitterPart.Position = Vector3.new(0, 0, 0)
emitterPart.Parent = workspace

local emitter: AudioEmitter = Instance.new("AudioEmitter")
emitter.Parent = emitterPart

local curve = {}
curve[10] = 1 -- A una distanza di 10 studs, gli ascoltatori sentono questo emittente a pieno volume
curve[100] = 0.4 -- A una distanza di 100 studs, gli ascoltatori sentono questo emittente a 40% di volume
curve[300] = 0 -- A qualsiasi distanza superiore a 300 studs, gli ascoltatori non possono sentire questo emittente
emitter:SetDistanceAttenuation(curve)

-- Replica la curva di rolloff dall'implementazione vocale vecchia
-- La voce predefinita senza la nuova API audio utilizza un rolloff quadratico che va da 7 a 80 studs
local MIN_DISTANCE = 7
local MAX_DISTANCE = 80
local CURVE_STEP_SIZE = 2

local voiceCurve = {}
for i = MIN_DISTANCE, MAX_DISTANCE, CURVE_STEP_SIZE do
	voiceCurve[i] = ((i - MIN_DISTANCE) - (MAX_DISTANCE - MIN_DISTANCE)) ^ 2 / (MAX_DISTANCE - MIN_DISTANCE) ^ 2
end
voiceCurve[MAX_DISTANCE] = 0

local function setVoiceCurve(character)
	local voiceEmitter: AudioEmitter = character:WaitForChild("AudioEmitter")
	voiceEmitter:SetDistanceAttenuation(voiceCurve)
end

for _, player in Players:GetPlayers() do
	if player.Character then
		setVoiceCurve(player.Character)
	end
	player.CharacterAdded:Connect(setVoiceCurve)
end

Evento che si attiva dopo che un Wire diventa connesso o disconnesso, e che Wire è ora o era precedentemente connesso a un pin sulla AudioEmitter e a qualche altra istanza wirable.

Parametri