一个 **CylindricalConstraint** 允许其附件沿一个轴滑动并围绕另一个轴旋转。可以将其视为 `Class.PrismaticConstraint` 和 `Class.HingeConstraint` 的结合体。滑动轴由约束的 **X** 轴决定
`Class.Constraint.Attachment0|Attachment0`。旋转轴位于约束的 `Class.Constraint.Attachment1|Attachment1` 中心，并且与滑动约束的角度由约束的
`Class.CylindricalConstraint.InclinationAngle|InclinationAngle` 决定。

此约束与 `Class.SpringConstraint` 一起，适合构建车辆悬挂。

请注意，如果此约束将一个部件 (**A**) 附加到另一个部件 (**B**)，而 **B** 是锚定的或连接到锚定部件 (**Z**)，则在与玩家交互时，部件 **A** 将不会被局部模拟。

在配置此约束时，了解如何将 Roblox 单位与公制单位进行比较可能会对您有所帮助，[Roblox 单位](/physics/units) 是一个很好的资源。

#### 角动能

如果一个圆柱体的 `Class.CylindricalConstraint.AngularActuatorType|AngularActuatorType` 被设置为 `Enum.ActuatorType|Motor`，它会尝试以达到它的 `Class.CylindricalConstraint.AngularVelocity|AngularVelocity` 为目标来旋转附件。您可以通过 `Class.CylindricalConstraint.MotorMaxAngularAcceleration|MotorMaxAngularAcceleration` 和 `Class.CylindricalConstraint.MotorMaxTorque|MotorMaxTorque` 进一步控制这个旋转。如果一个圆柱体的 `Class.CylindricalConstraint.AngularActuatorType|AngularActuatorType` 被设置为 `Enum.ActuatorType|Servo`，它会尝试旋转到由 `Class.CylindricalConstraint.TargetAngle|TargetAngle` 指定的角度。这个旋转由 `Class.CylindricalConstraint.AngularSpeed|AngularSpeed`、`Class.CylindricalConstraint.AngularResponsiveness|AngularResponsiveness` 和 `Class.CylindricalConstraint.ServoMaxTorque|ServoMaxTorque` 控制。

#### 线性功率

如果一个圆柱体的 `Class.CylindricalConstraint|ActuatorType` 被设置为 `Enum.ActuatorType|Motor`，它会尝试以达到 `Class.CylindricalConstraint|Velocity` 为目标来平移附件。您可以通过 `Class.CylindricalConstraint|MotorMaxAcceleration` 和 `Class.CylindricalConstraint|MotorMaxForce` 进一步控制这个平移。如果一个圆柱体的 `Class.CylindricalConstraint|ActuatorType` 被设置为 `Enum.ActuatorType|Servo`，它会尝试将附件平移到由 `Class.CylindricalConstraint|TargetPosition` 指定的设定分离。这个平移由 `Class.CylindricalConstraint|Speed`、`Class.CylindricalConstraint|LinearResponsiveness` 和 `Class.CylindricalConstraint|ServoMaxForce` 控制。

#### 限制

您可以设置限制以限制圆柱约束的 **滑动范围** 和 **旋转**。启用 `Class.CylindricalConstraint|LimitsEnabled` 属性将显示 `Class.CylindricalConstraint|LowerLimit` 和 `Class.CylindricalConstraint|UpperLimit` 值，以及 `Class.CylindricalConstraint|Restitution`，该值定义当它们达到任一限制时附件的弹性。启用 `Class.CylindricalConstraint.AngularLimitsEnabled|AngularLimitsEnabled` 属性将显示 `Class.CylindricalConstraint.LowerAngle|LowerAngle` 和 `Class.CylindricalConstraint.UpperAngle|UpperAngle` 限制，以及 `Class.CylindricalConstraint.AngularRestitution|AngularRestitution`，该值定义当它们达到任一限制时附件的弹性。

#### 倾斜角

`Class.CylindricalConstraint.InclinationAngle|InclinationAngle` 定义旋转轴的方向，作为距离 `Class.Constraint.Attachment0|Attachment0` 的 **X** 轴的一个角度，范围从 -180 到 180。这使得您可以在不改变滑动轴的情况下倾斜旋转元素。


CylindricalConstraint

如果一个圆柱体的 `Class.CylindricalConstraint.AngularActuatorType|AngularActuatorType` 被设置为 `Enum.ActuatorType|Motor`，它会尝试旋转附件以达到它的 `Class.CylindricalConstraint.AngularVelocity|AngularVelocity` 为目标。您可以通过 `Class.CylindricalConstraint.MotorMaxAngularAcceleration|MotorMaxAngularAcceleration` 和 `Class.CylindricalConstraint.MotorMaxTorque|MotorMaxTorque` 进一步控制这个旋转。 

