Aprenda
Classe do mecanismo
RunService
Não criável
Serviço
Não replicado

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.



Referência API
Propriedades
ClientGitHash
Somente leitura
Não replicado
Segurança do script Roblox
Ler Parallel
Recursos: Basic
RunService.ClientGitHash:string

RunState
Não replicado
Segurança do plugin
Ler Parallel
Recursos: Basic
RunService.RunState:Enum.RunState

Métodos
BindToRenderStep
Recursos: Basic
RunService:BindToRenderStep(
name:string, priority:number, function:function
):()
Parâmetros
name:string
priority:number
function:function
Devolução
()
Amostras de código
Movendo o Frame em Círculo
local RunService = game:GetService("RunService")
-- A que velocidade o frame deve se mover
local SPEED = 2
local frame = script.Parent
frame.AnchorPoint = Vector2.new(0.5, 0.5)
-- Uma equação paramétrica simples de um círculo
-- centrada em (0.5, 0.5) com raio (0.5)
local function circle(t)
return 0.5 + math.cos(t) * 0.5, 0.5 + math.sin(t) * 0.5
end
-- Acompanhe o tempo atual
local currentTime = 0
local function onRenderStep(deltaTime)
-- Atualize o tempo atual
currentTime = currentTime + deltaTime * SPEED
-- ...e a posição do frame
local x, y = circle(currentTime)
frame.Position = UDim2.new(x, 0, y, 0)
end
-- Este é apenas um efeito visual, então use a prioridade "Último"
RunService:BindToRenderStep("FrameCircle", Enum.RenderPriority.Last.Value, onRenderStep)
--RunService.RenderStepped:Connect(onRenderStep) -- Também funciona, mas não recomendado
Função Personalizada do RunService
local RunService = game:GetService("RunService")
local function checkDelta(deltaTime)
print("Tempo desde o último passo de renderização:", deltaTime)
end
RunService:BindToRenderStep("Ver delta", Enum.RenderPriority.First.Value, checkDelta)
Vincular e Desvincular uma Função
local RunService = game:GetService("RunService")
-- Passo 1: Declarar a função e um nome
local NAME = "Print Hello"
local function printHello()
print("Olá")
end
-- Passo 2: Vincular a função
RunService:BindToRenderStep(NAME, Enum.RenderPriority.First.Value, printHello)
-- Passo 3: Desvincular a função
RunService:UnbindFromRenderStep(NAME)

BindToSimulation
Recursos: Basic
RunService:BindToSimulation(
function:function, frequency:Enum.StepFrequency, priority:number
Parâmetros
function:function
Valor Padrão: "Hz30"
priority:number
Valor Padrão: 2000
Amostras de código
Sincronizando a Propriedade de Cor de uma Parte
local RunService = game:GetService("RunService")
local Workspace = game:GetService("Workspace")
local somePart:BasePart = Workspace:WaitForChild("Part")
RunService:BindToSimulation(function(deltaTime: number)
local syncdColor = Color3.fromHSV(math.fmod(time(), 1.0), 1.0, 1.0)
somePart:SetAttribute("SyncdColor", syncdColor)
end)
RunService.RenderStepped:Connect(function(deltaTime: number)
local syncdColor = somePart:GetAttribute("SyncdColor")
somePart.Color = syncdColor
end)

GetPredictionStatus
Recursos: Basic
Acesso à simulação
RunService:GetPredictionStatus(context:Instance):Enum.PredictionStatus
Parâmetros
context:Instance

IsClient
Escrever Parallel
Recursos: Basic
RunService:IsClient():boolean
Devolução

IsEdit
Segurança do plugin
Escrever Parallel
Recursos: Basic
RunService:IsEdit():boolean
Devolução

IsRunMode
Escrever Parallel
Recursos: Basic
RunService:IsRunMode():boolean
Devolução

IsRunning
Recursos: Basic
RunService:IsRunning():boolean
Devolução

IsServer
Escrever Parallel
Recursos: Basic
RunService:IsServer():boolean
Devolução

IsStudio
Escrever Parallel
Recursos: Basic
RunService:IsStudio():boolean
Devolução

Pause
Segurança do plugin
Recursos: Basic
RunService:Pause():()
Devolução
()

Reset
Obsoleto

Run
Segurança do plugin
Recursos: Basic
RunService:Run():()
Devolução
()

SetPredictionMode
Recursos: Basic
RunService:SetPredictionMode(
):()
Parâmetros
context:Instance
Devolução
()

Stop
Segurança do plugin
Recursos: Basic
RunService:Stop():()
Devolução
()

UnbindFromRenderStep
Recursos: Basic
RunService:UnbindFromRenderStep(name:string):()
Parâmetros
name:string
Devolução
()

Eventos
Heartbeat
Recursos: Basic
RunService.Heartbeat(deltaTime:number):RBXScriptSignal
Parâmetros
deltaTime:number

Misprediction
Recursos: Basic, PluginOrOpenCloud
RunService.Misprediction(
time:number, instances:{any}, stats:Dictionary
Parâmetros
time:number
instances:{any}

PostSimulation
Recursos: Basic
RunService.PostSimulation(deltaTimeSim:number):RBXScriptSignal
Parâmetros
deltaTimeSim:number

PreAnimation
Recursos: Basic
RunService.PreAnimation(deltaTimeSim:number):RBXScriptSignal
Parâmetros
deltaTimeSim:number

PreRender
Recursos: Basic
RunService.PreRender(deltaTimeRender:number):RBXScriptSignal
Parâmetros
deltaTimeRender:number

PreSimulation
Recursos: Basic
RunService.PreSimulation(deltaTimeSim:number):RBXScriptSignal
Parâmetros
deltaTimeSim:number

RenderStepped
Recursos: Basic
RunService.RenderStepped(deltaTime:number):RBXScriptSignal
Parâmetros
deltaTime:number

Rollback
Recursos: Basic
RunService.Rollback(time:number):RBXScriptSignal
Parâmetros
time:number

Stepped
Recursos: Basic
RunService.Stepped(
time:number, deltaTime:number
Parâmetros
time:number
deltaTime:number

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.