每个 组件 在 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。为了支持这些场景,连接到驱动关节的组件使用更严格的睡眠速度阈值。这延迟了这些组件进入睡眠状态的时间,允许缓慢、受控的运动,而不会让物理系统过早地将它们置于睡眠状态。
以下被视为驱动关节:
额外的唤醒情况
与另一个移动速度超过 1 studs/s 的组件发生碰撞时。
通过 ApplyImpulse()、ApplyImpulseAtPosition() 或 ApplyAngularImpulse() 对组件内的任何 BasePart 应用非零冲击。
Workspace 上的任何物理相关属性发生变化,这将影响组件,包括:
创建一个新的 Constraint,其 Attachment 连接到组件内的 BasePart。
对连接到组件内的 BasePart 的 Constraint 进行任何属性更改。
连接到组件内的 BasePart 的 CurrentAngle 属性发生变化。
组件包含一个有玩家角色坐着的 VehicleSeat。
组件位于 BlastRadius 内的 Explosion 中。
调试可视化
在游戏测试期间,你可以通过在 3D 视口右上角的 可视化选项 小部件中切换 清醒部件 来可视化组件的睡眠状态。

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