`Class.Stats` 是一個提供當前運行的遊戲實例實時性能資訊的服務。其主要目的是提供一個端點來測量資源的消耗情況，以及總體消耗的內存量。

該服務還存儲了一棵 `Class.StatsItem` 物件樹，這些物件的值可以被插件讀取。


Stats:GetHarmonyQualityLevel

Stats:GetMemoryCategoryNames

返回所有可用類別所消耗的兆字節數。如果 `Class.Stats.MemoryTrackingEnabled|MemoryTrackingEnabled` 為 `false`，則調用 `GetMemoryUsageMbAllCategories()` 將返回空數組並在控制台發出警告。


Stats:GetMemoryUsageMbAllCategories

返回所有可用類別所消耗的兆字節數，或如果 `Class.Stats.MemoryTrackingEnabled|MemoryTrackingEnabled` 為 `false`，則返回空數組。


返回在指定的 `Enum.DeveloperMemoryTag` 類別中消耗的兆字節數。如果 `Class.Stats.MemoryTrackingEnabled|MemoryTrackingEnabled` 為 `false`，則調用 `GetMemoryUsageMbForTag()` 將返回 `0` 並在控制台發出警告。


Stats:GetMemoryUsageMbForTag

返回在指定的 `Enum.DeveloperMemoryTag` 類別中消耗的兆字節數，或如果 `Class.Stats.MemoryTrackingEnabled|MemoryTrackingEnabled` 為 `false`，則返回 `0`。


返回當前遊戲會話中消耗的總內存量，以兆字節為單位。

該方法從操作系統獲取內存使用情況，這可能不包括已經頁面交換到磁碟的內存。因此，返回值往往與所有 `Enum.DeveloperMemoryTag|DeveloperMemoryTags` 的總使用情況顯著不同。返回值應與 Windows 任務管理器或 macOS 活動監視器中的 Roblox 內存使用量非常相似。


Stats:GetTotalMemoryUsageMb

返回當前遊戲會話中消耗的總內存量，以兆字節為單位。


Stats:ResetHarmonyMemoryTarget

Stats:SetHarmonyMemoryTarget

targetMB

Stats

該屬性描述當前有多少部件彼此接觸，使得其中一個部件正在被物理模擬，因此可以被 `Class.BasePart:GetTouchingParts()` 方法識別。


Stats.ContactsCount

當前有多少部件相互接觸的測量值。


在網絡遊戲中，該屬性大致描述每秒當前實例接收了多少千字節的數據。如果從服務器的角度來看，這代表從連接到服務器的客戶端接收的總數據量。如果從客戶端的角度來看，這代表從服務器接收的總數據量。


Stats.DataReceiveKbps

在網絡遊戲中，這大致描述每秒當前實例接收了多少千字節的數據。


在網絡遊戲中，該屬性大致描述每秒當前實例發送了多少千字節的數據。如果從服務器的角度來看，這代表發送到連接到服務器的客戶端的總數據量。如果從客戶端的角度來看，這代表發送到服務器的總數據量。


Stats.DataSendKbps

在網絡遊戲中，這大致描述每秒當前實例發送了多少千字節的數據。


該屬性僅在客戶端腳本中可用，是測量最近一幀渲染所需時間的秒數。將 `1` 除以該值以計算幀時間的 FPS 值。較高的幀時間表明設備上的性能問題。考慮使用 [MicroProfiler](/studio/microprofiler) 進行故障排除。


Stats.FrameTime

引擎處理渲染一幀所需的所有任務所需時間的測量。


