NetworkSettings 是一個設置類別，允許您調試許多功能
與 Roblox 的伺服器/客戶端網絡。它可以在 Roblox Studio 的
設置中找到，位於 **Network** 標籤下。


NetworkSettings

NetworkSettings.EmulatedTotalMemoryInMB

FreeMemoryMBytes 是一個只讀屬性，描述可用的自由
內存量，以 MB 為單位。它以浮點數形式存儲，因此
可以通過將其值乘以 `1024 * 1024` 來以可用字節的級別讀取。


NetworkSettings.FreeMemoryMBytes

描述可用的自由內存量，以 MB 為單位。


NetworkSettings.HttpProxyEnabled

NetworkSettings.HttpProxyURL

指示引擎通過延遲所有進來的消息來模擬額外的延遲。
單位為秒。


NetworkSettings.IncomingReplicationLag

在網絡接收路徑中模擬額外的網絡延遲。


在連接後將診斷信息打印到輸出窗口。該
數據將指示發送的最大單個實例，以及
按實例類型發送的數據的匯總數據。為了初始
加載而發送的數據是壓縮的，因此貢獻是大約的。


NetworkSettings.PrintJoinSizeBreakdown

打印關於連接時發送的數據的診斷信息。


當設置為 true 時，將打印與物理複製錯誤相關的調試消息
到輸出中。請注意，此屬性旨在用於調試網絡複製的 Roblox 工程師。當此屬性設置為 true 時，以下是可用的調試輸出。

- `Physics-in old packet` 當 PhysicsReceiver 收到
  針對已在包提交時間之前更新的零件的
  機制更新包時打印。如果包延遲接收，且已處理較新的包，則會發生這種情況。
- `Physics-in of unidentified {GUID}` 當 PhysicsReceiver 無法
  找到嘗試更新的零件，因為提供的實例
  標識符無效時打印，其中 `{GUID}` 是未知的
  `Class.Instance:GetDebugId()` 標識符，應該針對該零件。
  如果在接收到物理更新包之前移除了一個零件，則通常會發生這種情況。
- `Physics-in of part not in workspace {GUID}` 當
  PhysicsReceiver 收到請求以更新不在 Workspace 的
  子代中的零件的物理時打印，其中 `{GUID}` 是
  目標零件的 `Class.Instance:GetDebugId()` 標識符。如果零件剛被移出 Workspace，並且之前正在模擬，則會發生這種情況。


NetworkSettings.PrintPhysicsErrors

當設置為 true 時，將打印與物理複製錯誤相關的調試消息
到輸出中。


當設置為 true 時，將打印有關當 `Class.Workspace.StreamingEnabled` 設置為
true 時實例複製的調試信息。有幾個調試輸出在此時可用，列舉如下。

請注意，此屬性旨在用於調試網絡複製的 Roblox 工程師。此文檔可能會隨著時間而過時，因為 Roblox 的網絡代碼始終在幕後變化。

#### 流媒體容量更新

當客戶端的流媒體容量更新時，將打印以下調試
消息：
`clientInstanceQuota {1}, packet in queue {2}, predictedTotalInstanceProcessTime {3}, avgStreamDataReadTime {4}, avgInstancesPerStreamData {5}`

**花括號中的數字會被替換，可以描述為：**

- `{1}` – 客戶端實例配額的ID。
- `{2}` – 當前排隊的進入包的數量。
- `{3}` – 對於更新配額需要多少時間的預測。
- `{4}` – 當前讀取流數據所需的平均時間。
- `{5}` – 每個流數據中的實例的平均數量。

#### 實例配額更新

當客戶端收到實例配額更新時，將打印以下調試
消息：
`Received new client instance quota: {1}, max region radius: {2}`

**花括號中的數字會被替換，可以描述為：**

- `{1}` – 客戶端實例配額的ID。
- `{2}` – 客戶端的 `Class.Player.ReplicationFocus` 周圍最大的空間半徑
  可以流式傳輸物理實例。


NetworkSettings.PrintStreamInstanceQuota

當設置為 true 時，將打印有關當 `Class.Workspace.StreamingEnabled` 設置為
true 時實例複製的調試信息。


通過隨機化實例最初到達客戶端的順序，模擬長時間在線的伺服器的行為。
建議在 Studio 測試時保持此設置啟用，以幫助發現潛在的錯誤。


