學習
引擎類別
RunService
無法建立
服務
未複製

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡



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 = "打印你好"
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 是我們在美國及其他國家地區的部分註冊與未註冊商標。