如果一个圆柱体的 `Class.CylindricalConstraint.AngularActuatorType|AngularActuatorType` 被设置为 `Enum.ActuatorType|Servo`，它会尝试旋转到由 `Class.CylindricalConstraint.TargetAngle|TargetAngle` 指定的角度。这个旋转由 `Class.CylindricalConstraint.AngularSpeed|AngularSpeed`、`Class.CylindricalConstraint.AngularResponsiveness|AngularResponsiveness` 和 `Class.CylindricalConstraint.ServoMaxTorque|ServoMaxTorque` 控制。


CylindricalConstraint.AngularActuatorType

CylindricalConstraint.AngularLimitsEnabled

此属性指定角伺服电机在达到 `Class.CylindricalConstraint.TargetAngle|TargetAngle` 的精度，当 `Class.CylindricalConstraint.AngularActuatorType|AngularActuatorType` 被设置为 `Enum.ActuatorType|Servo` 时。较大的值对应较快的响应，而较小的值导致较大的阻尼和较慢的响应。


CylindricalConstraint.AngularResponsiveness

指定角伺服电机在达到 `Class.CylindricalConstraint.TargetAngle|TargetAngle` 时的精度。


两个限制的弹性，或者说它们的弹性。范围在 0 和 1 之间。


CylindricalConstraint.AngularRestitution

两个限制的弹性，或者说它们的弹性程度。


目标角速度。该值为无符号，因为伺服将始终移动到其目标。以弧度每秒为单位。


CylindricalConstraint.AngularSpeed

电机在旋转轴周围的目标角速度，单位为弧度每秒。


CylindricalConstraint.AngularVelocity

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的符号角度（单位为度），围绕旋转轴。有效范围在 -180 和 180 之间。


CylindricalConstraint.CurrentAngle

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的符号角度（单位为度），围绕旋转轴。


旋转轴的方向，作为 `Class.Constraint.Attachment0|Attachment0` 的 **X** 轴在 **XY** 平面中的一个角度。有效范围在 -180 和 180 之间。


CylindricalConstraint.InclinationAngle

旋转轴的方向，作为 `Class.Constraint.Attachment0|Attachment0` 的 **X** 轴在 **XY** 平面中的一个角度。


参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的角度的下限（单位为度），围绕旋转轴。有效范围在 -180 和 180 之间。


CylindricalConstraint.LowerAngle

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的角度的下限（单位为度），围绕旋转轴。


电机的最大角加速度，单位为弧度每秒平方。


CylindricalConstraint.MotorMaxAngularAcceleration

电机为实现目标角速度而能施加的最大扭矩。单位为 质量&nbsp;&times;&nbsp;studs&sup2;/秒&sup2;。


CylindricalConstraint.MotorMaxTorque

电机为实现目标角速度而能施加的最大扭矩。


CylindricalConstraint.RotationAxisVisible

伺服电机能施加的最大扭矩。单位为 质量&nbsp;&times;&nbsp;studs&sup2;/秒&sup2;。


CylindricalConstraint.ServoMaxTorque

CylindricalConstraint.SoftlockAngularServoUponReachingTarget

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的目标角度（单位为度），围绕旋转轴。有效范围在 -180 和 180 之间。


CylindricalConstraint.TargetAngle

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的目标角度（单位为度），围绕旋转轴。


参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的角度的上限（单位为度），围绕旋转轴。有效范围在 -180 和 180 之间。


CylindricalConstraint.UpperAngle

参考轴和 `Class.Constraint.Attachment1|Attachment1` 的副轴之间的角度的上限（单位为度），围绕旋转轴。


旋转轴在世界坐标中的单位向量方向。


CylindricalConstraint.WorldRotationAxis

约束两个部件上的两个附件具有相对直线和旋转运动。


**SlidingBallConstraint** 是允许其附加物沿轴滑动的约束的基类，包括 `Class.PrismaticConstraint` 和 `Class.CylindricalConstraint`。基类不限制旋转。`Class.PrismaticConstraint` 防止旋转，而 `Class.CylindricalConstraint` 允许围绕轴旋转。

在配置此约束时，研究 [Roblox Units](/physics/units) 可能会有所帮助，以了解 Roblox 单位与公制单位的比较。

#### 线性功率

如果此约束的 `Class.SlidingBallConstraint|ActuatorType` 设置为 `Enum.ActuatorType|Motor`，它会尝试以达到 `Class.SlidingBallConstraint|Velocity` 为目标来移动附加物。您可以通过 `Class.SlidingBallConstraint|MotorMaxAcceleration` 和 `Class.SlidingBallConstraint|MotorMaxForce` 进一步控制此移动。