NetworkSettings.RandomizeJoinInstanceOrder

幫助捕捉與您的體驗加載相關的錯誤的特殊功能。


當設置為 true 時，正在流式傳輸到客戶端的空間區域
將以紅色標出。這只有在 `Class.Workspace.StreamingEnabled` 設置為
true 時才會顯示。


NetworkSettings.RenderStreamedRegions

當設置為 true 時，正在流式傳輸到客戶端的空間區域
將以紅色標出。


當設置為 true 時，將在每個玩家的頭上顯示一個標籤，顯示
當前正在播放的 Player 的 `Class.Humanoid` 的動畫（如果有的話）。


NetworkSettings.ShowActiveAnimationAsset

`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`。

您可以使用此事件來跟踪在 Studio 中實例的刪除，例如通過 Explorer 的手動刪除或通過插件。如果您需要檢測實例通過 `Class.Instance:Destroy()` 被摧毀的情況，請改用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

已更改 `Class.Instance.Parent` 的 `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` 時觸發。

這段程式碼會在物件從

工作空間中移除時，印出其名稱：

當子項從此 `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`。

Instance.childAdded

此方法向實例應用標籤，如果標籤已經應用則無效。成功添加標籤會觸發由
`Class.CollectionService:GetInstanceAddedSignal()` 創建的信號，並帶有指定標籤。

##### 警告

- 若伺服器稍後添加或移除該實例上的標籤，則在客戶端添加的標籤將被放棄，
  因為伺服器一起複製所有標籤並覆蓋以前的標籤。

- 標記實例時，通常會使用一些資源來提供標籤功能，例如事件連接或表。為了防止內存泄漏，當標籤不再需要時，清理這些資源（斷開連接、設置為 `nil` 等）是個好主意。當調用 `Class.Instance:RemoveTag()`、調用 `Class.Instance:Destroy()`，或在連接到由 `Class.CollectionService:GetInstanceRemovedSignal()` 返回的信號的函數中進行清理。

Instance:AddTag

此方法銷毀實例的所有子物件和後代。

```
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|可複製` 的實例。此方法返回根實例的副本，其 `Class.Instance.Parent|父級` 設置為
`nil`。請注意，如果該實例本身的 `Class.Instance.Archivable|可複製` 設置為 `false`，則此方法將返回 `nil`。

如果在 cloned 實例中設置了如 `Class.ObjectValue.Value` 的引用屬性，副本屬性的值取決於原始值：

- 如果引用屬性指向的實例**也**被複製，則副本將指向該副本。
- 如果引用屬性指向的實例**未**被複製，則該值將在副本中保持不變。


Instance:Clone

創建實例及其所有後代的副本，忽略不符合 `Class.Instance.Archivable|Archivable` 的實例。

演示如何使用 `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|父級` 設置為 `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()`。

返回 `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` 的第一個祖先，
對於給定的 className 說 `Class.Object:IsA()` 返回 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` 的第一個祖先，
對於給定的 className 說 `Class.Object:IsA()` 返回 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.Folder` 類別名為 `Color` 的資料夾添加到 `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` 的第一個子物件。

返回 `Class.Instance` 的第一個子項，其 `Class.Object.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()` 返回 true，針對給定的 className。

返回擁有給定 `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("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|父級` 等於該對象。可以使用數字或通用 `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

返回包含所有實例子物件的數組。

返回 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|名稱` 連接而成，並以句點分隔。`Class.DataModel`（`game`）不予考慮。例如，在 `Class.Workspace` 中的 `Class.Part` 可能返回 `Class.Workspace.Part`。

當在不是 `Class.DataModel` 的子代的 `Class.Instance` 上調用時，此方法考慮所有祖先，直到包括沒有 `Class.Instance.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

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

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

此方法返回一個事件，該事件的行為完全類似於 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 事件，
但只有當給定樣式屬性發生變化時才會觸發。通常，最好使用此方法，而不是對 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 的連接以及檢查屬性名稱的函數。
對同一物件上使用相同屬性名稱的後續調用將返回相同事件。

請注意，此事件不會將任何參數傳遞給連接的函數，
因此必須直接在腳本中讀取已更改的屬性值。

```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("樣式屬性已更改！")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

要監聽其變更的樣式屬性名稱。

當給定樣式屬性發生變化時觸發的事件。

