学习
引擎类
RunService
无法创建
服务
未复制

*此内容使用人工智能(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) -- 也可以工作,但不推荐
运行服务自定义函数
local RunService = game:GetService("RunService")
local function checkDelta(deltaTime)
print("上一个渲染步骤以来的时间:", deltaTime)
end
RunService:BindToRenderStep("检查时间差", Enum.RenderPriority.First.Value, checkDelta)
绑定和解绑一个函数
local RunService = game:GetService("RunService")
-- 第一步:声明函数和名称
local NAME = "打印你好"
local function printHello()
print("你好")
end
-- 第二步:绑定函数
RunService:BindToRenderStep(NAME, Enum.RenderPriority.First.Value, printHello)
-- 第三步:解绑函数
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 是我们在美国及其他国家或地区的注册与未注册商标。