배우기
엔진 클래스
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("델타 검사", 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}

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

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

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