此方法返回應用於給定實例的標籤數組，為字符串類型。
您可以在 Studio 的 [屬性](/studio/properties) 窗口中或在運行時使用 `Class.Instance:AddTag()|AddTag()` 添加標籤。

當您想在一次處理中用多個標籤處理實例時，此方法非常有用。
但是，使用此方法檢查單個標籤的存在性是低效的；
相反，使用 `Class.Instance:HasTag()|HasTag()` 檢查特定標籤。

Instance:GetTags

獲取應用於實例的所有標籤的數組。

此方法返回`true`如果提供的標籤已添加到該物件。您可以在 Studio 的 [屬性](/studio/properties) 窗口中或在運行時使用 `Class.Instance:AddTag()|AddTag()` 添加標籤。

Instance:HasTag

演示如何確定一個實例是否是另一個實例的祖先，使用 `Class.Instance:IsAncestorOf()`

Workspace 和 SpawnLocation 是 SpawnLocation 的貼圖的祖先。

Workspace 是 SpawnLocation 的祖先。

SpawnLocation 及其貼圖是 Workspace 的後裔，而不是祖先。

Decal 是 SpawnLocation 的後裔，而不是祖先。

如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果物件的 `Class.Instance.Parent` 或它的父物件的 `Class.Instance.Parent` 設置為 `Class.Instance`，則視為該物件的祖先。

另見 `Class.Instance:IsDescendantOf()`。

Instance:IsAncestorOf

如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

注意 `IsDescendantOf()` 不能使用 `nil` 參數檢查物件是否已被移除。

另見 `Class.Instance:IsAncestorOf()`。

Instance:IsDescendantOf

ancestor

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

此方法指示特定屬性是否已從代碼實例化的默認值進行修改。如果在通過代碼新創建的實例上調用(`Datatype.Instance.new()`)，則此方法將返回 `false`。如果在通過Studio工作流程如 [Explorer](/studio/explorer) 窗口插入的新創建對象上調用，結果可能會有所不同。

例如，查詢通過 [Explorer](/studio/explorer) 插入的 `Class.TextLabel` 的 `Class.TextLabel.BackgroundColor3|背景色` 屬性將返回 `true`，但查詢通過 `Datatype.Instance.new()` 創建的 `Class.TextLabel` 的相同屬性將返回 `false`，假設對 `Class.TextLabel.BackgroundColor3|背景色` 沒有做其他更改。

請注意，如果此方法返回 `true`，則樣式**不會**影響該屬性，因為顯式修改屬性會優先於樣式。如果要將屬性重置為其代碼實例化的默認值並允許對其進行樣式設置，請使用 `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`。


Instance:IsPropertyModified

布林值，指示該屬性是否已從其代碼實例化的默認值進行修改。


如果指定屬性中存儲的值不等於代碼實例化的默認值，則返回 `true`。


此對象方法返回一個數組，其中包含匹配提供的 `selector` 字符串的該對象的子代。`selector` 字符串可以包含多個選擇器和組合器，以匹配類別名稱、實例名稱、層次關係、以及實例屬性和屬性的特定值等特徵。`selector` 文法類似於 `Class.StyleRule` 中使用的文法，僅在某些文法部分支持與否方面存在少數差異。

##### 選擇器

<table>
<thead>
  <tr>
    <th>選擇器</th>
    <th>說明</th>
    <th>示例</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>ClassName</code></td>
    <td>匹配指定類別的實例，關係為 <code>Class.Object:IsA()</code>。</td>
    <td><code>SpotLight</code><br /><code>ImageButton</code><br /><code>Part</code></td>
  </tr>
  <tr>
    <td><code>.Tag</code></td>
    <td>匹配帶有 <code>Class.CollectionService</code> 標籤的實例。</td>
    <td><code>.Fruit</code><br /><code>.IntenseLight</code></td>
  </tr>
  <tr>
    <td><code>#Name</code></td>
    <td>匹配特定 <code>Class.Instance.Name</code> 的實例。</td>
    <td><code>#RedTree</code><br /><code>#CloseButton</code></td>
  </tr>
  <tr>
    <td><code>[property = value]</code></td>
    <td>匹配具有指定屬性且該屬性具有指定值的實例。支持布林值、數字和字符串值。可以在沒有使用引號的情況下使用字母、數字、<code>_</code> 和 <code>-</code>。
    </td>
    <td><code>[CanCollide = false]</code><br />
    <code>[Brightness = "0.5"]</code><br />
    <code>[Name = Folder10]</code><br />
    <code>[Name = "Part.10"]</code></td>
  </tr>
  <tr>
    <td width="30%"><code>[$attribute = value]</code></td>
    <td>匹配具有指定屬性且該屬性具有指定值的實例。屬性選擇器的限制適用。
    </td>
    <td width="30%"><code>[$MyAttribute = 10]</code></td>
  </tr>