如果此约束的 `Class.SlidingBallConstraint|ActuatorType` 设置为 `Enum.ActuatorType|Servo`，它会尝试将附加物移动到由 `Class.SlidingBallConstraint|TargetPosition` 指定的设定间隔。此移动由 `Class.SlidingBallConstraint|Speed`、`Class.SlidingBallConstraint|LinearResponsiveness` 和 `Class.SlidingBallConstraint|ServoMaxForce` 控制。

#### 限制

您可以设置 **限制** 来限制此约束的滑动范围。启用 `Class.SlidingBallConstraint|LimitsEnabled` 属性会暴露 `Class.SlidingBallConstraint|LowerLimit` 和 `Class.SlidingBallConstraint|UpperLimit` 值，以及定义附加物在达到任一限制时的弹性特性的 `Class.SlidingBallConstraint|Restitution`。


SlidingBallConstraint

设置 `Class.SlidingBallConstraint` 的平移是否为激活状态，如果是，则激活的类型。

- 如果 `Class.SlidingBallConstraint|ActuatorType` 设置为
  `Enum.ActuatorType|None`，关节可以自由滑动。

- 如果 `Class.SlidingBallConstraint|ActuatorType` 设置为
  `Enum.ActuatorType|Motor`，它试图将附加物进行平移，以达到 `Class.SlidingBallConstraint|Velocity`。您可以
  通过 `Class.SlidingBallConstraint|MotorMaxAcceleration` 和
  `Class.SlidingBallConstraint|MotorMaxForce` 进一步控制此平移。

- 如果此约束的 `Class.SlidingBallConstraint|ActuatorType` 设置为
  `Enum.ActuatorType|Servo`，它试图将附加物平移到由
  `Class.SlidingBallConstraint|TargetPosition` 指定的设定间隔。此平移通过
  `Class.SlidingBallConstraint|Speed`，
  `Class.SlidingBallConstraint|LinearResponsiveness` 和
  `Class.SlidingBallConstraint|ServoMaxForce` 控制。

SlidingBallConstraint.ActuatorType

设置 `Class.SlidingBallConstraint` 的平移是否为激活状态，如果是，则激活的类型。

约束的当前偏移量
`Class.Attachment|Attachments`。

SlidingBallConstraint.CurrentPosition

设置 `Class.SlidingBallConstraint` 是否会限制平移范围。如果为 true，则此属性会暴露 `Class.SlidingBallConstraint|LowerLimit` 和
`Class.SlidingBallConstraint|UpperLimit` 值，以及 `Class.SlidingBallConstraint|Restitution`，它定义了附加物在达到任一限制时的弹性。

SlidingBallConstraint.LimitsEnabled

设置 `Class.SlidingBallConstraint` 是否会限制平移范围。

指定线性伺服电机在到达 `Class.SlidingBallConstraint.TargetPosition|TargetPosition` 时的"尖锐度"，
当派生类的激活类型设置为 `Enum.ActuatorType|Servo`。较大的值对应于更快的响应，较小的值则导致更大的阻尼和更慢的响应。

SlidingBallConstraint.LinearResponsiveness

指定线性伺服电机在到达 `Class.SlidingBallConstraint.TargetPosition|TargetPosition` 时的"尖锐度"。

如果 `Class.SlidingBallConstraint.LimitsEnabled|LimitsEnabled` 为 true，则
`Class.Constraint.Attachment0|Attachment0` 的 **X** 轴的下限位置。

SlidingBallConstraint.LowerLimit

约束的最大加速度当
`Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Motor` 时，约束试图达到其期望的
`Class.SlidingBallConstraint.Velocity|Velocity`。

SlidingBallConstraint.MotorMaxAcceleration

约束的最大力量当
`Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Motor`，约束试图达到其期望的
`Class.SlidingBallConstraint.Velocity|Velocity`。

SlidingBallConstraint.MotorMaxForce

当约束的 `Class.Attachment|Attachments` 到达由
`Class.SlidingBallConstraint.UpperLimit|UpperLimit` 和
`Class.SlidingBallConstraint.LowerLimit|LowerLimit` 指定的范围的末端时的弹性，假设
`Class.SlidingBallConstraint.LimitsEnabled|LimitsEnabled` 设置为 true。
有效范围为 0&ndash;1。

SlidingBallConstraint.Restitution

当约束的 `Class.Attachment|Attachments` 到达由
`Class.SlidingBallConstraint.UpperLimit|UpperLimit` 和
`Class.SlidingBallConstraint.LowerLimit|LowerLimit` 指定的范围的末端时的弹性，假设
`Class.SlidingBallConstraint.LimitsEnabled|LimitsEnabled` 设置为 true。

