RunService

La funzione BindToRenderStep() lega una funzione personalizzata da chiamare a un'ora specifica durante il passo di rendering.Ci sono tre argomenti principali: name , priority , e cosa function chiamare.

Poiché è legato al processo di rendering del client, BindToRenderStep() può essere chiamato solo sul client.

Nome

Il parametro name è un'etichetta per il binding e può essere utilizzato con RunService:UnbindFromRenderStep() se il binding non è più necessario.

local RunService = game:GetService("RunService")

local function functionToBind() end

-- Lega la funzione sopra alla bind chiamata "tempBinding"
RunService:BindToRenderStep("tempBinding", 1, functionToBind)
-- Diselega la funzione legata a "tempBinding"
RunService:UnbindFromRenderStep("tempBinding")

Priorità

Il priority della bind è un Integro; determina quando durante il passo di rendering chiamare la funzione personalizzata.Più basso è questo numero, prima verrà chiamata la funzione personalizzata.Se due binding hanno la stessa priorità, il motore Roblox sceglierà casualmente uno per eseguire prima.Gli script di controllo predefiniti di Roblox vengono eseguiti con queste priorità specifiche:

• Input del giocatore: 100
• Controlli della fotocamera: 200 Per convenienza; l'enumero Enum.RenderPriority può essere utilizzato per determinare il valore intero per impostare un legame.Ad esempio, per creare un diritto di vincolo prima dell'Aggiornarmentodella fotocamera predefinita, semplice sottrarre 1 dalla Livellodella fotocamera.

Quando si utilizza Enum.RenderPriority , ricorda di utilizzare .Value alla fine dell'Enum desiderata. RunService:BindToRenderStep() non funzionerà se solo l'Enum viene utilizzata da Proprio.

local RunService = game:GetService("RunService")

local function beforeCamera(delta)
	-- Il codice qui sarà eseguito prima dello script della fotocamera predefinita di Roblox
end

RunService:BindToRenderStep("Before camera", Enum.RenderPriority.Camera.Value - 1, beforeCamera)

Funzione personalizzata e tempo Delta

L'ultimo argomento ( function ) è la funzione personalizzata da chiamare.Questa funzione verrà passata un parametro chiamato deltaTime che mostra quanto tempo è passato tra l'inizio del precedente passo di rendering e l'inizio del passo di rendering attuale.

Tutti gli aggiornamenti di rendering attenderanno fino a quando il codice nel passo di rendering non finisce.Assicurati che qualsiasi codice chiamato da BindToRenderStep() funzioni rapidamente e in modo efficiente; se il codice richiede troppo tempo, le visuali dell'esperienza saranno scadenti.

Parametri

Restituzioni

local RunService = game:GetService("RunService")

-- How fast the frame ought to move
local SPEED = 2

local frame = script.Parent
frame.AnchorPoint = Vector2.new(0.5, 0.5)

-- A simple parametric equation of a circle
-- centered at (0.5, 0.5) with radius (0.5)
local function circle(t)
	return 0.5 + math.cos(t) * 0.5, 0.5 + math.sin(t) * 0.5
end

-- Keep track of the current time
local currentTime = 0
local function onRenderStep(deltaTime)
	-- Update the current time
	currentTime = currentTime + deltaTime * SPEED
	-- ...and the frame's position
	local x, y = circle(currentTime)
	frame.Position = UDim2.new(x, 0, y, 0)
end

-- This is just a visual effect, so use the "Last" priority
RunService:BindToRenderStep("FrameCircle", Enum.RenderPriority.Last.Value, onRenderStep)
--RunService.RenderStepped:Connect(onRenderStep) -- Also works, but not recommended

local RunService = game:GetService("RunService")

local function checkDelta(deltaTime)
	print("Time since last render step:", deltaTime)
end

RunService:BindToRenderStep("Check delta", Enum.RenderPriority.First.Value, checkDelta)

local RunService = game:GetService("RunService")

-- Step 1: Declare the function and a name
local NAME = "Print Hello"
local function printHello()
	print("Hello")
