TriangleMeshPart 是一个抽象中间类，`Class.MeshPart` 和 `Class.PartOperation` 继承自它。它的创建目的是为了整合两个子类之间物理几何属性的管理。它实现了只读的 `Class.TriangleMeshPart.CollisionFidelity|CollisionFidelity` 和 `Class.TriangleMeshPart.CollisionPrecision|CollisionPrecision`。


TriangleMeshPart

此属性确定`Class.TriangleMeshPart`的碰撞模型与网格的实际几何
之间的关系。此属性在运行时无法被脚本读取或操作。

有关各种选项的可视化表示，请参见[此处](/workspace/collisions#collision-fidelity)。

TriangleMeshPart.CollisionFidelity

确定部件物理与其网格的细节级别。

此属性描述了当 `Class.TriangleMeshPart.CollisionFidelity` 设置为 `Enum.CollisionFidelity.Tunable` 时，部件的碰撞几何体的精度与性能之间的权衡。值为 `0` 时，最大限度地提高性能，使用最简单的碰撞网格，而值为 `1` 时，最大限度地提高精度，使用与视觉网格紧密匹配的碰撞网格。


TriangleMeshPart.CollisionPrecision

量化 `Enum.CollisionFidelity.Tunable` 碰撞几何体的精确度或性能，从 `0` 到 `1`。


控制物理引擎在计算部件的气动（流体）力和扭矩时使用的几何表示。默认值为 `Enum.FluidFidelity.Automatic`，在此模式下，引擎会为您选择表示。

- `Enum.FluidFidelity.Automatic` — 引擎选择表示；目前它根据部件的碰撞几何体评估流体力。
- `Enum.FluidFidelity.UseCollisionGeometry` — 流体力根据部件的碰撞几何体进行评估，匹配用于碰撞检测的形状。
- `Enum.FluidFidelity.UsePreciseGeometry` — 流体力根据部件的精确网格几何体进行评估，以更高的计算成本产生更准确的力。

由于此属性具有插件级别的写入安全性，因此在 Studio 中配置，而不是由运行时脚本分配。

此设置仅在流体力对场所处于活动状态时影响部件，该状态由 `Class.Workspace.FluidForces` 控制（一个默认值为 `Default` 的 `Enum.FluidForces` 值；将其设置为 `Experimental` 将启用气动力模型）。当流体力未应用于部件时，所选的精度不会产生影响。


TriangleMeshPart.FluidFidelity

确定用于计算气动力和扭矩的几何表示。


此只读属性报告部件的网格几何体在加载时的大小，以单位为 studs 的宽度、高度和深度表示。它不受通过 `Class.BasePart.Size` 调整部件大小的影响，因此将 `Class.BasePart.Size` 除以 `MeshSize` 可以得到当前应用于网格视觉和物理几何体的缩放因子。


TriangleMeshPart.MeshSize

部件源网格几何体的原始大小，在通过 `Class.BasePart.Size` 应用任何缩放之前。


抽象中间类，用于管理物理几何属性。
用于PartOperations和MeshParts。

创建一个蓝色部件和一个红色目标部件。蓝色部件将尝试平滑地
到达红色目标部件。移动和旋转目标以查看行为。
更改 smoothTime 会导致不同的平滑速度。

`Class.BasePart` 是一个用于在 `Class.Workspace` 中渲染并进行物理模拟的世界内对象的抽象基类。`Class.BasePart` 有多个实现，最常见的是 `Class.Part` 和 `Class.MeshPart`。其他实现包括 `Class.WedgePart`、`Class.SpawnLocation` 和单例 `Class.Terrain` 对象。通常，当文档提到"部件"时，大多数 `Class.BasePart` 实现都可以使用，而不仅仅是 `Class.Part`。

有关如何将 `Class.BasePart|BaseParts` 分组为模拟刚体的信息，请参见 [Assemblies](/physics/assemblies)。

有许多不同的对象与 `Class.BasePart` 交互（除了 `Class.Terrain`），包括：

- 多个 `Class.BasePart|BaseParts` 可以在 `Class.Model` 中分组，并使用 `Class.PVInstance:PivotTo()` 同时移动。请参见 [Models](/parts/models)。
- `Class.Decal` 将拉伸的图像纹理应用于 `Class.BasePart` 的面，而 `Class.Texture` 将平铺的图像纹理应用于面。请参见 [Textures and Decals](/parts/textures-decals)。
- `Class.SurfaceGui` 在部件的面上渲染 `Class.GuiObject|GuiObjects`。请参见 [In-Experience UI Containers](/ui/in-experience-containers)。
- `Class.Attachment|Attachments` 可以添加到 `Class.BasePart` 以指定相对于部件的 `Datatype.CFrame|CFrames`。这些通常由物理 `Class.Constraint` 对象使用，如 [Mechanical Constraints](/physics/mechanical-constraints) 和 [Mover Constraints](/physics/mover-constraints) 中所述。
- `Class.ParticleEmitter` 对象在其父级的 `Class.BasePart` 的体积中均匀发射粒子。请参见 [Particle Emitters](/effects/particle-emitters)。
- 像 `Class.PointLight` 这样的光源从 `Class.BasePart` 的中心发出光，如 [Light Sources](/effects/light-sources) 中所示。
- 如果父级为 `Class.Tool` 并且名称为 **Handle**，则 `Class.BasePart` 可以被角色持有。请参见 [In-Experience Tools](/players/tools)。

当另一个部件与另一个对象接触时触发。此事件仅向客户端发送数据，通知其两个部件已发生碰撞，而 `Class.BasePart.Touched` 向服务器发送数据。

BasePart.LocalSimulationTouched

part

当另一个部件与此部件接触时，在本地客户端触发。

如果部件的外观受到 `Class.Shirt` 类的影响，则触发。

BasePart.OutfitChanged

当部件的外观因 `Class.Shirt` 而变化时触发。

已弃用。当一个部件停止接触另一个部件时，在本地客户端触发，条件类似于 `Class.BasePart.TouchEnded`。此事件是 `Class.BasePart.TouchEnded` 的客户端专用对应事件：它仅通知本地客户端这两个部件已分开，而 `Class.BasePart.TouchEnded` 还会将数据发送到服务器。请改用 `Class.BasePart.TouchEnded`。

BasePart.StoppedTouching

otherPart

停止接触给定部件的另一个部件。

当一个部件停止接触另一个部件时，在本地客户端触发。

此代码示例在一个部件上创建一个 BillboardGui，显示当前接触它的部件数量。


此代码示例演示了如何将多个 `Class.Model` 中的 `Class.BasePart.Touched` 事件连接到一个函数。

当一个部件与另一个部件接触时触发 **Touched** 事件。例如，如果 **PartA** 碰到 **PartB**，则 `Class.BasePart.Touched|PartA.Touched` 将与 **PartB** 一起触发，
而 `Class.BasePart.Touched|PartB.Touched` 将与 **PartA** 一起触发。

此事件仅因物理运动而触发，因此如果 `Class.BasePart.CFrame|CFrame` 属性的更改导致部件重叠，则不会触发此事件。这也意味着，参与碰撞的至少一个部件在碰撞时必须 **不** 是 `Class.BasePart.Anchored|Anchored`。

此事件与 `Class.Workspace.TouchesUseCollisionGroups` 一起工作，以指定是否承认 [碰撞组](/workspace/collisions#collision-filtering) 进行检测。

BasePart.Touched

与给定部件接触的另一个部件。

当一个部件因物理运动而触碰另一个部件时触发。

在与 `Class.BasePart.Touched` 的条件相似的情况下，当一个部件停止接触另一个部件时触发。

此事件与 `Class.Workspace.TouchesUseCollisionGroups` 一起工作，以指定是否承认 [碰撞组](/workspace/collisions#collision-filtering) 进行检测。

BasePart.TouchEnded

停止接触此部件的另一个部件。

当一个部件因物理运动停止接触另一个部件时触发。

演示 `Class.BasePart:AngularAccelerationToTorque()`。


返回必须施加到部件的装配上的世界空间扭矩向量，以实现指定的角加速度。此结果可用于确定应通过 `Class.Torque`
实例或 `Class.BasePart:ApplyAngularImpulse()` 施加的扭矩。

计算使用欧拉旋转方程，其中 _I_ 是装配的世界空间惯性张量，_α_ 是所需的角加速度，_ω_ 是角速度。

_τ = I · α + ω × (I · ω)_

如果部件不是 `Class.Workspace` 的后代，则此方法返回一个无穷大向量。如果装配被固定，则也会返回一个无穷大向量。

#### 陀螺效应

当旋转装配具有不对称惯性张量时，实现指定角加速度所需的扭矩会因物体的方向变化而增加。可选的 `angVelocity` 参数考虑了这些陀螺效应。如果省略，则在计算中省略这些陀螺效应。

BasePart:AngularAccelerationToTorque

angAcceleration

世界空间中所需的角加速度向量。

angVelocity

装配的当前角速度，单位为世界空间。默认为 `(0, 0, 0)`。提供装配的角速度以考虑陀螺效应。

一个 `Datatype.Vector3`，表示产生指定角加速度所需的世界空间扭矩。

返回实现给定角加速度所需的扭矩，选项上考虑陀螺效应。

对该部件的装配施加瞬时角力冲量，导致装配旋转。

冲量产生的角速度依赖于装配的 `Class.BasePart.AssemblyMass|mass`。因此，需要更高的冲量来移动更大质量的装配。冲量在需要瞬时施加力的情况下非常有用，例如爆炸或碰撞。

如果部件由服务器 [拥有](/physics/network-ownership)，则此函数必须从服务器 `Class.Script` 调用（而不是从 `Class.LocalScript` 或 `Class.Script` 调用，
`Class.BaseScript.RunContext|RunContext` 设置为 `Enum.RunContext.Client`）。如果部件通过 **自动** 拥有由客户端拥有，则此函数可以从客户端脚本 **或** 服务器脚本调用；
从客户端脚本调用服务器拥有的部件将没有效果。

BasePart:ApplyAngularImpulse

impulse

此函数对该部件的装配施加瞬时力冲量。

力施加在装配的 `Class.BasePart.AssemblyCenterOfMass|质心` 处，因此产生的运动将仅为线性。

冲量产生的速度依赖于装配的 `Class.BasePart.AssemblyMass|mass`。因此，需要更高的冲量来移动更大质量的装配。冲量在需要瞬时施加力的情况下非常有用，例如爆炸或碰撞。

如果部件由服务器 [拥有](/physics/network-ownership)，则此函数必须从服务器 `Class.Script` 调用（而不是从 `Class.LocalScript` 或 `Class.Script` 调用，
`Class.BaseScript.RunContext|RunContext` 设置为 `Enum.RunContext.Client`）。如果部件通过 **自动** 拥有由客户端拥有，则此函数可以从客户端脚本 **或** 服务器脚本调用；
从客户端脚本调用服务器拥有的部件将没有效果。

BasePart:ApplyImpulse

要施加到装配的线性冲量向量。

在装配的 `Class.BasePart.AssemblyCenterOfMass|质心` 处施加冲量。

此函数在世界空间的指定位置对该部件的装配施加瞬时力冲量。

如果位置不在装配的 `Class.BasePart.AssemblyCenterOfMass|质心` 处，则冲量将导致位置和旋转运动。

冲量产生的速度依赖于装配的 `Class.BasePart.AssemblyMass|mass`。因此，需要更高的冲量来移动更大质量的装配。冲量在需要瞬时施加力的情况下非常有用，例如爆炸或碰撞。

如果部件由服务器 [拥有](/physics/network-ownership)，则此函数必须从服务器 `Class.Script` 调用（而不是从 `Class.LocalScript` 或 `Class.Script` 调用，
`Class.BaseScript.RunContext|RunContext` 设置为 `Enum.RunContext.Client`）。如果部件通过 **自动** 拥有由客户端拥有，则此函数可以从客户端脚本 **或** 服务器脚本调用；
从客户端脚本调用服务器拥有的部件将没有效果。

BasePart:ApplyImpulseAtPosition

position

施加冲量的位置，单位为世界空间。

将 `callback` 订阅到物理引擎为此部件生成的接触数据，
在检测碰撞时。每帧一次，在模拟步骤之后，`callback` 接收一个数组，
描述此部件在该帧中参与的每个接触点的摘要。每个摘要报告接触发生的位置、
接触的方向，以及在该点两个部件相对彼此的移动速度。

此方法与 `Class.BasePart.Touched` 是一个独立的机制。

如果 `callback` 为 `nil`，或者该部件不是 `Class.Workspace` 的后代，
则会抛出错误。

#### 摘要字段

传递给 `callback` 的数组中的每个条目都是一个具有以下键的表：

<table size="small">
<thead>
  <tr>
    <th>键</th>
    <th>类型</th>
    <th>摘要</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>Time</code></td>
    <td><code>number</code></td>
    <td>生成此摘要的物理子步骤的模拟时间（以秒为单位）。</td>
  </tr>
  <tr>
    <td><code>Part0</code></td>
    <td><code>Class.BasePart</code></td>
    <td>被订阅的部件。</td>
  </tr>
  <tr>
    <td><code>Part1</code></td>
    <td><code>Class.BasePart</code></td>
    <td>配对中的另一个部件，可能是 <code>Class.Terrain</code>。</td>
  </tr>
  <tr>
    <td><code>Point</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>在世界空间中的接触点，平均接触点的补丁。</td>
  </tr>
  <tr>
    <td><code>Normal</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>相对于被订阅部件的补丁的单位接触法线。</td>
  </tr>
  <tr>
    <td><code>RelativeVelocity</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>在接触点上 <code>Part1</code> 相对于 <code>Part0</code> 的速度。</td>
  </tr>
  <tr>
    <td><code>Area</code></td>
    <td><code>number</code></td>
    <td>接触补丁的估计面积（以平方钉为单位）。对于少于三个点的补丁（例如边缘或角接触），为 <code>0</code>。</td>
  </tr>
</tbody>
</table>

`Normal` 是相对于被订阅部件而不是引擎首先列出的部件进行定向的，因此如果一对中的两个部件都被订阅，
每个订阅都会接收自己的摘要，`Part0` 为自己，法线翻转以匹配。

`RelativeVelocity` 是 `Part1` 相对于 `Part0` 的速度，因此其在 `Normal` 上的投影的大小是两个部件正面接近或分开的速度，
而与 `Normal` 切向的分量描述滑动和斜接触。

#### 报告行为

- 仅在 `Class.Workspace` 中存在至少一个订阅时，接触记录才会启用，
  其成本与订阅部件的数量相关，而不是场景中的碰撞总数。
- 多个静止部件之间的接触不会生成摘要。
- `Class.BasePart.CanCollide` 设置为 `false` 的部件的接触不会生成摘要。
- 物理每帧可能运行多个子步骤，因此在多个子步骤中保持接触的一对每个补丁最多生成一个摘要，
  所有摘要都在同一次 `callback` 调用中交付。使用 `Time` 对它们进行排序。
- 非凸碰撞几何体为每对接触的凸包生成一个摘要，
  与 `Class.Terrain` 的接触进一步按接触法线拆分，因此在一个子步骤内，
  这两者都可能为同一对生成多个摘要。
- 没有任何内容被复制。每个客户端为其拥有的碰撞生成摘要。请参见
  [网络所有权](/physics/network-ownership)。
- 销毁部件会断开其订阅。

BasePart:BindToCollisionSummaries

callback

如果该部件参与了碰撞，则在每帧最多调用一次，
并传入一个摘要表的数组。

一个 `Datatype.RBXScriptConnection`，在断开连接时结束订阅。

订阅此部件参与的碰撞的详细逐帧接触数据。

断开与任何相邻部件的任何表面连接，包括
`Class.Weld` 和其他 `Class.JointInstance`。

BasePart:BreakJoints

BasePart:breakJoints

返回部件是否可以相互碰撞。此函数考虑了两个部件的碰撞组。
如果指定的部件不是 BasePart，则此函数将出错。

BasePart:CanCollideWith

此示例检查在 `Workspace` 中名为 _Part_ 的第一个 `BasePart` 的网络所有权是否可以设置。


CanSetNetworkOwnership 函数检查您是否可以设置部件的
网络所有权。

该函数的返回值验证您是否可以调用
`Class.BasePart:SetNetworkOwner()` 或
`Class.BasePart:SetNetworkOwnershipAuto()` 而不会遇到错误。
如果您可以修改/读取网络所有权，则返回 true；否则返回 false 和您无法执行的原因，作为字符串。

BasePart:CanSetNetworkOwnership

您是否可以修改或读取网络所有权及其原因。

检查您是否可以设置部件的网络所有权。

返回部件表面上离给定世界空间位置最近的点。如果提供的位置在部件内部，
则原样返回。

对于 `Class.MeshPart` 和 `Class.PartOperation` 实例，此方法
尊重部件的 `Enum.CollisionFidelity` 值。返回值可能会根据网格被视为盒子、外壳或
更复杂的形状而有所不同。

BasePart:GetClosestPointOnSurface

要查找最近表面点的世界空间点。

在世界空间中部件表面上离给定点最近的点。

返回部件表面上离给定点最近的点。

返回通过任何刚性关节连接到该对象的部件表。

如果 `recursive` 为 true，此函数将返回所有与 BasePart 刚性连接的部件。

#### 刚性关节

当一个关节将两个部件连接在一起时 `(Part0 → Part1)`，如果 `Part1` 的物理完全被 `Part0` 锁定，
则该关节是 **刚性** 的。这仅适用于以下关节类型：

- `Class.Weld`
- `Class.Snap`
- `Class.ManualWeld`
- `Class.Motor`
- `Class.Motor6D`
- `Class.WeldConstraint`

BasePart:GetConnectedParts

recursive

通过任何类型的 `Class.JointInstance|joint` 连接到该对象的部件表。

通过刚性关节连接到此部件的 `Class.BasePart|BaseParts` 数组。如果 `recursive` 为 true，包含所有部件。

返回通过任何刚性关节连接到该对象的部件表。

返回与此部件连接的所有关节或约束。

BasePart:GetJoints

与该部件连接的所有关节或约束的数组。

此示例在游戏的工作区中创建一个新的部件 myPart，尺寸为 4x6x4 studs。该部件也被固定。

然后，将 myMass 设置为新部件的质量。部件的质量在打印语句的末尾打印：

> 我部件的质量是 ...


**GetMass** 返回只读的 `Class.BasePart.Mass|Mass` 属性的值。

此函数早于质量属性。为了向后兼容，仍然支持；您应该直接使用质量属性。

BasePart:GetMass

返回 `Class.BasePart.Mass|Mass` 属性的值。

BasePart:getMass

返回当前玩家，该玩家是此部件的网络所有者，或在服务器情况下为 `nil`。

BasePart:GetNetworkOwner

当前玩家，该玩家是此部件的网络所有者，或在服务器情况下为 `nil`。

如果游戏引擎自动决定此部件的网络所有者，则返回 true。

BasePart:GetNetworkOwnershipAuto

游戏引擎是否自动决定此部件的网络所有者。

返回当前在其物理世界中注册的启用的 `Class.NoCollisionConstraint` 对象。一个
`Class.NoCollisionConstraint` 禁用它所引用的两个特定部件之间的碰撞，
而这些部件仍然可以与世界的其他部分发生碰撞。

如果当前没有为此部件注册这样的约束，则返回的数组为空。返回的约束的顺序不保证。

BasePart:GetNoCollisionConstraints

当前在其物理世界中注册的启用的 `Class.NoCollisionConstraint` 对象的数组。

返回当前在其物理世界中注册的启用的 `Class.NoCollisionConstraint` 对象。

当 Roblox 的延迟补偿在线部件插值时，此函数曾经相关。插值现在直接应用于 `Datatype.CFrame`。

BasePart:GetRenderCFrame

表示部件渲染位置的 `Datatype.CFrame`，
现在等同于部件的 `Class.BasePart.CFrame|CFrame`。

过时。返回描述部件渲染位置的 CFrame。

返回一组的基础部件。当使用 `Datatype.CFrame` 移动一组部件时，
移动此基础部件很重要（这将相应地移动所有与其连接的其他部件）。更多信息
请参见 [Assemblies](/physics/assemblies) 文章。

此函数早于 `Class.BasePart.AssemblyRootPart|AssemblyRootPart` 属性。为了向后兼容，仍然支持；
但您应该直接使用 `Class.BasePart.AssemblyRootPart|AssemblyRootPart`。

BasePart:GetRootPart

一组的基础部件（连接在一起的部件集合）。

返回与此部件物理交互的所有部件的表。如果该部件本身的 CanCollide 设置为 false，
则此函数返回一个空表，除非该部件有一个 `Class.TouchTransmitter|TouchInterest` 对象作为其父对象（这意味着
某些东西连接到其 Touched 事件）。相邻但不相交的部件不被视为接触。此函数早于 `Class.WorldRoot:GetPartsInPart()` 函数，
该函数提供了更多灵活性，并避免了上述特殊的 `Class.TouchTransmitter|TouchInterest` 规则。请改用 `Class.WorldRoot:GetPartsInPart()`。

BasePart:GetTouchingParts

与此部件相交且可以碰撞的所有部件的表。

返回与此部件相交的所有 `Class.BasePart.CanCollide` 为 true 的部件表。

返回相对于此部件的给定位置的部件组的线性速度。它可以用来识别
部件组中除了根部件之外的部件的线性速度。如果该组没有角速度，则每个位置的线性速度将始终相同。

BasePart:GetVelocityAtPosition

要计算组的线性速度的世界空间位置。

表示在指定世界空间位置的组的线性速度的 `Datatype.Vector3`。

返回相对于此部件的给定位置的部件组的线性速度。

从部件和给定数组中的其他部件的相交几何体创建一个新的 `Class.IntersectOperation`。仅支持 `Class.Part|Parts`，
不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。类似于 `Class.Instance:Clone()|Clone()`，返回的对象没有设置的 `Class.Instance.Parent|Parent`。

调用部件的以下属性应用于结果的 `Class.IntersectOperation`：

- `Class.BasePart.Color|Color`，`Class.BasePart.Material|Material`，
  `Class.BasePart.MaterialVariant|MaterialVariant`，
  `Class.BasePart.Reflectance|Reflectance`，
  `Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`，`Class.BasePart.Density|Density`，
  `Class.BasePart.Elasticity|Elasticity`，
  `Class.BasePart.ElasticityWeight|ElasticityWeight`，
  `Class.BasePart.Friction|Friction`，
  `Class.BasePart.FrictionWeight|FrictionWeight`

#### 迁移

强烈建议使用更新的 `Class.GeometryService:IntersectAsync()` 而不是此方法。除了具有更好的性能和更多功能外，
新方法的不同之处在于：

- 输出是实例数组，而不是单个实例。
- 输入部件不需要被父级到场景，允许后台操作。
- 当 `SplitApart` 选项设置为 `true`（默认）时，每个不同的主体将在其自己的 `Class.PartOperation` 中返回。
- 所有返回的部件都在主部件的坐标空间中，因此它们的 `Class.PVInstance.Origin` 位置与主部件相同。这使得网格的顶点在操作之前与对象相对保持在同一位置，但这也意味着返回部件的 `(0, 0, 0)` 不一定位于其主体的中心。

#### 注意事项

- 原始部件在成功的相交操作后保持完整。在大多数情况下，您应该 `Class.Instance.Destroy|Destroy()` 所有原始部件，并将返回的 `Class.IntersectOperation` 作为父级放置在与调用的 `Class.BasePart` 相同的位置。
- 默认情况下，结果交集的面颜色来自原始部件的 `Class.BasePart.Color|Color` 属性。要将整个交集更改为特定颜色，请将其 `Class.PartOperation.UsePartColor|UsePartColor` 属性设置为 `true`。
- 如果相交操作会导致一个部件具有超过 20,000 个三角形，则会简化为 20,000 个三角形。

BasePart:IntersectAsync

parts

collisionfidelity

结果 `Class.IntersectOperation` 的 `Enum.CollisionFidelity` 值。

renderFidelity

结果 `Class.PartOperation` 的 `Enum.RenderFidelity` 值。

结果 `Class.IntersectOperation`，默认名称为 **Intersect**。

从部件和给定数组中的其他部件的重叠几何体创建一个新的 `Class.IntersectOperation`。

如果对象连接到将其固定在位置的部件（例如 `Class.BasePart.Anchored|Anchored` 部件），则返回 true；否则返回 false。在具有 `Class.BasePart.Anchored|Anchored` 部件的组中，
每个其他部件都是固定的。

BasePart:IsGrounded

对象是否连接到将其固定在位置的部件。

如果对象连接到将其固定在位置的部件（例如 `Class.BasePart.Anchored|Anchored` 部件），则返回 true；否则返回 false。

在任何具有可以制作关节的 `Class.BasePart|Part` 的 `Enum.SurfaceType` 的一侧创建关节，
它将与任何相邻部件创建关节。

关节将在侧面和任何平面接触表面之间创建，具体取决于侧面的表面。

- 光滑表面不会创建关节
- 胶水表面将创建一个 `Class.Glue` 关节
- 焊接将与任何表面创建一个 `Class.Weld` 关节，除了不可连接的表面
- 钉子、进气口或通用表面将与其他两个表面中的任意一个创建一个 `Class.Snap` 关节（例如，钉子与进气口和通用表面）
- 铰链和电动表面创建 `Class.Rotate` 和 `Class.RotateV` 关节实例

与 `Class.Model:MakeJoints()` 不同，此函数需要一个部件数组作为参数。该数组如下所示：

```
part:MakeJoints({part1, part2, part3})
```
如果由于 `Class.Explosion` 施加了足够的力，关节将断开，
除非 `Class.ForceField` 对象作为父对象附加到 `Class.BasePart` 或祖先 `Class.Model`。因此，它们通常用于制作简单的可破坏建筑和其他模型。

BasePart:MakeJoints

在任何具有可以制作关节的表面 ID 的对象的任一侧创建关节。

BasePart:makeJoints

像使用 Studio 调整工具一样更改对象的大小。

BasePart:Resize

normalId

deltaAmount

BasePart:resize

将给定玩家设置为此部件及所有连接部件的网络所有者。
当 playerInstance 为 `nil` 时，服务器将成为所有者，而不是玩家。

BasePart:SetNetworkOwner

playerInstance

被赋予部件网络所有权的玩家。

将给定玩家设置为此部件及所有连接部件的网络所有者。

让游戏引擎动态决定谁来处理部件的物理（客户端之一或服务器）。

BasePart:SetNetworkOwnershipAuto

从部件创建一个新的 `Class.UnionOperation`，减去给定数组中部件占用的几何体。仅支持 `Class.Part|Parts`，
不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。类似于 `Class.Instance:Clone()|Clone()`，返回的对象没有设置的 `Class.Instance.Parent|Parent`。

请注意，结果联合不能因减法而为空。如果操作会导致完全空的几何体，则会失败。

#### 迁移

强烈建议使用更新的 `Class.GeometryService:SubtractAsync()` 而不是此方法。除了具有更好的性能和更多功能外，
新方法的不同之处在于：

- 输出是实例数组，而不是单个实例。
- 输入部件不需要被父级到场景，允许后台操作。
- 当 `SplitApart` 选项设置为 `true`（默认）时，每个不同的主体将在其自己的 `Class.PartOperation` 中返回。
- 所有返回的部件都在主部件的坐标空间中，因此它们的 `Class.PVInstance.Origin` 位置与主部件相同。这使得网格的顶点在操作之前与对象相对保持在同一位置，但这也意味着返回部件的 `(0, 0, 0)` 不一定位于其主体的中心。

BasePart:SubtractAsync

结果 `Class.UnionOperation` 的 `Enum.CollisionFidelity` 值。

结果 `Class.UnionOperation`，默认名称为 **Union**。

从部件创建一个新的 `Class.UnionOperation`，减去给定数组中部件占用的几何体。

演示 `Class.BasePart:TorqueToAngularAcceleration()`。


返回施加给部件组的指定扭矩所导致的世界空间角加速度，
可选择考虑陀螺效应。

这是 `Class.BasePart:AngularAccelerationToTorque()` 的逆运算。它对于预测一个组如何响应施加的扭矩非常有用。

计算使用：

**α = I⁻¹ · (τ − ω × (I · ω))**

其中 **I** 是组的世界空间惯性张量，**τ** 是施加的扭矩，**ω** 是角速度。

如果该部件不是 `Class.Workspace` 的后代，则返回 `(0, 0, 0)`。
如果该组被固定，则返回 `(0, 0, 0)`。

#### 陀螺效应

当旋转组具有不对称惯性张量时，施加扭矩所导致的加速度还取决于当前的角速度。`angVelocity` 参数考虑了这些陀螺效应。如果省略（默认为零），则结果忽略了这一贡献。

BasePart:TorqueToAngularAcceleration

torque

施加于组的世界空间扭矩向量。

组的当前世界空间角速度。默认为 `(0, 0, 0)`。提供组的角速度以考虑陀螺效应。

表示结果角加速度的 `Datatype.Vector3`，在世界空间中。

返回施加给此部件组的扭矩所导致的角加速度，
可选择考虑陀螺效应。

从部件创建一个新的 `Class.UnionOperation`，加上给定数组中部件占用的几何体。仅支持 `Class.Part|Parts`，
不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。类似于 `Class.Instance:Clone()|Clone()`，返回的对象没有设置的 `Class.Instance.Parent|Parent`。

调用部件的以下属性应用于结果的 `Class.UnionOperation`：

- `Class.BasePart.Color|Color`，`Class.BasePart.Material|Material`，
  `Class.BasePart.MaterialVariant|MaterialVariant`，
  `Class.BasePart.Reflectance|Reflectance`，
  `Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`，`Class.BasePart.Density|Density`，
  `Class.BasePart.Elasticity|Elasticity`，
  `Class.BasePart.ElasticityWeight|ElasticityWeight`，
  `Class.BasePart.Friction|Friction`，
  `Class.BasePart.FrictionWeight|FrictionWeight`

#### 迁移

强烈建议使用更新的 `Class.GeometryService:UnionAsync()` 而不是此方法。除了具有更好的性能和更多功能外，
新方法的不同之处在于：

- 输出是实例数组，而不是单个实例。
- 输入部件不需要被父级到场景，允许后台操作。
- 当 `SplitApart` 选项设置为 `true`（默认）时，每个不同的主体将在其自己的 `Class.PartOperation` 中返回。
- 所有返回的部件都在主部件的坐标空间中，因此它们的 `Class.PVInstance.Origin` 位置与主部件相同。这使得网格的顶点在操作之前与对象相对保持在同一位置，但这也意味着返回部件的 `(0, 0, 0)` 不一定位于其主体的中心。

#### 注意事项

- 原始部件在成功的联合操作后保持完整。在大多数情况下，您应该 `Class.Instance.Destroy|Destroy()` 所有原始部件，并将返回的 `Class.UnionOperation` 作为父级放置在与调用的 `Class.BasePart` 相同的位置。
- 默认情况下，结果联合尊重每个部件的 `Class.BasePart.Color|Color` 属性。要将整个联合更改为特定颜色，请将其 `Class.PartOperation.UsePartColor|UsePartColor` 属性设置为 `true`。
- 如果联合操作会导致一个部件具有超过 20,000 个三角形，则会简化为 20,000 个三角形。

BasePart:UnionAsync

与调用部件一起参与联合的对象。

从部件创建一个新的 `Class.UnionOperation`，加上给定数组中部件占用的几何体。

BasePart

此代码示例允许通过点击部件来切换其锚定属性。当切换时，部件的视觉外观会更新（红色表示锚定，黄色表示自由）。


`Anchored` 属性确定部件是否会被物理移动。当启用时，部件将永远不会因重力、其他部件碰撞、与其他部件重叠或任何其他与物理相关的原因而改变位置。因此，两个锚定的部件将永远不会相互触发 `Class.BasePart.Touched|Touched` 事件。

锚定的部件仍然可以通过更改其 `Class.BasePart.CFrame|CFrame` 或 `Class.BasePart.Position|Position` 来移动，并且它仍然可能具有非零的 `Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity` 和 `Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`。

最后，如果一个未锚定的部件通过像 `Class.Weld` 这样的对象与一个锚定的部件连接，它也会表现得像是锚定的。如果这样的连接断开，该部件可能会再次受到物理影响。有关更多详细信息，请参见 [Assemblies](/physics/assemblies)。

锚定的部件无法设置网络所有权。如果部件的锚定状态在服务器上发生变化，该部件的网络所有权将受到影响。

BasePart.Anchored

确定一个部件是否不可被物理移动。

此部件装配的角速度向量。它是以弧度每秒为单位的方向变化率。

角速度在装配的每个点都是相同的。

直接设置速度可能会导致不现实的运动。建议使用 `Class.Torque` 或 `Class.AngularVelocity` 约束，或者使用 `Class.BasePart:ApplyAngularImpulse()|ApplyAngularImpulse()` 如果您想要瞬时改变速度。

如果部件由服务器 [拥有](/physics/network-ownership)，则此属性必须从服务器 `Class.Script` 更改（不能从 `Class.LocalScript` 或 `Class.Script` 更改，且 `Class.BaseScript.RunContext|RunContext` 设置为 `Enum.RunContext.Client`）。如果部件通过 **自动** 所有权由客户端拥有，则此属性可以从客户端脚本 **或** 服务器脚本更改；从客户端脚本更改服务器拥有的部件将没有效果。

BasePart.AssemblyAngularVelocity

通过 `Class.BasePart.Mass|Mass` 和所有部件的 `Class.BasePart.Position|Position` 计算得出的一个位置。

如果装配中有一个锚定的部件，则该部件的质心将是装配的质心，并且装配将具有无限质量。

了解质心可以帮助装配保持稳定。施加在质心上的力不会导致角加速度，仅会导致线性加速度。质心较低的装配在重力作用下更容易保持直立。

BasePart.AssemblyCenterOfMass

部件装配的质心在世界空间中的位置。

此部件装配的线速度向量。它是 `Class.BasePart.AssemblyCenterOfMass|AssemblyCenterOfMass` 的位置变化率，以 studs 每秒为单位。

如果您想知道质心以外某一点的速度，请使用 `Class.BasePart:GetVelocityAtPosition()|GetVelocityAtPosition()`。

直接设置速度可能会导致不现实的运动。建议使用 `Class.VectorForce` 约束，或者使用 `Class.BasePart:ApplyImpulse()|ApplyImpulse()` 如果您想要瞬时改变速度。

如果部件由服务器 [拥有](/physics/network-ownership)，则此属性必须从服务器 `Class.Script` 更改（不能从 `Class.LocalScript` 或 `Class.Script` 更改，且 `Class.BaseScript.RunContext|RunContext` 设置为 `Enum.RunContext.Client`）。如果部件通过 **自动** 所有权由客户端拥有，则此属性可以从客户端脚本 **或** 服务器脚本更改；从客户端脚本更改服务器拥有的部件将没有效果。

BasePart.AssemblyLinearVelocity

此部件装配中所有 `Class.BasePart|BaseParts` 的质量总和。质量为 `Class.BasePart.Massless|Massless` 的部件且不是装配的根部件将不会对 `AssemblyMass` 产生贡献。

如果装配中有一个锚定的部件，则装配的质量被视为无限。未锚定的装配之间质量差异较大的约束和其他物理交互可能会导致不稳定。

BasePart.AssemblyMass

此属性指示自动选择的 `Class.BasePart`，用于表示装配的根部件。如果部件未被父级到 `Class.Workspace`，则此属性将为 `nil`。

可以通过更改装配中部件的 `Class.BasePart.RootPriority|RootPriority` 来更改根部件。

所有共享相同 `AssemblyRootPart` 的部件都在同一装配中。

有关根部件的更多信息，请参见 [Assemblies](/physics/assemblies)。

BasePart.AssemblyRootPart

`AudioCanCollide` 确定部件是否会与音频模拟进行物理交互，类似于 `Class.BasePart.CastShadow|CastShadow` 对于光照。

当禁用时，音频会穿过部件；不会被遮挡或反射。

BasePart.AudioCanCollide

确定部件是否会与音频模拟进行物理交互，类似于 `Class.BasePart.CastShadow|CastShadow` 对于光照。

此代码示例演示了如何仅使用 NormalId（顶部、前面等）设置表面属性。它将电机的 -SurfaceInput 从 NoInput、Constant 和 Sin 切换，以展示每种属性如何使用 -ParamA 和 -ParamB 工作。


当部件的 `Class.BasePart.BackSurface` 设置为 Motor 或 SteppingMotor 且 `Class.BasePart.BackSurfaceInput` 设置为 Sin 时，`BackParamA` 属性是相关的。它确定电机旋转速度的 **幅度**。

BasePart.BackParamA

确定部件背面 SurfaceType 的第一个参数。

当部件的 `Class.BasePart.BackSurface` 设置为 Motor 或 SteppingMotor 且 `Class.BasePart.BackSurfaceInput` 设置为 Constant 或 Sin 时，`BackParamB` 属性是相关的。对于 Constant，它确定电机的恒定旋转速度。对于 Sin，它确定电机旋转速度的 **频率**。

BasePart.BackParamB

确定部件背面 SurfaceType 的第二个参数。

`BackSurface` 属性确定用于部件正 **Z** 方向的表面类型。当两个部件的面相邻放置时，它们可能会在之间创建一个连接。

BasePart.BackSurface

`BackSurfaceInput` 属性确定提供给部件的 `Class.BasePart.BackSurface` 的输入类型。这仅与 Motor 或 SteppingMotor SurfaceTypes 相关。此属性确定 `Class.BasePart.BackParamA` 和 `Class.BasePart.BackParamB` 的使用方式。为简便起见，这些属性将分别称为 ParamA 和 ParamB。

- 默认情况下，这设置为 NoInput。这会完全停止电机。
- 对于 Constant，电机以等于 `ParamB` 的恒定速度旋转。
- 对于 Sin，电机以等于 `ParamA * math.sin(workspace.DistributedGameTime * ParamB)` 的速度旋转。请参见 `Class.Workspace.DistributedGameTime`。

BasePart.BackSurfaceInput

当部件的 `Class.BasePart.BottomSurface` 设置为 Motor 或 SteppingMotor 且 `Class.BasePart.BottomSurfaceInput` 设置为 Sin 时，`BottomParamA` 属性是相关的。它确定电机旋转速度的 **幅度**。

BasePart.BottomParamA

确定部件底面 SurfaceType 的第一个参数。

当部件的 `Class.BasePart.BottomSurface` 设置为 Motor 或 SteppingMotor 且 `Class.BasePart.BottomSurfaceInput` 设置为 Constant 或 Sin 时，`BottomParamB` 属性是相关的。对于 Constant，它确定电机的恒定旋转速度。对于 Sin，它确定电机旋转速度的 **频率**。

BasePart.BottomParamB

确定部件底面 SurfaceType 的第二个参数。

用于物理交互的世界内对象的抽象基类。

/reference/engine/classes/TriangleMeshPart.yaml