约束的最大力量当
`Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Servo`，约束试图达到其期望的
`Class.SlidingBallConstraint.Speed|Speed`。

SlidingBallConstraint.ServoMaxForce

SlidingBallConstraint.Size

SlidingBallConstraint.SoftlockServoUponReachingTarget

约束的期望速度当
`Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Servo`，当约束向其
`Class.SlidingBallConstraint.TargetPosition|TargetPosition` 进行平移时。以每秒 studs 测量。

SlidingBallConstraint.Speed

当 `Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Servo` 时，约束的尝试目标位置。以 studs 测量。

SlidingBallConstraint.TargetPosition

如果 `Class.SlidingBallConstraint.LimitsEnabled|LimitsEnabled` 为 true，则
`Class.Constraint.Attachment0|Attachment0` 的 **X** 轴的上限位置。

SlidingBallConstraint.UpperLimit

当 `Class.SlidingBallConstraint.ActuatorType|ActuatorType` 设置为
`Enum.ActuatorType|Motor` 时，约束的尝试速度。以每秒 studs 测量。

SlidingBallConstraint.Velocity

允许其附加物沿轴滑动的约束的基类。


约束基础类。详细信息请参见
[mover constraints](/physics/mover-constraints) 和
[mechanical constraints](/physics/mechanical-constraints)。

Constraint:GetDebugAppliedForce

bodyId

Constraint:GetDebugAppliedTorque

Constraint

如果约束及其两个部分都在 `Class.Workspace` 中，并且约束的 `Class.Constraint.Enabled` 属性为 `true`，则此属性为 `true`。

Constraint.Active

指示约束当前是否在世界中处于活动状态。

连接到 `Class.Constraint.Attachment1` 的 `Class.Attachment`

Constraint.Attachment0

连接到 `Class.Constraint.Attachment1` 的 `Class.Attachment`。

连接到 `Class.Constraint.Attachment0` 的 `Class.Attachment`

Constraint.Attachment1

连接到 `Class.Constraint.Attachment0` 的 `Class.Attachment`。

Constraint.Color

Constraint.Enabled

Constraint.Visible

`Instance` 是 Roblox 类层次结构中所有类的基类，可以是 `Class.DataModel` 树的一部分。

无法直接创建根 `Instance` 对象，但特殊的 `Datatype.Instance.new()` 构造函数通过代码创建对象，
以类的名称作为参数并返回创建的对象。

演示通过连接到
`Class.Instance.AncestryChanged` 事件来检测实例祖先的变化。

ChangingPart 的父级随着时间的推移而设置为不同的值。该零件的父级是该零件的祖先，因此
`Class.Instance.AncestryChanged` 事件将在每次变化时触发。

当此实例被重新父级化或其任何祖先被重新父级化时触发。

您可以使用此事件跟踪 Studio 中实例的删除，
例如在资源管理器中手动删除或通过插件删除。如果您需要
to 检测何时使用 `Class.Instance:Destroy()` 销毁实例，
请改用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

其 `Class.Instance.Parent|Parent` 属性更改的实例，
可以是此实例或更远的祖先，**不**一定是处理程序连接的实例。

parent

当此对象或其祖先的 `Class.Instance.Parent` 属性更改时触发。

每当实例上的任何属性更改时，此事件都会触发，
包括当属性设置为 `nil` 时。更改的属性名称
传递给连接的函数。

例如，以下代码片段连接 `attributeChanged()`
函数，以便每当部分的属性之一更改时触发：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```
另请参见 `Class.Instance:GetAttributeChangedSignal()`，它返回一个事件，
当特定给定属性更改时触发。

Instance.AttributeChanged

attribute

每当 `Class.Instance` 上的属性更改时触发。

此代码段打印添加到工作区的对象名称：

在对象被父级化到此 `Class.Instance` 之后触发。

注意，在客户端使用此方法检测由服务器创建的对象时，
在索引这些对象的后代时必须使用 `Class.Instance:WaitForChild()`。
这是因为对象及其后代不保证同时从服务器复制到客户端。
例如：

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 使用 WaitForChild()，因为后代可能尚未复制
	local head = child:WaitForChild("Head")
end)
```
注意，此事件仅适用于 `Class.Instance` 的直接子对象。
要捕获所有后代的事件，请使用 `Class.Instance.DescendantAdded`。

另请参见 `Class.Instance.ChildRemoved`。

Instance.ChildAdded

在对象被父级化到此 `Class.Instance` 之后触发。

Instance.childAdded

这个代码片段会在对象从工作区中移除时打印它们的名称：

在子对象从此 `Class.Instance` 中移除后触发。

