`Class.MeshPart` 是一种包含物理模拟自定义网格的 `Class.BasePart`。
与其他网格类（如 `Class.SpecialMesh` 和 `Class.BlockMesh`）不同，它们不是作为 `Class.BasePart` 的子对象，而是作为独立的 `Class.BasePart` 行为。

`Class.MeshPart` 的网格和纹理由 `Class.MeshPart.MeshId|MeshId` 和 `Class.MeshPart.TextureID|TextureID` 属性决定。有关更多信息，请参见 [Meshes](/parts/meshes)。


从给定的源 `meshPart` 覆盖此 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体属性。

这些属性大多数是只读的，无法在运行时直接更改。为了保持 `Class.MeshPart.MeshContent|MeshContent` 和物理数据的同步，必须一起更新。

复制以下属性：

- `Class.MeshPart.MeshContent`（隐式更新 `Class.MeshPart.MeshId|MeshId`）
- `Class.MeshPart.TextureContent`（隐式更新 `Class.MeshPart.TextureID|TextureID`）
- `Class.MeshPart.RenderFidelity`
- `Class.MeshPart.CollisionFidelity`（与任何内部碰撞几何体）
- `Class.MeshPart.FluidFidelity`（与任何内部气动几何体）
- `Class.MeshPart.MeshSize`


MeshPart:ApplyMesh

meshPart

源 `Class.MeshPart`，其 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体（连同 `Class.MeshPart.RenderFidelity|RenderFidelity`、`Class.MeshPart.CollisionFidelity|CollisionFidelity`、`Class.MeshPart.FluidFidelity|FluidFidelity` 和 `Class.MeshPart.MeshSize|MeshSize`）将被复制到此部件。该对象必须是 `Class.MeshPart`，否则调用将抛出错误。


从给定的源 `meshPart` 覆盖此 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体属性。


MeshPart

此属性确定是否渲染网格中多边形的两个面。这对于通常建模为"卡片"的网格（如叶子、头发或布料）非常有用。


MeshPart.DoubleSided

确定是否渲染网格中多边形的两个面。


与 `Class.MeshPart` 的内部 `Class.MeshPart.JointOffset|JointOffset` 相关的已弃用遗留属性。它由引擎管理，无法通过脚本设置。请勿在新工作中使用。


MeshPart.HasJointOffset

与该部件的 `Class.MeshPart.JointOffset|JointOffset` 相关的已弃用遗留标志。


指示当前应用于 `Class.MeshPart` 的网格是否包含蒙皮（骨骼和关节）数据，例如使用骨架进行骨骼变形的网格。

默认为 `false`。当加载网格时，引擎会自动设置此值（当网格数据包含关节时为 `true`），因此脚本无法设置它。


MeshPart.HasSkinnedMesh

指示当前应用于 `Class.MeshPart` 的网格是否包含蒙皮（骨骼和关节）数据。


已弃用。一个 `Datatype.Vector3` 偏移量，曾用于定位蒙皮网格的关节。默认为 `0, 0, 0`，并在每次应用新网格时重置。无法通过脚本设置；请勿在新工作中使用。


MeshPart.JointOffset

已弃用。曾用于定位蒙皮网格关节的偏移量。


