배우기
엔진 클래스
RunService
만들 수 없음
서비스
복제되지 않음

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.



API 참조
속성
ClientGitHash
읽기 전용
복제되지 않음
Roblox 스크립트 보안
병렬 읽기
기능: Basic
RunService.ClientGitHash:string

RunState
복제되지 않음
플러그인 보안
병렬 읽기
기능: Basic
RunService.RunState:Enum.RunState

메서드
BindToRenderStep
기능: Basic
RunService:BindToRenderStep(
name:string, priority:number, function:function
):()
매개 변수
name:string
priority:number
function:function
반환
()
코드 샘플
원 안에서 이동하는 프레임
local RunService = game:GetService("RunService")
-- 프레임이 이동해야 하는 속도
local SPEED = 2
local frame = script.Parent
frame.AnchorPoint = Vector2.new(0.5, 0.5)
-- 원의 간단한 매개변수 방정식
-- 중심이 (0.5, 0.5)이고 반지름이 (0.5)인 원
local function circle(t)
return 0.5 + math.cos(t) * 0.5, 0.5 + math.sin(t) * 0.5
end
-- 현재 시간을 추적합니다
local currentTime = 0
local function onRenderStep(deltaTime)
-- 현재 시간을 업데이트합니다
currentTime = currentTime + deltaTime * SPEED
-- ...그리고 프레임의 위치를 업데이트합니다
local x, y = circle(currentTime)
frame.Position = UDim2.new(x, 0, y, 0)
end
-- 이것은 단지 시각적 효과이므로 "Last" 우선 순위를 사용합니다
RunService:BindToRenderStep("FrameCircle", Enum.RenderPriority.Last.Value, onRenderStep)
--RunService.RenderStepped:Connect(onRenderStep) -- 이것도 작동하지만 권장되지 않습니다
RunService 사용자 정의 함수
local RunService = game:GetService("RunService")
local function checkDelta(deltaTime)
print("마지막 렌더 단계 이후 경과 시간:", deltaTime)
end
RunService:BindToRenderStep("Check delta", Enum.RenderPriority.First.Value, checkDelta)
함수를 바인딩하고 언바인딩하기
local RunService = game:GetService("RunService")
-- 1단계: 함수와 이름 선언
local NAME = "Print Hello"
local function printHello()
print("안녕하세요")
end
-- 2단계: 함수 바인딩
RunService:BindToRenderStep(NAME, Enum.RenderPriority.First.Value, printHello)
-- 3단계: 함수 언바인딩
RunService:UnbindFromRenderStep(NAME)

BindToSimulation
기능: Basic
RunService:BindToSimulation(
function:function, frequency:Enum.StepFrequency, priority:number
매개 변수
function:function
기본값: "Hz30"
priority:number
기본값: 2000
코드 샘플
부품의 색상 속성 동기화
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
기능: Basic
시뮬레이션 액세스
RunService:GetPredictionStatus(context:Instance):Enum.PredictionStatus
매개 변수
context:Instance

IsClient
병렬 쓰기
기능: Basic
RunService:IsClient():boolean
반환

IsEdit
플러그인 보안
병렬 쓰기
기능: Basic
RunService:IsEdit():boolean
반환

IsRunMode
병렬 쓰기
기능: Basic
RunService:IsRunMode():boolean
반환

IsRunning
기능: Basic
RunService:IsRunning():boolean
반환

IsServer
병렬 쓰기
기능: Basic
RunService:IsServer():boolean
반환

IsStudio
병렬 쓰기
기능: Basic
RunService:IsStudio():boolean
반환

Pause
플러그인 보안
기능: Basic
RunService:Pause():()
반환
()

Reset
사용되지 않음

Run
플러그인 보안
기능: Basic
RunService:Run():()
반환
()

SetPredictionMode
기능: Basic
RunService:SetPredictionMode(
):()
매개 변수
context:Instance
반환
()

Stop
플러그인 보안
기능: Basic
RunService:Stop():()
반환
()

UnbindFromRenderStep
기능: Basic
RunService:UnbindFromRenderStep(name:string):()
매개 변수
name:string
반환
()

이벤트
Heartbeat
기능: Basic
RunService.Heartbeat(deltaTime:number):RBXScriptSignal
매개 변수
deltaTime:number

Misprediction
기능: Basic, PluginOrOpenCloud
RunService.Misprediction(
time:number, instances:{any}, stats:Dictionary
매개 변수
time:number
instances:{any}
코드 샘플
오차 예측
local RunService = game:GetService("RunService")
RunService.Misprediction:Connect(function(time, instances, stats)
print(`t={time}에서의 오차 예측, 재시뮬레이션 시간={stats.ResimulationTime}s`)
for _, entry in instances do
print(` 인스턴스: {entry.Instance:GetFullName()}`)
if entry.Properties then
for name, values in entry.Properties do
print(` 속성 '{name}': 예측됨={values.Predicted}, 권위 있는={values.Authoritative}`)
end
end
if entry.Attributes then
for name, values in entry.Attributes do
print(` 속성 '{name}': 예측됨={values.Predicted}, 권위 있는={values.Authoritative}`)
end
end
end
end)

PostSimulation
기능: Basic
RunService.PostSimulation(deltaTimeSim:number):RBXScriptSignal
매개 변수
deltaTimeSim:number

PreAnimation
기능: Basic
RunService.PreAnimation(deltaTimeSim:number):RBXScriptSignal
매개 변수
deltaTimeSim:number

PreRender
기능: Basic
RunService.PreRender(deltaTimeRender:number):RBXScriptSignal
매개 변수
deltaTimeRender:number

PreSimulation
기능: Basic
RunService.PreSimulation(deltaTimeSim:number):RBXScriptSignal
매개 변수
deltaTimeSim:number

RenderStepped
기능: Basic
RunService.RenderStepped(deltaTime:number):RBXScriptSignal
매개 변수
deltaTime:number

Rollback
기능: Basic
RunService.Rollback(time:number):RBXScriptSignal
매개 변수
time:number
코드 샘플
롤백
local RunService = game:GetService("RunService")
local stateHistory = {} -- 고정 단계별로 추적되는 사용자 정의 상태
RunService.Rollback:Connect(function(time)
-- 롤백된 단계보다 최신의 사용자 정의 상태를 폐기합니다.
-- 그리고 재시뮬레이션이 시작되기 전에 그 단계의 상태를 복원합니다.
for step, _ in stateHistory do
if step > time then
stateHistory[step] = nil
end
end
end)

Stepped
기능: Basic
RunService.Stepped(
time:number, deltaTime:number
매개 변수
time:number
deltaTime:number

©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.