</tbody>
</table>

請注意，選擇器可以組合。例如，`Model.Apple[$Kind = "Red"][$State = 4]` 將匹配標記為 `Apple` 的 `Class.Model` 實例，並且其 `Kind` 屬性等於字符串 `"Red"` 以及 `State` 屬性等於 `4`。

##### 組合器

<table>
<thead>
  <tr>
    <th>組合器</th>
    <th>說明</th>
    <th>示例</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>&gt;</code></td>
    <td>匹配前一篩選匹配的<b>直接子項</b>。</td>
    <td><code>Part &gt; .SwordHandle</code></td>
  </tr>
  <tr>
    <td><code>&gt;&gt;</code></td>
    <td>匹配前一篩選匹配的<b>所有子代</b>。</td>
    <td><code>Model &gt;&gt; .TreeOnFire</code></td>
  </tr>
  <tr>
    <td width="10%"><code>,</code></td>
    <td>為子代查詢指定多個獨立選擇器的列表。</td>
    <td width="50%"><code>Part.TagA, Part[$UseForce = true]</code></td>
  </tr>
</tbody>
</table>

請注意，默認的第一篩選器是子代組合器 `>>`。如果選擇器以 `>` 開頭，則僅訪問子項；例如 `>Part.Apple` 選擇 **直接子項** 為 `Class.Part` 並且具有標籤 `Apple`。

默認組合器也可以明確指定，如 `>>SpotLight.Red` 與 `SpotLight.Red` 相同。

僅將符合篩選條件的元素放入數組中。例如，`>#ExistingChild, >#MissingChild, >#AnotherExistingChild` 將返回一個包含兩個元素的數組，並且沒有缺失子項的 `nil`。


Instance:QueryDescendants

selector

用於過濾元素的選擇器字符串。

一個數組的實例（如果沒有符合選擇器的項目則是空的）。

以下代碼示範了如何在被移除後，將一個部件重新添加到數據模型中：

此方法將物件的 `Class.Instance.Parent` 設置為 `nil`，並對其所有後代執行相同操作。

如果在移除之前引用該物件，則有可能稍後恢復該物件。

Instance:Remove

將物件的 `Parent` 設置為 `nil`，並對其所有後代執行相同操作。

此方法從實例中移除標籤。如果物件不存在該標籤，則不會引發錯誤。成功移除標籤將觸發由 `Class.CollectionService:GetInstanceRemovedSignal()` 創建的信號，並帶有該標籤。

注意，當標記實例時，通常會使用一些資源來提供標籤的功能，例如事件連接或表。為了防止內存泄漏，當標籤不再需要時，清理這些資源（斷開連接、設置為 `nil` 等）是個好主意。

Instance:RemoveTag

將屬性重置為其默認值。例如，在 `Class.TextLabel` 上調用 `ResetPropertyToDefault("Rotation")` 等同於將其 `Class.TextLabel.Rotation|Rotation` 設置為 0（屬性的默認值）。此方法可用於確保樣式會覆蓋此屬性的默認值。

Instance:ResetPropertyToDefault

此方法將具有給定名稱的屬性設置為給定值。如果給定的值為 `nil`，則該屬性將被移除，因為 `nil` 是默認返回值。

例如，以下代碼片段將實例的 `InitialPosition` 屬性設置為 `Datatype.Vector3|Vector3.new(0, 10, 0)`：

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### 限制

命名要求和限制：

- 名稱只能使用字母數字字符。
  - 您也可以包括句點、連字符、斜杠和下劃線。
- 不允許空格或唯一符號（如 @、~、!）。
- 字符串必須少於 100 個字符。
- 名稱不允許以 **RBX** 開頭，除非調用者是 Roblox 核心腳本（保留給 Roblox 使用）。

