La proprietà Workspace.SignalBehavior controlla se i gestori degli eventi vengono attivati immediatamente o posticipati. L'opzione Enum.SignalBehavior.Deferred è raccomandata in quanto aiuta a migliorare le prestazioni e la correttezza del motore. I gestori degli eventi per eventi posticipati vengono ripresi al successivo punto di ripresa, insieme a eventuali gestori di eventi attivati di recente.
Il valore Enum.SignalBehavior.Default di Workspace.SignalBehavior è attualmente equivalente a Enum.SignalBehavior.Immediate, ma in futuro passerà a essere equivalente a Enum.SignalBehavior.Deferred. I luoghi dei template sono impostati direttamente su Enum.SignalBehavior.Deferred per impostazione predefinita.
Il seguente diagramma confronta il comportamento degli eventi Immediate e Deferred.
- Con il comportamento Immediate, se un evento attiva un altro evento, il secondo gestore dell'evento si attiva immediatamente.
- Con il comportamento Deferred, il secondo evento viene aggiunto alla coda e viene eseguito successivamente.
Il tempo totale impiegato non cambia, ma l'ordinamento è diverso.
"La reinserzione" impedisce agli eventi di attivarsi continuamente l'uno con l'altro quando raggiungono una certa profondità. Il limite attuale per questo è 10.
Vantaggi degli eventi posticipati
Il comportamento Immediate presenta alcuni svantaggi. Per ogni istanza aggiunta al tuo gioco, proprietà che cambia o qualche altro trigger attivato, il motore deve eseguire codice Luau prima che accada qualsiasi altra cosa.
- Per cambiare 1.000 proprietà, potrebbero dover essere eseguiti 1.000 frammenti di codice dopo ogni cambiamento.
- Possono verificarsi bug strani e difficili da diagnosticare, come un evento di rimozione che si attiva prima che qualcosa sia stato persino aggiunto.
- I sistemi critici per le prestazioni possono attivare eventi che richiedono di tornare e andare avanti a Luau.
- I gestori degli eventi possono apportare modifiche al posto o attivare altri eventi ogni volta che un evento viene attivato.
- Un evento può attivarsi più volte nonostante sia ridondante, come una proprietà che cambia due volte.
Avendo porzioni specifiche del ciclo di vita del motore in cui Luau può essere eseguito, il motore può ottenere prestazioni migliorate utilizzando una serie di assunzioni:
- I sistemi critici per le prestazioni non devono yieldare a Luau, il che porta a guadagni di prestazioni.
- A meno che il motore stesso non lo cambi, il posto non cambia mai al di fuori di un punto di ripresa.
Punti di ripresa
Dopo essere stato posticipato, un gestore di eventi viene ripreso al successivo punto di ripresa. Attualmente, il set di punti di ripresa include:
- Elaborazione degli input (riprende una volta per ogni input da elaborare, vedere UserInputService)
- Ripresa di script di attesa legacy come wait(), spawn(), e delay()
Modelli di codice comuni interessati
Con eventi remoti, i seguenti esempi smettono di funzionare correttamente o hanno un comportamento leggermente diverso; si basano sul fatto che gli eventi vengano ripresi immediatamente.
Attivare e catturare eventi durante l'esecuzione
In questo esempio, false viene sempre restituito quando gli eventi posticipati sono abilitati perché il callback non è stato eseguito. Per funzionare correttamente, il thread deve yieldare fino almeno a quando l'evento avrebbe dovuto attivarsi.
local success = false
event:Connect(function ()
success = true
end)
doSomethingToTriggerEvent() -- Porta all'attivazione di `event`
return success
Ascoltare la prima occorrenza di un evento
connection = event:Connect(function ()
connection:Disconnect()
-- fare qualcosa
end)
Con gli eventi posticipati abilitati, più attivazioni del gestore dell'evento possono essere messe in coda prima che tu disconnetta dall'evento. Chiamare Disconnect() annulla tutte le attivazioni in attesa del gestore dell'evento: lo stesso comportamento esiste per eventi immediati.
Qualsiasi altro metodo di disconnessione oltre a Disconnect(), come chiamare Destroy() sull'oggetto Instance, disconnette il segnale immediatamente, ma esegue il gestore dell'evento associato per eventuali eventi che sono ancora in attesa.
In alternativa, utilizza Once() come metodo più conveniente per collegarti a un evento di cui hai bisogno solo della prima attivazione.
Eventi che cambiano la discendenza o le proprietà
Gli eventi posticipati causano eventi che gestiscono un cambiamento nella discendenza o in una proprietà per attivarsi dopo che la discendenza o la proprietà sono cambiate:
local part = Instance.new("Part", workspace)
local function onPartDestroying()
print("In signal:", part:GetFullName(), #part:GetChildren())
end
part.Destroying:Connect(onPartDestroying)
part:Destroy()
Poiché Destroy() funziona immediatamente dopo che lo script che lo ha chiamato yielda, l'istanza è già stata distrutta nel momento in cui onPartDestroying() viene chiamato. Per ulteriori esempi, vedere Instance.Destroying.