显示在 `Class.MeshPart` 上的网格。支持 [asset URIs](/projects/assets#asset-uris) 和 `Class.EditableMesh` 对象。

请注意，此属性无法通过脚本直接更改，因为网格的碰撞几何体无法实时重新计算。请参见 `Class.AssetService:CreateMeshPartAsync()` 作为从给定的 `Datatype.Content` 创建新 `Class.MeshPart` 的方法，并指定 `Class.MeshPart.CollisionFidelity|CollisionFidelity`。
`Class.MeshPart:ApplyMesh()` 可用于覆盖现有 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体。


MeshPart.MeshContent

显示在 `Class.MeshPart` 上的网格。支持 [asset URIs](/projects/assets#asset-uris) 和 `Class.EditableMesh` 对象。


显示在 `Class.MeshPart` 上的网格的 [asset URIs](/projects/assets#asset-uris)。读取和写入 `Class.MeshPart.MeshContent|MeshContent`。

请注意，此属性无法通过脚本直接更改，因为网格的碰撞几何体无法实时重新计算。请参见 `Class.AssetService:CreateMeshPartAsync()` 作为从给定的 `Datatype.Content` 创建新 `Class.MeshPart` 的方法，并指定 `Class.MeshPart.CollisionFidelity|CollisionFidelity`。
`Class.MeshPart:ApplyMesh()` 可用于覆盖现有 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体。


MeshPart.MeshId

显示在 `Class.MeshPart` 上的网格的 [asset URIs](/projects/assets#asset-uris)。读取和写入 `Class.MeshPart.MeshContent|MeshContent`。


此属性确定 `Class.MeshPart` 将以何种细节级别显示。可以设置为 `Enum.RenderFidelity` 枚举的可能值。

默认值为 `Enum.RenderFidelity.Automatic|Automatic`，这意味着网格的细节基于其与相机的距离，如下表所示。

<table>
    <thead>
        <tr>
            <th>距离相机的距离</th>
            <th>渲染保真度</th>
            <th>示例</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>小于 250 studs</td>
            <td>最高</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-High.jpg" width="200" /></td>
        </tr>
        <tr>
            <td>250-500 studs</td>
            <td>中等</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-Medium.jpg" width="200" /></td>
        </tr>
        <tr>
            <td>500 或更多 studs</td>
            <td>最低</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-Low.jpg" width="200" /></td>
        </tr>
    </tbody>
</table>


MeshPart.RenderFidelity

用于渲染 `Class.MeshPart` 的细节级别。


应用于 `Class.MeshPart` 的纹理。支持 [asset URIs](/projects/assets#asset-uris) 和 `Class.EditableImage` 对象。

当此属性设置为 `Datatype.Content.none` 时，将不会应用任何纹理到网格。

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

local meshPart = Workspace.MeshPart
meshPart.TextureContent = Content.none  -- 无纹理
```
请注意，`Class.MeshPart.MeshContent|MeshContent` 属性在运行时无法直接更改，但纹理可以更改。

##### 更改网格纹理

使用 `Class.MeshPart.TextureContent|TextureContent` 属性，可以在不重新上传网格的情况下更改网格的纹理。为此，可以将所需纹理的新图像上传到 Roblox。
可以通过使用 Studio 中的 **导出选择** 选项导出网格来获取原始纹理图像文件。图像文件将与导出的 `.obj` 文件一起保存。

然后可以将新纹理作为贴花上传到 Roblox，并使用 `Class.MeshPart.TextureContent|TextureContent` 或 `Class.MeshPart.TextureID|TextureID` 属性将其 [asset URI](/projects/assets#asset-uris) 应用到网格上。

`Class.MeshPart.TextureContent|TextureContent` 也可以设置为引用尚未发布的 `Class.EditableImage`。

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

local meshPart = Workspace.MeshPart

local editableImage = AssetService:CreateEditableImageAsync(meshPart.TextureContent)
meshPart.TextureContent = Content.fromObject(editableImage)  -- 实时更新
```
当 `Class.MeshPart.TextureContent|TextureContent` 引用 `Class.EditableImage` 时，纹理将随着对 `Class.EditableImage` 对象的任何编辑而实时更新。

##### 制作带纹理的网格

只有在网格已进行 UV 映射的情况下，才能对网格进行纹理处理，UV 映射是将纹理图投影到网格上的过程。这不能通过 Roblox Studio 完成，必须使用外部 3D 建模应用程序，如 [Blender](https://www.blender.org/)。


MeshPart.TextureContent

应用于 `Class.MeshPart` 的纹理。支持 [asset URIs](/projects/assets#asset-uris) 和 `Class.EditableImage` 对象。


应用于 `Class.MeshPart` 的纹理。读取和写入 `Class.MeshPart.TextureContent|TextureContent`。

当此属性设置为空字符串时，将不会应用任何纹理到网格。

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

local meshPart = Workspace.MeshPart
meshPart.TextureID = ""  -- 无纹理
```
请注意，`Class.MeshPart.MeshId` 属性在运行时无法更改，但纹理可以更改。有关详细信息，请参见 `Class.MeshPart.TextureContent|TextureContent`。


MeshPart.TextureID

应用于 `Class.MeshPart` 的纹理。读取和写入 `Class.MeshPart.TextureContent|TextureContent`。


一种包含物理模拟自定义网格的 `Class.BasePart`。


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

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