移除是指对象的父级从此 `Class.Instance` 更改为其他内容。
注意，当子对象被销毁（使用
`Class.Instance:Destroy()`）时，此事件也会触发，因为销毁函数将对象的
父级设置为 `nil`。

此事件仅适用于 `Class.Instance` 的直接子对象。
要捕获所有后代的事件，请使用
`Class.Instance.DescendantRemoving`。

另请参见 `Class.Instance.ChildAdded`。

Instance.ChildRemoved

在子对象从此 `Class.Instance` 中移除后触发。

以下示例将打印添加到
工作区的任何对象的名称：

此事件在后代被添加到 `Class.Instance` 之后触发。

由于它对每个后代触发，将对象父级化到 `Class.Instance` 将单独触发此对象及其所有后代的事件。

如果您只关心 `Class.Instance` 的 **直接子对象**，请改用 `Class.Instance.ChildAdded`。

另请参见 `Class.Instance.DescendantRemoving`。

Instance.DescendantAdded

descendant

在后代被添加到 `Class.Instance` 之后触发。

以下示例在一个后代被移除时打印其名称
从工作区:

此事件在父级 `Class.Instance` 更改之前 **立即触发**，
以至于 **后代** 实例将不再是后代。`Class.Instance:Destroy()|Destroy()` 将实例的
`Class.Instance.Parent|Parent` 更改为 `nil`，因此在父级的后代上调用该方法将导致此事件触发。

由于此事件在后代移除 **之前** 触发，因此在此事件触发时，后代的父级将保持不变。如果后代也是父级的 **直接子对象**，则此事件将在 `Class.Instance.ChildRemoved` 之前触发。

如果后代有子对象，此事件将首先与后代一起触发，
然后是其后代。

#### 警告

此事件与正在移除的后代对象一起触发。
尝试将后代的 `Class.Instance.Parent|Parent` 设置为其他内容将失败。以下是演示此情况的示例：

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 不要在此函数中操作后代的父级！
	-- 此事件触发是因为父级被操作，并且更改尚未发生
	-- 因此，像这样更改父级是有问题的：
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
另请参见 `Class.Instance.DescendantAdded|DescendantAdded`。

Instance.DescendantRemoving

在 `Class.Instance` 的后代被移除之前立即触发。

此示例演示了当使用即时信号行为时，
实例被销毁时仍保持在原位，直到连接的函数挂起。

此示例演示了如何在使用推迟信号行为时，在信号触发之前销毁实例。

在连接的函数仍在使用时，`Class.Instance` 将永远不会从内存中删除。
但是，如果函数在任何时候挂起，`Class.Instance` 及其后代将被父级化为 `nil`。

如果 `Class.Workspace.SignalBehavior` 属性设置为
`Enum.SignalBehavior.Immediate`，则此事件在 `Class.Instance` 或其祖先被销毁之前立即触发，
使用 `Class.Instance:Destroy()`。

如果 `Class.Workspace.SignalBehavior` 属性设置为
`Enum.SignalBehavior.Deferred`，则此事件在下一个恢复点触发，
这将在 `Class.Instance` 或其祖先被销毁后触发，使用 `Class.Instance:Destroy()`。

使用 `Enum.SignalBehavior.Deferred|Deferred` 行为，将脚本连接到其自己的 `Class.Instance.Destroying` 事件是有问题的，
因为脚本将在回调被调用之前被销毁（这意味着它不会执行）。

在 Studio 中删除 `Class.Instance` 时，例如通过 [Explorer](/studio/explorer) 手动删除或通过插件删除，
`Class.Instance` 不会被销毁。相反，父级被设置为 `nil`，
您可以通过 `Class.Instance.AncestryChanged` 跟踪。

Instance.Destroying

在实例通过 `Class.Instance:Destroy()` 被销毁之前立即触发（或被推迟到之后）。

演示 `Class.Instance.StyledPropertiesChanged`。


每当实例上的任何样式属性更改时，此事件都会触发，
包括当属性设置为 `nil` 时。

Instance.StyledPropertiesChanged

每当实例上的任何样式属性更改时触发，包括
当属性设置为 `nil` 时。

此方法将标签应用于实例，如果标签已应用则无效。成功添加标签将触发由 `Class.CollectionService:GetInstanceAddedSignal()` 创建的信号，
并带有给定标签。

#### 警告

- 如果服务器稍后在该实例上添加或删除标签，则客户端添加的实例标签将被丢弃，因为服务器会一起复制所有标签并覆盖先前的标签。

- 在标记实例时，通常会使用一些资源来赋予标签其功能，例如事件连接或表。为了防止内存泄漏，最好在不再需要标签时清理这些资源（断开连接、设置为 `nil` 等）。在调用 `Class.Instance:RemoveTag()`、调用 `Class.Instance:Destroy()` 或在连接到 `Class.CollectionService:GetInstanceRemovedSignal()` 返回的信号的函数中执行此操作。