end

-- Step 2: Bind the function
RunService:BindToRenderStep(NAME, Enum.RenderPriority.First.Value, printHello)

-- Step 3: Unbind the function
RunService:UnbindFromRenderStep(NAME)

Se il codice che ha invocato questo metodo viene eseguito in un contesto client (in un LocalScript , in un ModuleScript richiesto da un LocalScript , o in un Script con RunContext impostato su Enum.RunContext.Client , questo metodo restituirà true .In tutti gli altri casi, questo metodo restituirà false .

Se questo metodo restituisce true , l'ambiente attuale può accedere a funzionalità solo client come RunService.PreRender o Players.LocalPlayer .

Restituzioni

Questo metodo restituisce se l'ambiente attuale è in modalità "Modificare", ad esempio in Studio quando l'esperienza non è in esecuzione.

IsEdit() restituirà l'inverso di IsRunning(), ad eccezione quando la simulazione è stata interrotta, in cui entrambi i metodi restituiranno false .

Restituzioni

Questo metodo restituisce se il pulsante Esegui è stato premuto per eseguire la simulazione in Studio.Continuerà a restituire true se la simulazione è stata interrotta utilizzando il pulsante Pausa ; tuttavia, una volta che è stata interrotta utilizzando il pulsante Stop , tornerà a restituire false .

Nota che Studio entra solo in modalità "Eseguire" quando viene premuto il pulsante Esegui , non il pulsante Gioca .Si noti inoltre che questo metodo restituirà false se la simulazione è stata avviata utilizzando RunService:Run() piuttosto che il pulsante Esegui .

Restituzioni

Restituisce se l'esperienza è attualmente in esecuzione, cioè la simulazione è stata eseguita utilizzando i pulsanti Esegui o Gioca .

IsRunning() restituirà sempre l'inverso di IsEdit() tranne quando la simulazione è stata interrotta, in cui entrambi i metodi restituiranno false .

Restituzioni

Questo metodo restituisce se l'ambiente attuale è in esecuzione sul Server.Se il codice che ha invocato questo metodo viene eseguito in un contesto server (in un Script con RunContext impostato su Enum.RunContext.Server o Enum.RunContext.Legacy , o in un ModuleScript richiesto da un Script ), questo metodo restituirà true .In tutti gli altri casi, questo metodo restituirà false .

Se questa funzione restituisce vero, l'ambiente attuale può accedere a funzionalità solo server come ServerStorage o ServerScriptService .

Restituzioni

Questo metodo restituisce se l'ambiente attuale è in esecuzione in Studio. Può essere utilizzato per avvolgere il codice che dovrebbe essere eseguito solo durante il test in Studio.

Restituzioni

Questo metodo interrompe la simulazione dell'esperienza se è in esecuzione, sospendendo fisica e script.La simulazione può essere avviata utilizzando Run() o il pulsante Esegui in Studio; quando la simulazione viene interrotta, IsRunning() restituirà false .

Restituzioni

Questo metodo esegue la simulazione dell'esperienza (fisica e script).Quando la simulazione è in esecuzione, IsRunning() restituirà true .Tuttavia, IsRunMode() restituirà solo true se la simulazione è stata avviata utilizzando il pulsante Esegui in Studio.

Restituzioni

Questo metodo interrompe la simulazione dell'esperienza se è in esecuzione.Quando la simulazione viene interrotta, IsRunning() restituirà false e IsEdit() restituirà true.

In contrasto al pulsante Stop in Studio, chiamare questo metodo non ripristinerà l'esperienza allo stato in cui era prima dell'Eseguiredella simulazione.Questo significa che qualsiasi modifica all'esperienza effettuata dalla simulazione fisica e dagli script persisterà dopo che la simulazione sarà terminata.

Restituzioni

Dato un nome di una funzione inviata a BindToRenderStep() , questo metodo dislega la funzione dal essere chiamata durante PreRender .Questo viene utilizzato per dislegare le funzioni legate una volta che non sono più necessarie o quando non hanno più bisogno di attivare ogni passo.

Se non esiste una funzione legata dal nome fornito, questo metodo non intraprende alcuna azione e continua senza sollevare un errore.

Parametri

Restituzioni

L'evento Heartbeat si attiva ad ogni frame, dopo che la simulazione fisica è completata.L'argomento deltaTime indica il tempo trascorso dall'ultimo frame.

Questo evento è quando la maggior parte degli script Eseguireeseguita.Si verifica alla fine di ogni frame e è anche quando vengono eseguiti gli script in attesa, come quelli programmati con la libreria task.Heartbeat è comunemente utilizzato per compiti periodici, come l'aggiornamento dei sistemi di gioco principali come la rigenerazione della salute.

Dopo questo passo, il motore invia aggiornamenti delle proprietà e eventi al server o ai client che vengono successivamente ricevuti come parte del passaggio di ricezione della replicazione replication.

Parametri

L'evento PostSimulation si attiva ad ogni frame, dopo che la simulazione fisica è completata.L'argomento deltaTimeSim indica il tempo in cui il quadro attuale ha eseguito la simulazione fisica, senza tenere conto dell'accelerazione fisica.

Questo evento è utile per apportare gli ultimi aggiustamenti al risultato della simulazione. Dopo questa fase, il motore attiva l'evento Heartbeat.

Parametri

L'evento PreAnimation si attiva ogni frame, prima della simulazione fisica ma dopo il rendering.L'argomento deltaTimeSim indica il tempo in cui il frame attuale ha effettuato le animazioni di passaggio.

Questo evento è utile per modificare gli oggetti di animazione, come regolare la loro velocità o priorità.Una volta completato l'evento PreAnimation, il motore procede ad eseguire queste animazioni, aggiornando le trasformazioni congiunte che verranno utilizzate in seguito per aggiornare gli oggetti durante la simulazione fisica.

Dopo che le animazioni sono state eseguite, il motore attiva l'evento PreSimulation.

Parametri

L'evento PreRender (sostituzione di RenderStepped ) viene attivato ogni frame, prima che il frame venga visualizzato.L'argomento deltaTimeRender indica il tempo trascorso dall'ultimo frame.

Questo evento ti consente di eseguire il codice e aggiornare il mondo prima che venga disegnato sullo schermo di un Giocatore.Questo è utile per aggiustamenti all'ultimo minuto come la modifica delle posizioni degli oggetti, l'aggiornamento delle animazioni o la preparazione degli effetti visivi, ma dovrebbe essere utilizzato con parsimonia poiché il motore non può iniziare a rendere il frame fino a quando il codice in esecuzione in questo evento non è finito.

Poiché PreRender è lato client, può essere utilizzato solo in un LocalScript , in un ModuleScript richiesto da un LocalScript , o in un Script con RunContext impostato su Enum.RunContext.Client .

Dopo la fase PreRender di simulazione inizia con l'evento PreAnimation.

Parametri

L'evento PreSimulation (sostituzione di Stepped ) si attiva ogni frame, prima della simulazione fisica.L'argomento deltaTimeSim indica il tempo in cui il quadro attuale eseguirà la simulazione fisica, senza tenere conto dell'accelerazione fisica.

Questo evento è utile per regolare proprietà come velocità o forze appena prima che vengano applicate come parte della simulazione.La simulazione poi viene eseguita, potenzialmente più volte, poiché il solver fisico funziona con una frequenza maggiore rispetto ad altri sistemi di motore.Una volta completato, viene attivato l'evento PostSimulation.

Parametri

Fuoca ogni frame, prima che il frame venga reso.

Nota di migrazione

Questo evento è stato superato da PreRender che dovrebbe essere utilizzato per il nuovo lavoro.

Parametri

Fuoca ogni frame, prima della simulazione fisica.

Nota di migrazione

Questo evento è stato superato da PreSimulation che dovrebbe essere utilizzato per il nuovo lavoro.

Parametri