在嘗試將屬性設置為不支持的類型時，將引發錯誤。

##### 參見

- `Class.Instance:GetAttribute()`，它返回已分配給給定屬性名稱的值。
- `Class.Instance:GetAttributes()`，它返回每個實例屬性的鍵值對字典。

Instance:SetAttribute

value

將具有給定名稱的屬性設置為給定值。

以下代碼會等待一個名為 "Part" 的實例被添加到

    Workspace。

返回具有給定名稱的 `Class.Instance` 的子物件。如果子物件不存在，則會使當前線程暫停，直到它存在。如果指定 `timeOut` 參數，此方法將在指定的秒數後超時並返回 `nil`。

##### 主要用途

`Class.Instance:WaitForChild()|WaitForChild()` 在 `Class.LocalScript` 中運行的代碼時非常重要。
Roblox 引擎不保證物件從伺服器到客戶端的複製時間或順序。此外，
如果體驗的 `Class.Workspace.StreamingEnabled` 設置為 true，則距離玩家字符較遠的 `Class.BasePart|BaseParts` 可能不會被串流到客戶端，這可能導致在索引尚不存在於客戶端的物件時腳本出現問題。

##### 注意事項

- 如果在調用時存在給定名稱的子物件，則此方法不會使線程暫停。
- `Class.Instance:FindFirstChild()` 是 `Class.Instance:WaitForChild()|WaitForChild()` 的更有效替代方案，適用於假定存在的物件。
- 如果對此方法的調用超過 5 秒而不返回，並且未指定 `timeOut` 參數，則將在輸出中打印警告，表明線程可能會無限期暫停。

Instance:WaitForChild

childName

timeOut

返回具有給定名稱的 `Class.Instance` 的子物件。如果子物件不存在，則會使當前線程暫停，直到它存在。

子物件函數返回物件的子物件數組。

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

此屬性決定當體驗被發布或保存時，該實例是否應被包含，或者當對該實例的祖先之一
調用 `Class.Instance:Clone()|Clone()` 時，直接對實例調用 `Class.Instance:Clone()|Clone()`
將返回 `nil`，如果該實例 **不是** `Class.Instance.Archivable|Archivable`。

使用 **Duplicate** 或 **Copy**/**Paste** 選項在 Studio 中複製物件將忽略
其自己的 `Class.Instance.Archivable|Archivable` 屬性並將其為
複製設置 `Class.Instance.Archivable|Archivable` 為 `true`。

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```

Instance.Archivable

決定 `Class.Instance` 及其後代是否可以使用 `Class.Instance:Clone()` 被克隆，
並且可以被保存/發布。

允許在此實例內使用的腳本的能力集。要使能力生效，必須啟用 `Class.Instance.Sandboxed` 屬性。

此屬性由實驗性功能使用。請參見 [腳本能力](/scripting/capabilities) 獲取詳細資訊。

Instance.Capabilities

允許在此容器內使用的腳本的能力集。

`Class.Instance` 的非唯一識別符。名稱用於保持物件層次結構的有序，
並允許腳本訪問特定物件。實例的名稱不能超過 100 個字符。

物件的名稱通常用於通過數據模型層次結構訪問物件，使用以下方法：

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```
為了使用點運算符 (`.`) 訪問一個物件，它的名稱必須以底線或字母開頭，
而其餘名稱只能包含字母、數字或底線（不允許其他特殊字符）。
如果一個物件的名稱不符合此語法，它將無法使用點運算符訪問，
且 Luau 將不會將其名稱解釋為識別符。

如果具有相同名稱的多個物件是兄弟物件，則任何按該名稱索引物件的嘗試將僅返回其中一個物件，
類似於 `Class.Instance:FindFirstChild()`，但不一定是所需物件。
如果需要通過代碼訪問特定物件，建議給它一個唯一名稱或確保它的兄弟物件中沒有
共享相同的名稱。

另請參見 `Class.Instance:GetFullName()` 以獲取包含物件層次結構的完整名稱。

Instance.Name

`Class.Instance` 的非唯一識別符。

`Instance` 是 Roblox 類別層次結構中所有類別的基礎類別，
它們可以是 `Class.DataModel` 樹的一部分。

/reference/engine/classes/NetworkSettings.yaml

NetworkSettings

概要

屬性

方法

活動

屬性

方法

活動

此頁面