Instance:AddTag

子级函数返回对象的子级数组。

Instance:children

此方法销毁实例的所有子级和后代。

```
local part = Instance.new("Part")

-- 添加一些闪光
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
如果您不希望销毁 **所有** 子级和后代，请使用 `Class.Instance:GetChildren()` 或 `Class.Instance:GetDescendants()` 循环遍历这些子级/后代并选择要销毁的对象。
例如，以下代码示例将销毁从 `Class.Model` 继承的所有 `Class.BasePart|BaseParts`：

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

演示如何使用 `Class.Instance:Clone()` 克隆一个模型。

`Clone()` 创建实例及其所有后代的副本，忽略所有不为 `Class.Instance.Archivable|Archivable` 的实例。
根实例的副本由此方法返回，其 `Class.Instance.Parent|Parent` 设置为 `nil`。请注意，如果实例本身的 `Class.Instance.Archivable|Archivable` 设置为 `false`，此方法将返回 `nil`。

如果在克隆的实例中设置了引用属性，例如 `Class.ObjectValue.Value`，则副本属性的值取决于原始值：

- 如果引用属性指向的实例 **也** 被克隆，则副本将指向副本。
- 如果引用属性指向的实例 **未** 被克隆，则副本将保持相同的值。

Instance:Clone

实例的副本，如果实例不为 `Class.Instance.Archivable|Archivable` 则为 `nil`。

创建实例及其所有后代的副本，忽略不为 `Class.Instance.Archivable|Archivable` 的实例。

Instance:clone

演示使用 `Class.Instance:Destroy()` 函数销毁一个 Part。

该函数是处理不再需要的对象的正确方法。

将 `Class.Instance.Parent` 属性设置为 `nil`，锁定 `Class.Instance.Parent` 属性，断开所有连接，并对所有子级调用 `Destroy()`。此方法是处理不再需要的对象的正确方法。

处理不需要的对象很重要，因为不必要的对象和连接会消耗内存，随着时间的推移可能导致严重的性能问题。

作为最佳实践，在对对象调用 `Destroy()` 后，将任何引用该对象（或其后代）的变量设置为 `nil`。这可以防止您的代码访问与该对象相关的任何内容。

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 不要这样做：
print(part.Name)  --> "Hello, world"
-- 这样做可以防止上述行工作：
part = nil
```
一旦通过此方法销毁了 `Class.Instance`，则无法重用，因为 `Class.Instance.Parent` 属性被锁定。要 **临时** 移除对象而不是销毁它，请将 `Class.Instance.Parent|Parent` 设置为 `nil`。例如：

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
要在设定的时间后销毁对象，请使用 `Class.Debris:AddItem()`。

Instance:Destroy

将 `Class.Instance.Parent` 属性设置为 `nil`，锁定 `Class.Instance.Parent` 属性，断开所有连接，并对所有子级调用 `Destroy()`。

Instance:destroy

返回 `Class.Instance` 的第一个祖先，其 `Class.Instance.Name` 等于给定名称。

此方法向上工作，意味着它从实例的直接 `Class.Instance.Parent` 开始，向上工作到 `Class.DataModel`。如果未找到匹配的祖先，则返回 `nil`。

以下代码片段将找到名为 `Car` 的对象的第一个祖先。

```
local car = object:FindFirstAncestor("Car")
```
有关查找特定类的祖先的此方法的变体，请参见 `Class.Instance:FindFirstAncestorOfClass()` 和 `Class.Instance:FindFirstAncestorWhichIsA()`。

Instance:FindFirstAncestor

name

返回 `Class.Instance` 的第一个祖先，其 `Class.Instance.Name` 等于给定名称。

返回 `Class.Instance` 的第一个祖先，其 `Class.Object.ClassName` 等于给定 className。

此方法向上工作，意味着它从实例的直接 `Class.Instance.Parent` 开始，向上工作到 `Class.DataModel`。如果未找到匹配的祖先，则返回 `nil`。

此方法的常见用法是查找 `Class.BasePart` 所属的 `Class.Model`。例如：

```
local model = part:FindFirstAncestorOfClass("Model")
```
此方法是 `Class.Instance:FindFirstAncestor()` 的变体，检查 `Class.Object.ClassName` 属性，而不是 `Class.Instance.Name`。`Class.Instance:FindFirstAncestorWhichIsA()` 也存在，使用 `Class.Object:IsA()` 方法来尊重类继承。

Instance:FindFirstAncestorOfClass

className

返回 `Class.Instance` 的第一个祖先，其 `Class.Object.ClassName` 等于给定 className。

