`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 中的 **Export Selection** 選項導出網格來獲得。圖像文件將與導出的 `.obj` 文件一起保存。

然後可以將新紋理作為貼圖上傳到 Roblox，並使用 `Class.MeshPart.TextureContent|TextureContent` 或 `Class.MeshPart.TextureID|TextureID` 屬性將其應用於網格。

`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 映射時，才能對網格進行紋理處理，這是指將紋理映射投影到網格上的做法。這無法使用 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.BasePart.Touched`
事件連接到 `Class.Model` 中的一個函數。


當一個部件與另一個部件接觸時，**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>接觸區域的估計面積（以平方 studs 為單位）。對於少於三個點的接觸區域（例如邊緣或角落接觸），則為 <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，則包括組件中的所有部件。

返回通過任何類型的剛性關節連接到該對象的部件表。

返回一個數組，包含所有與此部件連接的 `Class.JointInstance|關節` 和 `Class.Constraint|約束`，這些關節或約束在模擬中是活躍的。

一個關節或約束只有在它連接的兩個部件都在**同一**模擬容器內時才會變為活躍，例如 `Class.Workspace` 或 `Class.WorldModel`。如果其中一個連接的部件在該容器外部——例如，父級為 `Class.ServerStorage`，或在不同的 `Class.WorldModel` 中——則該關節不會被激活。**GetJoints()** 不會在任何部件上包含該關節，即使該關節實例仍然存在於數據模型中。


BasePart:GetJoints

一個數組，包含所有與部件連接的 `Class.JointInstance|關節` 和 `Class.Constraint|約束`，這些關節或約束在模擬中是活躍的。


返回所有與此部件連接的關節或約束，這些關節或約束在模擬中是活躍的。


此範例在遊戲的工作區中創建一個新的零件 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` 關節，除了不可連接的表面
- Studs、Inlet 或 Universal 將各自與其他兩個表面（例如 Studs 與 Inlet 和 Universal）創建一個 `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

在世界中物理互動的抽象基類。

概要