該屬性是服務器更新其任務調度程序作業所需的總時間的測量，單位為秒。如果該值較高，請檢查 [server compute](/performance-optimization/identifying#server-compute)。


Stats.HeartbeatTime

服務器更新其任務調度程序作業所需的總時間的測量，單位為秒。


`HeartbeatTimeMs` 屬性是Roblox更新所有任務調度程序作業所需的總時間的測量，單位為毫秒。如果該值較高，則意味著某個任務佔用了大量資源。


Stats.HeartbeatTimeMs

Roblox 更新所有任務調度程序作業所需的總時間的測量，單位為毫秒。


`InstanceCount` 是一個只讀的測量，表示當前在內存中的 `Class.Instance` 數量。這包括 `Class.DataModel` 及其後代，以及任何仍在內存中的通過 `Datatype.Instance.new()` 創建的對象。


Stats.InstanceCount

當前在內存中的 `Class.Instance` 數量的測量。


如果 `MemoryTrackingEnabled` 返回 `false`，則任何返回基於類別的內存使用的 API，比如 `Class.Stats:GetMemoryUsageMbForTag()` 或 `Class.Stats:GetMemoryUsageMbAllCategories()` 將返回 `0` 並發出警告。因此，對基於類別的內存使用 API 的使用應根據 `MemoryTrackingEnabled` 返回 `true` 而定。 `MemoryTrackingEnabled` 的值不會在不同的體驗間改變；它只會在重啟 Roblox 客戶端應用後改變。


Stats.MemoryTrackingEnabled

一個指示內存跟蹤是否啟用的標誌。這在下一次啟動客戶端之前保證不變。


一個測量當前在遊戲世界中移動的物理模擬組件的數量。


Stats.MovingPrimitivesCount

PhysicsReceiveKbps 是一個測量，表示在網絡遊戲中每秒當前實例接收的物理數據的千字節數。如果從服務器的角度來看，這代表從連接到服務器的客戶端接收的總物理數據量。如果從客戶端的角度來看，這代表從服務器接收的總物理數據量。


Stats.PhysicsReceiveKbps

在網絡遊戲中，這大致描述每秒當前實例接收了多少千字節的物理數據。


`PhysicsSendKbps` 大致描述每秒當前實例發送的物理數據的千字節數。如果從服務器的角度來看，這代表發送到連接到服務器的客戶端的總物理數據量。如果從客戶端的角度來看，這代表發送到服務器的總物理數據量。


Stats.PhysicsSendKbps

在網絡遊戲中，這大致描述每秒當前實例發送了多少千字節的物理數據。


該屬性是測量物理引擎更新其當前狀態所需的時間。如果該值較高，則意味著遊戲實例正因發生的物理模擬而受到壓力。


Stats.PhysicsStepTime

測量物理引擎更新其當前狀態所需的時間。


測量物理引擎以毫秒為單位更新其當前狀態所需的時間。如果該值較高，則意味著遊戲實例正因發生的物理模擬而受到壓力。


Stats.PhysicsStepTimeMs

測量當前在遊戲世界中存在的物理模擬組件的數量。


Stats.PrimitivesCount

該屬性測量 CPU 處理一幀的所有渲染任務所需的時間。


Stats.RenderCPUFrameTime

測量 CPU 處理一幀的所有渲染任務所需的時間。


該屬性測量 GPU 處理一幀所需的所有任務的時間。


Stats.RenderGPUFrameTime

測量 GPU 處理一幀所需的所有任務的時間。


該屬性測量遊戲當前場景中發出的繪製調用的數量。一個繪製調用是一個單一的渲染操作，比如繪製一個網格。較高的繪製調用計數可能表示場景過於複雜或未經優化，這可能導致性能問題。


Stats.SceneDrawcallCount

測量遊戲當前場景中發出的繪製調用的數量。


該屬性測量遊戲當前場景中渲染的三角形數量。渲染的三角形計數在評估場景的複雜性和性能時非常有用。


Stats.SceneTriangleCount

測量遊戲當前場景中渲染的三角形數量。


該屬性測量遊戲當前場景中針對陰影的繪製調用數量。較高的計數意味著場景中渲染的對象數量較多，從而創建了更多的陰影。


Stats.ShadowsDrawcallCount

測量遊戲當前場景中針對陰影的繪製調用數量。


該屬性測量遊戲當前場景中渲染的三角形數量，其作為陰影存在。較高的計數意味著存在大量三角形用於投射陰影，這可能影響性能。


Stats.ShadowsTriangleCount

測量遊戲當前場景中渲染的三角形數量，其作為陰影存在。


該屬性測量遊戲當前場景中針對 UI 元素的 2D 繪製調用數量。較高的計數可能意味著使用了大量 2D UI 元素。


Stats.UI2DDrawcallCount

測量遊戲當前場景中針對 UI 元素的 2D 繪製調用數量。


該屬性測量遊戲當前場景中渲染的 2D UI 元素的三角形數量。較高的計數可能意味著使用了許多或複雜的 2D UI 元素，這可能會影響渲染性能。


Stats.UI2DTriangleCount

測量遊戲當前場景中渲染的 2D UI 元素的三角形數量。


該屬性測量遊戲當前場景中針對 UI 元素的 3D 繪製調用數量。較高的計數可能表明在 UI 中使用了大量 3D 對象，這可能會影響性能；不過，由於 UI 元素通常是 2D 的，因此看到顯著的計數是非常不太可能的。


Stats.UI3DDrawcallCount

測量遊戲當前場景中針對 UI 元素的 3D 繪製調用數量。


該屬性測量遊戲當前場景中渲染的 3D UI 元素的三角形數量；不過，由於 UI 元素通常是 2D 的，因此看到顯著的計數是非常不太可能的。


Stats.UI3DTriangleCount

測量遊戲當前場景中渲染的 3D UI 元素的三角形數量。


`Instance` 是 Roblox 類別階層中所有類別的基礎類別，可作為 `Class.DataModel` 樹的一部分。

無法直接創建根 `Instance` 對象，但特殊的 `Datatype.Instance.new()` 構造函數通過代碼創建對象，並以類別的名稱作為參數，返回創建的對象。


演示如何通過連接到 `Class.Instance.AncestryChanged` 事件來檢測實例的祖先變化。

ChangingPart 的 Parent 隨著時間的推移而設置為不同的值。部分的父級是該部分的祖先，因此每當它變更時，`Class.Instance.AncestryChanged` 事件就會觸發。

當對象的 `Class.Instance.Parent` 屬性或其祖先之一被更改時觸發。

此事件包括兩個參數：`child` 指的是實際上 `Class.Instance.Parent` 被更改的 `Class.Instance`，而 `parent` 指的是此實例的新 `Class.Instance.Parent`。

你可以使用此事件追蹤在 Studio 中實例的刪除，例如通過 Explorer 手動刪除或通過插件。如果你需要檢測一個實例使用 `Class.Instance:Destroy()` 被銷毀的時機，請使用 `Class.Instance.Destroying` 事件。


Instance.AncestryChanged

child

已更改其 `Class.Instance.Parent` 的 `Class.Instance`。


parent

被更改的 `Class.Instance` 的新 `Class.Instance.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` 的項時。注意，此事件在子項被銷毀時（使用 `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` 後觸發。


以下範例在任何後代被移除時打印其名稱

從 Workspace 中：

此事件在父級的 `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()` 銷毀之前立即觸發（或延遲到之後觸發）。


此事件在實例上的任何樣式屬性改變時觸發，包括當屬性被設置為 `nil`。

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Styled properties changed")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```


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.BasePart|BaseParts` 的所有後代，這些後代來自 `Class.Model`：

```
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` 的實例。


Instance:clone

演示如何使用 `Class.Instance:Destroy()` 函數銷毀一個零件。

這個函數是正確處理不再需要的物件的方法。

將 `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.Object.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` 也具有 `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`。如果可選的 `recursive` 參數為 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()` 上的遞歸參數。


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("Attribute changed")
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 .. " is child number " .. i)
end
```

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

-- 通用循環範例
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. 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

返回包含實例所有後代的數組。


此代碼範例演示了 `Class.Instance:GetFullName()` 的行為。

它展示了當在不在 `DataModel` 階層中的物件上調用該函數時的行為，
並且還顯示了返回值如何不轉義特殊字符。

'此代碼範例重新實作了`Class.Instance:GetFullName()`函數
    在
    Lua。'

返回描述實例祖先的字符串。該字符串是 `Class.Instance.Name|Name` 的串聯以及其祖先，用句點分隔。`Class.DataModel`（`game`）不被考慮。例如，位於 `Class.Workspace` 中的 `Class.Part` 可能返回 `Class.Workspace.Part`。

當在不是 `Class.DataModel` 的後代上調用此方法時，此方法考慮所有祖先，最高的一個沒有 `Class.Instance.Parent|Parent`。

此方法對於日誌記錄和調試非常有用。您不應嘗試對返回的字符串進行解析以執行任何有用的操作；此方法不會轉義對象名稱中的句點（或任何其他符號）。換句話說，儘管其輸出通常看起來是一個有效的 Luau 標識符，但這並不保證。


Instance:GetFullName

返回描述實例的祖先的字符串。


此方法返回指定屬性的樣式或明確修改的值，或者如果尚未樣式/修改，則返回屬性的默認值。這與直接訪問屬性值有所不同，例如 `[GuiObject].Rotation`，該方法返回屬性的默認值或修改值。

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 對按鈕的引用
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (默認值)
print(button.Rotation) --> 0 (默認值)

-- 通過樣式規則屬性應用旋轉
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (基於規則的樣式值)
print(button.Rotation) --> 0 (默認值)

-- 明確修改/覆蓋樣式屬性
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (修改值)
print(button.Rotation) --> 45 (修改值)
```


Instance:GetStyled

返回指定屬性的樣式或明確修改的值，或者如果尚未樣式/修改，則返回屬性的默認值。


Instance

`Instance` 是 Roblox 類別階層中所有類別的基礎類別，可作為 `Class.DataModel` 樹的一部分。


Stats

概要

屬性

方法

活動

屬性

方法

活動

此頁面