返回 `Class.Instance` 的第一个祖先，`Class.Object:IsA()` 对于给定的 className 返回 true。

此方法向上工作，意味着它从实例的直接 `Class.Instance.Parent` 开始，向上工作到 `Class.DataModel`。如果未找到匹配的祖先，则返回 `nil`。

与 `Class.Instance:FindFirstAncestorOfClass()` 不同，此方法使用 `Class.Object:IsA()`，它尊重类继承。例如：

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
因此，以下代码示例将返回第一个 `Class.BasePart` 祖先，无论它是 `Class.WedgePart`、`Class.MeshPart` 还是 `Class.Part`。

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
另请参见 `Class.Instance:FindFirstAncestor()`。

Instance:FindFirstAncestorWhichIsA

返回 `Class.Instance` 的第一个祖先，`Class.Object:IsA()` 对于给定的 className 返回 true。

下面的代码将在工作区中查找名为“Brick”的对象。如果找到，它将把该对象的名称更改为“Foo”。

返回具有给定名称的 `Class.Instance` 的第一个子级，如果不存在这样的子级则返回 `nil`。如果可选的 `recursive` 参数为 `true`，此方法将搜索所有后代，而不仅仅是 `Class.Instance` 的直接子级。

#### 检查对象的存在性

如果您需要在继续之前验证对象是否存在，则需要使用 `FindFirstChild()`。尝试使用点运算符按名称索引子级，如果子级不存在将引发错误。

```lua
local Workspace = game:GetService("Workspace")

-- 如果部件不存在于工作区，以下行将出错
Workspace.Part.Transparency = 0.5
```
更好的方法是使用 `FindFirstChild()` 首先检查 `Part`，然后使用 `if` 语句运行需要它的代码。

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### 查找名称与属性匹配的子级

有时对象的 `Class.Instance.Name|Name` 与其 `Class.Instance.Parent|Parent` 的属性相同。当使用点运算符时，如果它们共享名称，属性优先于子级。

在以下示例中，添加到 `Class.Part` 的名为 `Color` 的 `Class.Folder`，它也具有 `Class.Part.Color` 属性。请注意，`part.Color` 指的是 `Datatype.Color3` 属性值，而不是子级 `Class.Folder` 实例。使用 `Class.Instance:FindFirstChild()|FindFirstChild()` 的好处是引入新属性不会对您的代码造成风险。

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 属性
local c2 = part:FindFirstChild("Color")  -- 子文件夹
```

#### 性能注意事项

`Class.Instance:FindFirstChild()|FindFirstChild()` 的执行时间比使用点运算符长约 20%，并且比简单存储对象引用的时间长近 8 倍。因此，您应该避免在性能依赖的代码中调用它，例如在紧密循环或连接到 `Class.RunService.Heartbeat` 和 `Class.RunService.PreRender` 的函数中。相反，将结果存储在变量中，或考虑使用 `Class.Instance.ChildAdded|ChildAdded` 或 `Class.Instance:WaitForChild()|WaitForChild()` 来检测给定名称的子级何时可用。

Instance:FindFirstChild

recursive

返回具有给定名称的 `Class.Instance` 的第一个子级。

Instance:findFirstChild

返回 `Class.Instance` 的第一个子级，其 `Class.Object.ClassName|ClassName` 等于给定 `className`。与 `Class.Instance:FindFirstChildWhichIsA()` 不同，此方法仅返回类与 `className` 匹配的对象，忽略类继承。如果未找到匹配的子级，则此方法返回 `nil`。

Instance:FindFirstChildOfClass

返回 `Class.Instance` 的第一个子级，其 `Class.Object.ClassName|ClassName` 等于给定类名。

返回 `Class.Instance` 的第一个子级，`Class.Object:IsA()` 对于给定的 className 返回 true。

如果未找到匹配的子级，则此方法返回 `nil`。如果可选的递归参数为 true，此方法将搜索所有后代，而不仅仅是 `Class.Instance` 的直接子级。

与 `Class.Instance:FindFirstChildOfClass()` 不同，此方法使用 `Class.Object:IsA()`，它尊重类继承。例如：

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
因此，以下代码示例将返回第一个 `Class.BasePart` 子级，无论它是 `Class.WedgePart`、`Class.MeshPart` 还是 `Class.Part`。

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
开发者在按名称查找子级时，应使用 `Class.Instance:FindFirstChild()`。

Instance:FindFirstChildWhichIsA

返回 `Class.Instance` 的第一个子级，`Class.Object:IsA()` 对于给定的 className 返回 true。

返回具有给定 `Class.Instance.Name` 的第一个后代。

此方法已禁用，无法使用。要查找实例的第一个后代，请考虑在 `Class.Instance:FindFirstChild()` 上使用 `recursive` 参数。

Instance:FindFirstDescendant

返回具有给定 `Class.Instance.Name` 的第一个后代。

如果 `Class.Instance` 是 `Class.Actor`，则返回 `Class.Actor` 本身。否则，返回其最近的祖先 `Class.Actor`。如果没有祖先是 `Class.Actor`，则结果为 `nil`。

Instance:GetActor

返回与实例关联的 `Class.Actor`（如果有）。

此方法返回已分配给给定属性名称的值。如果未分配任何属性，则返回 `nil`。

例如，以下代码片段设置并获取实例的 `InitialPosition` 属性的值：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### 另请参见

- `Class.Instance:SetAttribute()`，将具有给定名称的属性设置为给定值。
- `Class.Instance:GetAttributes()`，返回每个实例属性的键值对字典。

Instance:GetAttribute

已分配给给定属性名称的值。如果未分配任何属性，则返回 `nil`。

返回已分配给给定属性名称的值。

此方法返回一个事件，其行为与 `Class.Object.Changed|Changed` 事件完全相同，
只是在特定给定属性更改时触发；实际上，它类似于 `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`，但用于属性。

通常，使用此方法而不是连接到 `Class.Object.Changed|Changed` 的函数来检查属性名称是个好主意。对同一对象的后续调用，使用相同的属性名称将返回相同的事件。

以下代码示例返回一个信号，当部件的 `InitialPosition` 属性更改时触发 `attributeChanged()` 函数：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("属性已更改")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
另请参见 `Class.Instance.AttributeChanged`，它在实例上的任何属性更改时触发。

Instance:GetAttributeChangedSignal

要返回更改信号的指定属性名称。

在给定属性更改时触发的事件。

返回在给定属性更改时触发的事件。

此方法返回每个属性的键值对字典，其中键是属性的名称，值是非 `nil` 值。

例如，以下代码片段输出实例的属性和值：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
另请参见 `Class.Instance:GetAttribute()`，返回已分配给给定属性名称的值。

Instance:GetAttributes

每个属性的字符串 → 变体对的字典，其中字符串是属性的名称，变体是非 `nil` 值。

下面代码将在运行时打印当前在工作区中的所有对象的名称。

返回一个数组（一个数字索引的表），包含实例的所有直接子级，或每个 `Class.Instance` 其 `Class.Instance.Parent|Parent` 等于该对象。可以使用数字或通用 `for` 循环对数组进行迭代：

```lua
local Workspace = game:GetService("Workspace")

