睡眠系统

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处。

每个 组件 在 Roblox 引擎中对应一个单一的 刚体。每个刚体的位置和速度描述了它的位置和移动速度,而引擎的主要任务之一是更新每个组件的位置和速度。

组件可以通过 机械约束 和 移动约束 连接在一起,形成如汽车或飞机等机制。随着机制中组件和约束的数量增加,模拟该机制所需的时间也会增加。幸运的是,当 睡眠系统 确定引擎可以跳过对不移动组件的模拟时,这种增加会被抵消。

睡眠状态

每个组件可以处于三种状态之一:清醒、睡眠 或 睡眠检查。

清醒

一个 清醒 的组件正在移动或加速,因此会被模拟。组件从 睡眠 和 睡眠检查 中的情况进入此状态,以及 额外的唤醒情况。

睡眠

一个 睡眠 的组件既不移动也不加速,因此不会被模拟。

通过检查其 线性速度 和 旋转速度 来确定组件是否不移动。如果其线性速度小于 线性速度 阈值,并且其旋转速度小于 旋转速度 阈值,则该组件被认为是不移动的。

在某些情况下,仅仅检查不移动会导致组件错误地进入睡眠状态。例如,如果一个球被垂直向上抛出,当它达到最大高度时,其速度接近零,使其成为候选者进入睡眠状态而永远不会掉下来。为了解决这种情况,如果组件的 线性加速度 或 旋转加速度 大于 线性加速度 和 旋转加速度 阈值,引擎会认为该组件正在加速,并会阻止该组件进入睡眠状态。

睡眠检查

一个与至少一个 清醒 邻近组件共享约束的非移动组件被置于 睡眠检查 状态,并且不被模拟。在每个世界步骤中,睡眠检查组件检查以下条件:

如果这些条件中的任何一个为真,或者在任何 额外的唤醒情况 下,睡眠检查组件将进入 清醒 状态。

阈值参考

下表提供了用于确定组件是否移动或加速的各种速度和加速度阈值。

阈值值状态变化
线性速度0.33 studs/s清醒 ⟩ 睡眠
旋转速度0.42 studs/s清醒 ⟩ 睡眠
线性加速度0.24 studs/s²清醒 ⟩ 睡眠
旋转加速度0.24 studs/s²清醒 ⟩ 睡眠
邻近线性速度0.48 studs/s睡眠检查 ⟩ 清醒
邻近旋转速度0.59 studs/s睡眠检查 ⟩ 清醒
唤醒线性加速度16.9 studs/s²清醒 ⟩ 睡眠
唤醒旋转加速度16.9 studs/s²清醒 ⟩ 睡眠

旋转速度和加速度阈值反映了位于组件边界球(包含组件中所有部件的球体)上的点的速度和加速度,该点与组件一起刚性移动。

驱动关节

有时开发者希望使用 驱动关节 以非常慢的速度移动部件,这是一种施加力或运动以驱动连接部件的约束,例如使用 HingeConstraint 和 Motor。为了支持这些场景,连接到驱动关节的组件使用更严格的睡眠速度阈值。这延迟了这些组件进入睡眠状态的时间,允许缓慢、受控的运动,而不会让物理系统过早地将它们置于睡眠状态。

以下被视为驱动关节:

额外的唤醒情况

除了在 睡眠检查 和 睡眠 中概述的情况外,当组件:

调试可视化

在游戏测试期间,你可以通过在 3D 视口右上角的 可视化选项 小部件中切换 清醒部件 来可视化组件的睡眠状态。

3D 视口的特写视图,右上角指示了可视化选项按钮。

启用后,模拟的部件将根据其当前睡眠状态进行轮廓标记, 清醒 部件用红色标记, 睡眠检查 部件用橙色标记, 睡眠 部件则不标记。

根据其当前睡眠状态用颜色标记的模拟部件
©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。