-- 数字循环示例
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " 是第 " .. i .. " 个子级")
end
```

```lua
local Workspace = game:GetService("Workspace")

-- 通用循环示例
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " 是第 " .. i .. " 个子级")
end
```
请注意，返回的数组 **未** 按任何特定顺序排序，因此建议手动排序（例如使用 `Library.table.sort()`）以对该方法返回的子级进行排序。

另请参见 `Class.Instance:GetDescendants()|GetDescendants()` 方法。

Instance:GetChildren

返回包含实例所有子级的数组。

Instance:getChildren

返回 Roblox 内部使用的调试 ID 的编码字符串。请注意：

- 此项是受保护的。在 `Class.Script` 或 `Class.LocalScript` 中尝试使用它将导致错误。
- 调试 ID 是在调试过程中使用的 ID。它允许调试器在应用程序处理之前读取每个指令。Roblox 中的所有对象都像进程一样运行，每个运行指令（或 '代码'）在需要时可以进行调试。
- 这对于需要区分相似对象的插件（例如共享相同名称的对象）可能很有帮助。

Instance:GetDebugId

scopeLength

返回 Roblox 内部使用的调试 ID 的编码字符串。

GetDescendants 通常用于对特定类型的对象的所有后代执行某些操作。此示例中的代码使用 GetDescendants 和
`Class.Instance:IsA()` 来查找工作区中的所有部件并将它们变为绿色。

此对象方法返回一个数组，包含该对象的所有后代。与 `Class.Instance:GetChildren()` 不同，后者仅返回对象的直接子级，此方法查找对象的每个子级、每个子级的每个子级，依此类推。

请注意，返回的数组 **未** 按任何特定顺序排序，因此建议手动排序（例如使用 `Library.table.sort()`）以对该方法返回的后代进行排序。还可以考虑使用 `Class.Instance:QueryDescendants()|QueryDescendants()` 方法通过选择器和组合器的组合查询后代。

Instance:GetDescendants

返回包含实例所有后代的数组。

Instance

`Instance` 是 Roblox 类层次结构中所有类的基类，可以是 `Class.DataModel` 树的一部分。

/reference/engine/classes/CylindricalConstraint.yaml

摘要