คอลแบ็กนี้จะถูกเรียกครั้งเดียวสำหรับผู้เล่นแต่ละคนเมื่อระดับความเชื่อถือของอุปกรณ์ของพวกเขาพร้อมใช้งาน ใช้เพื่อกำหนดว่าผู้เล่นสามารถอยู่ในเซิร์ฟเวอร์ได้หรือไม่ โดยอิงจาก `Class.Player.DeviceTrustLevel` และตาราง `measures`

โปรดจำสิ่งต่อไปนี้เมื่อคุณกำหนดคอลแบ็กนี้:

- คุณสามารถกำหนดมันได้จาก `Class.Script` ด้านเซิร์ฟเวอร์เท่านั้น การกำหนดจากไคลเอนต์จะทำให้เกิดข้อผิดพลาด
- ทุกสถานที่มีคอลแบ็กหนึ่งตัว หากคุณกำหนดมากกว่าหนึ่งครั้ง การกำหนดครั้งสุดท้ายจะแทนที่การกำหนดก่อนหน้า
- มันจะทำงานหลังจากที่ `Class.Players.PlayerAdded` ถูกเรียก เนื่องจากการตรวจสอบอุปกรณ์ใช้เวลา เมื่อมันทำงาน `Class.Player.DeviceTrustLevel` จะไม่เป็น `Enum.PlayerDeviceTrustLevel.Pending|Pending`.
- มันสามารถหยุดชั่วคราวได้ ผู้เล่นยังคงเล่นในขณะที่มันทำงาน ดังนั้นผู้เล่นที่ถูกปฏิเสธสามารถถูกตัดการเชื่อมต่อหลังจากที่พวกเขาเริ่มเล่น
- หากผู้เล่นออกจากเกม หรือสคริปต์ของคุณลบพวกเขา ก่อนที่ระดับความเชื่อถือของพวกเขาจะพร้อมใช้งาน จะไม่มีการเรียกสำหรับผู้เล่นนั้น
- Roblox จะไม่ตรวจสอบอุปกรณ์ใน Studio ดังนั้นมันจะไม่ถูกเรียกในระหว่างการทดสอบการเล่น

Roblox จะกรอง `Message` ที่กำหนดเองและย่อข้อความที่ยาวเกินไป หากการกรองจะเปลี่ยนข้อความ Roblox จะแสดงข้อความเริ่มต้นแทน

Roblox จะไม่เตะผู้เล่นในแต่ละกรณีต่อไปนี้:

- ไม่มีสคริปต์ใดกำหนดคอลแบ็ก
- คอลแบ็กส่งคืน `nil` ค่าที่ไม่ใช่ตาราง หรือ ตารางที่ไม่มี `Action` ที่ถูกต้อง
- คอลแบ็กเกิดข้อผิดพลาด Roblox จะรายงานข้อผิดพลาดเหมือนกับข้อผิดพลาดของสคริปต์อื่น ๆ
- คอลแบ็กไม่ส่งคืนทันเวลา

สำหรับตัวอย่างโค้ด ดูที่
[ระดับความเชื่อถือของอุปกรณ์](/scripting/security/device-trust).


IntegrityService.EvaluatePlayerDeviceTrust

player

`Class.Player` ที่กำลังถูกประเมิน ระดับความเชื่อถือของพวกเขาถูกตั้งค่าแล้วใน `Class.Player.DeviceTrustLevel` เมื่อคอลแบ็กนี้ทำงาน


measures

ตารางของคู่คีย์-ค่าอธิบายระดับความเชื่อถือของอุปกรณ์ของผู้เล่น ค่าของ `true` หมายความว่าอุปกรณ์ผ่านการวัดนั้น:

- `IsPlatformVersionSecure` &mdash; ระบบปฏิบัติการอยู่ที่หรือสูงกว่ารุ่นขั้นต่ำที่ Roblox ถือว่าปลอดภัย
- `IsPlatformBootSecure` &mdash; ระบบปฏิบัติการเริ่มต้นในสถานะที่ปลอดภัย
- `IsAppSecure` &mdash; แอป Roblox ไม่ได้ถูกดัดแปลง

การวัดที่ไม่มีอยู่ในอุปกรณ์จะอ่านว่า `true` ดังนั้นควรตรวจสอบ `Class.Player.DeviceTrustLevel` ด้วย


ตารางที่บอก Roblox ว่าจะทำอย่างไรกับผู้เล่น หรือ `nil` เพื่อให้พวกเขาอยู่:

- `Action` &mdash; จำเป็น `Enum.PlayerDeviceTrustDecision.Reject`
  จะตัดการเชื่อมต่อผู้เล่น `Enum.PlayerDeviceTrustDecision.Accept`
  จะทำให้พวกเขาอยู่
- `Message` &mdash; ไม่บังคับ ข้อความที่ผู้เล่นที่ถูกปฏิเสธเห็น หากคุณละเว้นมัน Roblox จะแสดงข้อความเริ่มต้นที่อธิบายว่าผู้เล่นอาจแก้ไขอุปกรณ์ของพวกเขาได้อย่างไร


ตัดสินใจว่าผู้เล่นสามารถอยู่ในเซิร์ฟเวอร์ได้หรือไม่เมื่อระดับความเชื่อถือของอุปกรณ์ของพวกเขาพร้อมใช้งาน


`IntegrityService` เปิดเผย API เพื่อวัด
[ระดับความเชื่อถือของอุปกรณ์](/scripting/security/device-trust) ของผู้เล่นทุกคนที่เข้าร่วมเกมของคุณ Roblox จะไม่ดำเนินการใด ๆ ตามระดับความเชื่อถือของอุปกรณ์; แทนที่คุณจะตัดสินใจว่ามันหมายถึงอะไรสำหรับประสบการณ์ของคุณ เช่น การปฏิเสธผู้เล่นที่ใช้อุปกรณ์ที่ไม่เชื่อถือได้ การจำกัดฟีเจอร์ที่ละเอียดอ่อน หรือการส่งผู้เล่นไปยังสถานที่อื่น

เพื่อยอมรับหรือปฏิเสธผู้เล่นแต่ละคนเมื่อระดับความเชื่อถือของพวกเขาพร้อมใช้งาน ให้กำหนดฟังก์ชันให้กับ
`Class.IntegrityService.EvaluatePlayerDeviceTrust|EvaluatePlayerDeviceTrust`.
เพื่ออ่านระดับความเชื่อถือของผู้เล่นในเวลาใดก็ได้ ให้ใช้
`Class.Player.DeviceTrustLevel`.

ระดับความเชื่อถือของอุปกรณ์อธิบายเกี่ยวกับอุปกรณ์ของผู้เล่น ไม่ใช่ผู้เล่นหรือบัญชีของพวกเขา **มันไม่ได้บอกคุณว่าผู้เล่นกำลังโกงหรือไม่** สำหรับตัวอย่างโค้ดและแนวทางในการเลือกนโยบาย ดูที่
[ระดับความเชื่อถือของอุปกรณ์](/scripting/security/device-trust).


IntegrityService

บริการที่ให้คุณตัดสินใจว่าประสบการณ์ของคุณจะตอบสนองต่อระดับความเชื่อถือของอุปกรณ์ของผู้เล่นแต่ละคนอย่างไร


`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาสของ Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`。

ไม่สามารถสร้างวัตถุ `Instance` รากได้โดยตรง แต่คอนสตรัคเตอร์พิเศษ
`Datatype.Instance.new()` สร้างวัตถุผ่านโค้ด โดยใช้ชื่อของคลาสเป็นพารามิเตอร์และส่งคืนวัตถุที่สร้างขึ้น。


แสดงให้เห็นถึงการตรวจจับการเปลี่ยนแปลงในเชิงสืบพรรณของอินสแตนซ์ โดยการเชื่อมต่อกับ
`Class.Instance.AncestryChanged` event.

พารต์ ChangingPart จะถูกตั้งค่า Parent เป็นค่าที่แตกต่างกันในช่วงเวลา พ่อแม่ของ
พารต์ คือบรรพบุรุษของพารต์ ดังนั้น `Class.Instance.AncestryChanged` event
จะถูกเรียกใช้เมื่อมันเปลี่ยนแปลง.

เกิดขึ้นเมื่ออินสแตนซ์นี้ถูกเปลี่ยนพ่อแม่หรือเมื่อบรรพบุรุษใดๆ ของมันถูกเปลี่ยนพ่อแม่.

คุณสามารถใช้เหตุการณ์นี้เพื่อติดตามการลบอินสแตนซ์ใน Studio เช่น การลบด้วยตนเองใน Explorer หรือผ่านปลั๊กอิน หากคุณต้องการตรวจจับเมื่ออินสแตนซ์ถูกทำลายโดยใช้ `Class.Instance:Destroy()` ให้ใช้เหตุการณ์ `Class.Instance.Destroying` แทน.


Instance.AncestryChanged

child

อินสแตนซ์ที่คุณสมบัติ `Class.Instance.Parent|Parent` เปลี่ยนแปลง ซึ่งอาจเป็นอินสแตนซ์นี้หรือบรรพบุรุษที่ห่างไกลกว่า **ไม่** จำเป็นต้องเป็นอินสแตนซ์ที่ตัวจัดการเชื่อมต่ออยู่.


parent

พ่อแม่ใหม่ของพารามิเตอร์ `child`.


เกิดขึ้นเมื่อคุณสมบัติ `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`.


โค้ดนี้จะแสดงชื่อของวัตถุเมื่อมันถูกเพิ่มเข้าไปใน Workspace:


เกิดขึ้นหลังจากวัตถุถูกตั้งเป็นพ่อแม่ของ `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` นี้.


Instance.childAdded

โค้ดนี้จะแสดงชื่อของวัตถุเมื่อมันถูกลบออกจาก
Workspace:


เกิดขึ้นหลังจากลูกถูกลบออกจาก `Class.Instance` นี้.

การลบหมายถึงเมื่อพ่อแม่ของวัตถุถูกเปลี่ยนจาก `Class.Instance` นี้ไปยังสิ่งอื่นที่ไม่ใช่ `Class.Instance` นี้ โปรดทราบว่าเหตุการณ์นี้จะเกิดขึ้นเมื่อมีการทำลายลูก (โดยใช้ `Class.Instance:Destroy()`) เนื่องจากฟังก์ชันการทำลายจะตั้งค่าพ่อแม่ของวัตถุเป็น `nil`.

เหตุการณ์นี้ทำงานเฉพาะสำหรับลูกโดยตรงของ `Class.Instance` สำหรับเหตุการณ์ที่จับคู่ลูกหลานทั้งหมด ให้ใช้ `Class.Instance.DescendantRemoving`.

ดูเพิ่มเติม `Class.Instance.ChildAdded`.


Instance.ChildRemoved

อินสแตนซ์ `Class.Instance` ที่ถูกลบ.


เกิดขึ้นหลังจากลูกถูกลบออกจาก `Class.Instance` นี้.


ตัวอย่างต่อไปนี้จะแสดงชื่อของวัตถุใดๆ ที่ถูกเพิ่มเข้าไปใน
Workspace:

เหตุการณ์นี้เกิดขึ้นหลังจากลูกหลานถูกเพิ่มไปยัง `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` จะถูกลบออก.


ตัวอย่างนี้แสดงให้เห็นว่า เมื่อใช้พฤติกรรมของสัญญาณทันที อินสแตนซ์ที่ถูกทำลายจะยังคงอยู่ในตำแหน่งจนกว่าฟังก์ชันที่เชื่อมโยงจะหยุด.

ตัวอย่างนี้แสดงให้เห็นว่าเมื่อใช้พฤติกรรมสัญญาณ Deferred\, อินสแตนซ์
จะถูกทำลายก่อนที่สัญญาณจะถูกเรียกใช้งาน

อินสแตนซ์ `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` ของตนเองเป็นปัญหา เนื่องจากสคริปต์จะถูกทำลายก่อนที่การเรียกกลับจะถูกเรียก (หมายความว่าจะไม่ถูกดำเนินการ).

เมื่อทำการลบ `Class.Instance` ใน Studio เช่น การลบด้วยตนเองผ่าน [Explorer](/studio/explorer) หรือผ่านปลั๊กอิน `Class.Instance` จะไม่ถูกทำลาย แทนที่จะตั้งค่าพ่อแม่เป็น `nil` ซึ่งคุณสามารถติดตามได้ด้วย `Class.Instance.AncestryChanged`.


Instance.Destroying

เกิดขึ้นทันที ก่อน (หรือถูกเลื่อนจนถึงหลัง) อินสแตนซ์จะถูกทำลายผ่าน `Class.Instance:Destroy()`.


แสดงให้เห็นถึง `Class.Instance.StyledPropertiesChanged`.


เหตุการณ์นี้เกิดขึ้นเมื่อใดก็ตามที่มีการเปลี่ยนแปลงคุณสมบัติสไตล์ใดๆ บนอินสแตนซ์ รวมถึงเมื่อมีการตั้งค่าคุณสมบัติเป็น `nil`.


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

สำเนาของอินสแตนซ์ หรือ `nil` หากอินสแตนซ์ไม่เป็น
`Class.Instance.Archivable|Archivable`。


สร้างสำเนาของอินสแตนซ์และลูกหลานทั้งหมด โดยไม่สนใจอินสแตนซ์
ที่ไม่เป็น `Class.Instance.Archivable|Archivable`。


Instance:clone

แสดงให้เห็นถึงการทำลาย Part โดยใช้ฟังก์ชัน `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.Name` ที่จะค้นหา。


ส่งคืนบรรพบุรุษแรกของ `Class.Instance` ที่มี
`Class.Instance.Name` เท่ากับชื่อที่กำหนด。


ส่งคืนบรรพบุรุษแรกของ `Class.Instance` ที่มี
`Class.Object.ClassName` เท่ากับ className ที่กำหนด。

วิธีนี้ทำงานขึ้นไป หมายความว่ามันเริ่มจาก `Class.Instance.Parent` ทันทีของอินสแตนซ์และทำงานขึ้นไปจนถึง `Class.DataModel` หากไม่พบบรรพบุรุษที่ตรงกัน จะส่งคืน `nil`。

การใช้งานทั่วไปของวิธีนี้คือการค้นหา `Class.Model` ที่ `Class.BasePart` เป็นของมัน ตัวอย่างเช่น:

```
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()` ส่งคืน true สำหรับ className ที่กำหนด。

วิธีนี้ทำงานขึ้นไป หมายความว่ามันเริ่มจาก `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()` ส่งคืน true สำหรับ className ที่กำหนด。


ด้านล่างนี้จะค้นหาใน Workspace สำหรับวัตถุชื่อ "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` ที่พบด้วยชื่อที่กำหนด。


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()` ส่งคืน true สำหรับ className ที่กำหนด。

หากไม่พบลูกที่ตรงกัน วิธีนี้จะส่งคืน `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()` ส่งคืน true สำหรับ className ที่กำหนด。


ส่งคืนลูกหลานคนแรกที่พบด้วยชื่อ `Class.Instance.Name` ที่กำหนด。

วิธีนี้ถูกปิดใช้งานและไม่สามารถใช้ได้ หากต้องการค้นหาลูกหลานคนแรกของอินสแตนซ์ ให้พิจารณาใช้พารามิเตอร์ `recursive` บน
`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` พร้อมกับฟังก์ชันที่ตรวจสอบชื่อคุณสมบัติ การเรียกวิธีนี้ซ้ำบนวัตถุเดียวกันด้วยชื่อคุณสมบัติเดียวกันจะส่งคืนเหตุการณ์เดียวกัน。

โค้ดตัวอย่างต่อไปนี้ส่งคืนสัญญาณที่เกิดฟังก์ชัน
`attributeChanged()` เมื่อคุณสมบัติ `InitialPosition` ของชิ้นส่วนมีการเปลี่ยนแปลง:

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


ส่งคืนพจนานุกรมของคุณสมบัติของอินสแตนซ์。


ด้านล่างนี้จะแสดงชื่อของวัตถุทั้งหมดที่อยู่ใน Workspace ขณะทำการรัน

ส่งคืนอาร์เรย์ (ตารางที่มีดัชนีเชิงตัวเลข) ที่ประกอบด้วยลูกทั้งหมดของ
อินสแตนซ์โดยตรง หรือทุก `Class.Instance` ที่มี
`Class.Instance.Parent|Parent` เท่ากับวัตถุ อาร์เรย์สามารถวนรอบได้โดยใช้ลูปเชิงตัวเลขหรือทั่วไป:

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

ส่งคืนสตริงที่เข้ารหัสของ ID ดีบักที่ใช้ภายในโดย Roblox หมายเหตุว่า:

- รายการนี้ถูกป้องกัน การพยายามใช้ใน `Class.Script` หรือ
  `Class.LocalScript` จะทำให้เกิดข้อผิดพลาด。
- ID ดีบักคือ ID ที่ใช้ในกระบวนการดีบัก มันช่วยให้ดีบักเกอร์อ่านคำสั่งแต่ละคำก่อนที่แอปพลิเคชันจะประมวลผลมัน วัตถุทั้งหมดใน
  Roblox ทำงานเหมือนกระบวนการและแต่ละคำสั่ง (หรือ 'โค้ด') ที่สามารถ
  ถูกดีบักได้หากจำเป็น。
- สิ่งนี้อาจมีประโยชน์สำหรับปลั๊กอินที่ต้องการแยกแยะวัตถุที่คล้ายกันจากกัน (เช่น วัตถุที่มีชื่อเดียวกัน)。


Instance:GetDebugId

scopeLength

ความยาวของขอบเขต。


ส่งคืนสตริงที่เข้ารหัสของ ID ดีบักที่ใช้ภายในโดย Roblox。


GetDescendants มักถูกใช้เพื่อทำสิ่งต่าง ๆ กับทายาททั้งหมดที่เป็น
ประเภทของวัตถุที่เฉพาะเจาะจง โค้ดในตัวอย่างนี้ใช้ GetDescendants และ
`Class.Instance:IsA()` เพื่อหาเนื้อหาทั้งหมดใน Workspace และเปลี่ยน
ให้เป็นสีเขียว.

วิธีนี้ส่งคืนอาร์เรย์ที่ประกอบด้วยลูกหลานทั้งหมดของวัตถุ โดยไม่เหมือนกับ `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.Part` ใน `Class.Workspace` อาจส่งคืน `Class.Workspace.Part`。

เมื่อเรียกบน `Class.Instance` ที่ไม่เป็นลูกหลานของ `Class.DataModel` วิธีนี้จะพิจารณาบรรพบุรุษทั้งหมดจนถึงและรวมถึงบรรพบุรุษที่สูงที่สุดที่ไม่มี `Class.Instance.Parent|Parent`。

วิธีนี้มีประโยชน์สำหรับการบันทึกและการดีบัก คุณไม่ควรพยายามวิเคราะห์สตริงที่ส่งคืนเพื่อการดำเนินการที่มีประโยชน์; วิธีนี้ไม่หลีกเลี่ยงจุด (หรือสัญลักษณ์อื่น ๆ) ในชื่อวัตถุ กล่าวอีกนัยหนึ่ง แม้ว่าผลลัพธ์ของมันมักจะดูเหมือนเป็นตัวระบุ Luau ที่ถูกต้อง แต่ก็ไม่รับประกัน。


Instance:GetFullName

ชื่อเต็มของ `Class.Instance`。


ส่งคืนสตริงที่อธิบายถึงบรรพบุรุษของอินสแตนซ์。


แสดงให้เห็นถึง `Class.Instance:GetStyled()`.


วิธีนี้ส่งคืนค่าที่ถูกจัดรูปแบบหรือแก้ไขอย่างชัดเจนของคุณสมบัติที่กำหนด หรือค่าคุณสมบัติเริ่มต้นหากยังไม่ได้ถูกจัดรูปแบบ/แก้ไข วิธีนี้แตกต่างจากการเข้าถึงค่าคุณสมบัติโดยตรง เช่น `[GuiObject].Rotation` ซึ่งส่งคืนค่าที่ถูกจัดรูปแบบหรือแก้ไขของคุณสมบัติ。


Instance:GetStyled

ชื่อของคุณสมบัติที่จะสอบถาม。


selector

ตัวเลือกเสริมสำหรับอินสแตนซ์เสมือนที่คุณกำลังมุ่งเป้าไปที่อินสแตนซ์。


ค่าที่ถูกจัดรูปแบบหรือแก้ไขอย่างชัดเจนของคุณสมบัติที่กำหนด หรือค่าคุณสมบัติเริ่มต้นหากยังไม่ได้ถูกจัดรูปแบบ/แก้ไข。


ส่งคืนค่าที่ถูกจัดรูปแบบหรือแก้ไขอย่างชัดเจนของคุณสมบัติที่กำหนด
หรือค่าคุณสมบัติเริ่มต้นหากยังไม่ได้ถูกจัดรูปแบบ/แก้ไข。


แสดงให้เห็นถึง `Class.Instance:GetStyledPropertyChangedSignal()`.


วิธีนี้ส่งคืนเหตุการณ์ที่ทำงานเหมือนกับเหตุการณ์
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` แต่จะเกิดขึ้นเฉพาะเมื่อคุณสมบัติสไตล์ที่กำหนดมีการเปลี่ยนแปลง โดยทั่วไปแล้วเป็นความคิดที่ดีที่จะใช้วิธีนี้แทนการเชื่อมต่อกับ
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` พร้อมกับฟังก์ชันที่ตรวจสอบชื่อคุณสมบัติ การเรียกวิธีนี้ซ้ำบนวัตถุเดียวกันด้วยชื่อคุณสมบัติเดียวกันจะส่งคืนเหตุการณ์เดียวกัน。

หมายเหตุว่าเหตุการณ์นี้จะไม่ส่งผ่านอาร์กิวเมนต์ใด ๆ ไปยังฟังก์ชันที่เชื่อมต่อ ดังนั้นค่าของคุณสมบัติที่เปลี่ยนแปลงจะต้องถูกอ่านโดยตรงภายในสคริปต์。


Instance:GetStyledPropertyChangedSignal

property

ชื่อของคุณสมบัติสไตล์ที่ต้องการฟังการเปลี่ยนแปลง。


เหตุการณ์ที่เกิดขึ้นเมื่อคุณสมบัติสไตล์ที่กำหนดมีการเปลี่ยนแปลง。


ส่งคืนเหตุการณ์ที่เกิดขึ้นเมื่อคุณสมบัติสไตล์ที่กำหนดมีการเปลี่ยนแปลงบนอินสแตนซ์。


วิธีนี้ส่งคืนอาร์เรย์ของแท็กที่ใช้กับอินสแตนซ์ที่กำหนดในรูปแบบของสตริง คุณสามารถเพิ่มแท็กได้ทั้งใน Studio ใน
หน้าต่าง [Properties](/studio/properties) หรือในระหว่างการทำงานด้วย
`Class.Instance:AddTag()|AddTag()`。

วิธีนี้มีประโยชน์เมื่อคุณต้องการทำบางอย่างกับแท็กหลาย ๆ อันบนอินสแตนซ์ในครั้งเดียว อย่างไรก็ตาม การใช้วิธีนี้เพื่อตรวจสอบการมีอยู่ของแท็กเดียวไม่เป็นที่มีประสิทธิภาพ; แทนที่จะใช้
`Class.Instance:HasTag()|HasTag()` เพื่อตรวจสอบแท็กเฉพาะ。


Instance:GetTags

อาร์เรย์ของสตริงแต่ละตัวที่แสดงถึงแท็กที่ใช้กับอินสแตนซ์。


ดึงอาร์เรย์ของแท็กทั้งหมดที่ใช้กับอินสแตนซ์。


วิธีนี้ส่งคืน `true` หากแท็กที่ให้ไว้ถูกเพิ่มไปยังวัตถุ คุณสามารถเพิ่มแท็กได้ทั้งใน Studio ใน
หน้าต่าง [Properties](/studio/properties) หรือในระหว่างการทำงานด้วย
`Class.Instance:AddTag()|AddTag()`。


Instance:HasTag

แท็กที่ต้องตรวจสอบบนอินสแตนซ์。


`true` หากอินสแตนซ์มีแท็กที่กำหนด `false` หากไม่เป็นเช่นนั้น。


ตรวจสอบว่าอินสแตนซ์มีแท็กที่กำหนดหรือไม่。


แสดงให้เห็นถึงการกำหนดว่าตัวอย่างหนึ่งเป็นบรรพบุรุษของอีกตัวอย่างหนึ่งหรือไม่โดยใช้
`Class.Instance:IsAncestorOf()`

Workspace และ SpawnLocation เป็นบรรพบุรุษของ decal ของ SpawnLocation.
Workspace เป็นบรรพบุรุษของ SpawnLocation.

SpawnLocation และ decal ของมันเป็นลูกหลานของ Workspace ไม่ใช่บรรพบุรุษ.
Decal เป็นลูกหลานของ SpawnLocation ไม่ใช่บรรพบุรุษ.


ส่งคืน true หาก `Class.Instance` เป็นบรรพบุรุษของลูกหลานที่กำหนด。

`Class.Instance` ถือเป็นบรรพบุรุษของวัตถุหาก `Class.Instance.Parent` ของวัตถุหรือหนึ่งในผู้ปกครองของมัน
`Class.Instance.Parent` ถูกตั้งค่าเป็น `Class.Instance`。

ดูเพิ่มเติม `Class.Instance:IsDescendantOf()`。


Instance:IsAncestorOf

ลูกหลาน `Class.Instance`。


จริงหาก `Class.Instance` เป็นบรรพบุรุษของลูกหลานที่กำหนด。


ส่งคืน true หาก `Class.Instance` เป็นบรรพบุรุษของลูกหลานที่กำหนด。


ส่งคืน `true` หาก `Class.Instance` เป็นลูกหลานของบรรพบุรุษที่กำหนด。

หมายเหตุว่า `IsDescendantOf()` ไม่สามารถใช้กับพารามิเตอร์ `nil` เพื่อตรวจสอบว่าวัตถุถูกลบออกหรือไม่。

ดูเพิ่มเติม `Class.Instance:IsAncestorOf()`。


Instance:IsDescendantOf

ancestor

บรรพบุรุษ `Class.Instance`。


จริงหาก `Class.Instance` เป็นลูกหลานของบรรพบุรุษที่กำหนด。


ส่งคืน `true` หาก `Class.Instance` เป็นลูกหลานของบรรพบุรุษที่กำหนด。


Instance:isDescendantOf

วิธีนี้ระบุว่าคุณสมบัติที่เฉพาะเจาะจงถูกแก้ไขจากค่าเริ่มต้นที่สร้างจากโค้ดหรือไม่ หากเรียกบนอินสแตนซ์ที่สร้างขึ้นใหม่ผ่าน
โค้ด (`Datatype.Instance.new()`) วิธีนี้จะส่งคืน `false` หากเรียกบนวัตถุที่สร้างขึ้นใหม่โดยการทำงานของ Studio เช่น
การแทรกในหน้าต่าง [Explorer](/studio/explorer) ผลลัพธ์อาจแตกต่างกัน。

ตัวอย่างเช่น การสอบถามคุณสมบัติ
`Class.TextLabel.BackgroundColor3|BackgroundColor3` ของ
`Class.TextLabel` ที่แทรกผ่านหน้าต่าง [Explorer](/studio/explorer)
จะส่งคืน `true` แต่การสอบถามคุณสมบัติเดียวกันของ `Class.TextLabel`
ที่สร้างขึ้นผ่าน `Datatype.Instance.new()` จะส่งคืน `false` โดยสมมติว่าไม่มีการเปลี่ยนแปลงอื่น ๆ ที่ทำกับ
`Class.TextLabel.BackgroundColor3|BackgroundColor3`。

หมายเหตุว่าวิธีนี้จะส่งคืนผลลัพธ์ที่มีประโยชน์เฉพาะสำหรับบริการและ
อินสแตนซ์ที่ผู้ใช้สร้างขึ้น ค่ารีเทิร์นสำหรับคุณสมบัติที่ถูกกรอกโดยระบบของ
อินสแตนซ์เช่น `Class.PackageLink` เป็นพฤติกรรมที่ไม่แน่นอน。

นอกจากนี้ หมายเหตุว่าหากวิธีนี้ส่งคืน `true` การจัดรูปแบบจะ **ไม่** ส่งผลกระทบต่อ
คุณสมบัติเนื่องจากการแก้ไขคุณสมบัติอย่างชัดเจนมีความสำคัญมากกว่าการจัดรูปแบบมัน หากต้องการรีเซ็ตคุณสมบัติเป็นค่าเริ่มต้นที่สร้างจากโค้ดและอนุญาตให้มีการจัดรูปแบบบนมัน ให้ใช้
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`。


Instance:IsPropertyModified

Boolean ที่บ่งชี้ว่าคุณสมบัตินั้นถูกแก้ไขจากค่าเริ่มต้นที่สร้างจากโค้ดหรือไม่。


ส่งคืน `true` หากค่าที่เก็บไว้ในคุณสมบัติที่กำหนดไม่เท่ากับค่าเริ่มต้นที่สร้างจากโค้ด。


วิธีการของวัตถุนี้จะส่งคืนอาร์เรย์ที่ประกอบด้วยลูกหลานทั้งหมดของวัตถุที่ตรงกับสตริง `selector` ที่ให้มา `selector` สามารถรวมหลายตัวเลือกและตัวรวมเพื่อจับคู่ลักษณะต่างๆ เช่น ชื่อคลาส ชื่ออินสแตนซ์ และความสัมพันธ์ในลำดับชั้น รวมถึงค่าที่เฉพาะเจาะจงของคุณสมบัติและแอตทริบิวต์ของอินสแตนซ์ ไวยากรณ์ของ `selector` จะคล้ายกับที่ใช้ใน `Class.StyleRule` โดยมีความแตกต่างเพียงเล็กน้อยเกี่ยวกับส่วนใดของไวยากรณ์ที่รองรับหรือไม่

#### ตัวเลือก

- `ClassName` — ตรงกับอินสแตนซ์ของคลาสที่ระบุในความสัมพันธ์ `Class.Object:IsA()`.
- `.Tag` — ตรงกับอินสแตนซ์ที่มีแท็กด้วยแท็ก `Class.CollectionService`.
- `#Name` — ตรงกับอินสแตนซ์ของ `Class.Instance.Name` ที่เฉพาะเจาะจง.
- `[property = value]` — ตรงกับอินสแตนซ์ที่มีคุณสมบัติที่ระบุและคุณสมบัตินั้นมีค่าที่ระบุ ค่าบูลีน หมายเลข และสตริงได้รับการสนับสนุน ตัวอักษร หมายเลข `_` และ `-` สามารถใช้ได้โดยไม่ต้องใส่ค่าในเครื่องหมายคำพูด.
- `[$attribute]` — ตรงกับอินสแตนซ์ที่มีแอตทริบิวต์ที่ระบุ [attribute](/studio/properties#instance-attributes) ตั้งค่า.
- `[$attribute = value]` — ตรงกับอินสแตนซ์ที่มีแอตทริบิวต์ที่ระบุ **และ** แอตทริบิวต์นั้นมีค่าที่ระบุ ข้อจำกัดเดียวกันใช้กับตัวเลือกคุณสมบัติ หากคุณต้องการตรวจสอบการไม่มีแอตทริบิวต์ อย่าค้นหามันเป็น `nil`; แทนที่จะใช้คลาสพิเศษ `:not` เช่น `:not([$attribute])`.

ตัวเลือกยังสามารถรวมกันได้ ตัวอย่างเช่น `Model.Apple[$Variety = Fuji][$Flavor = 4]` จะตรงกับอินสแตนซ์ที่เป็น `Class.Model` ที่มีแท็กว่า `Apple` และมีแอตทริบิวต์ `Variety` เท่ากับ `Fuji` รวมถึงแอตทริบิวต์ `Flavor` เท่ากับ `4`.

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

-- รับลูกหลานทั้งหมดที่เป็น MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- รับลูกหลานทั้งหมดที่มีแท็กว่า "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- รับลูกหลานทั้งหมดที่มีชื่อว่า "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- รับลูกหลานทั้งหมดที่มีคุณสมบัติ CanCollide ตั้งค่าเป็น false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- รับลูกหลานทั้งหมดที่มีแอตทริบิวต์ "FuelCapacity" ที่กำหนด
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- รับลูกหลานทั้งหมดที่มีแอตทริบิวต์ "FuelCapacity" ตั้งค่าเป็น 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### ตัวรวม

ตัวรวมช่วยให้คุณผสมผสานตัวเลือกพื้นฐานเพื่อตรงกับความสัมพันธ์ในลำดับชั้นที่ลึกขึ้น.

- `>` — ตรงกับอินสแตนซ์ที่เป็น **ลูกโดยตรง** ของการจับคู่ตัวกรองก่อนหน้า.

- `>>` — ตรงกับอินสแตนซ์ที่เป็น **ลูกหลาน** ของการจับคู่ตัวกรองก่อนหน้า นี่คือการกรองแรกที่ตั้งค่าเป็นค่าเริ่มต้น หมายความว่า `SpotLight.Red` จะเหมือนกับ `>> SpotLight.Red`.

- `,` — ระบุรายการของตัวเลือกอิสระหลายตัวสำหรับการค้นหาลูกหลาน เท่านั้นที่ตรงกับตัวกรองจะถูกวางในอาร์เรย์ที่ส่งคืน; `nil` จะไม่รวมอยู่ในรายการค้นหาสำหรับการไม่ตรงกัน.

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

-- รับลูกโดยตรงของโมเดลใดๆ ที่มีแท็กว่า "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- รับลูกโดยตรงที่เป็น Part และมีแท็กว่า "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- รับลูกหลานของโมเดลใดๆ ที่มีแอตทริบิวต์ "OnFire" ตั้งค่าเป็น true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- รับลูกหลาน MeshPart ที่มีแท็กว่า "SwordPart" หรือมีแอตทริบิวต์ "OnFire" ตั้งค่าเป็น true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### ตัวเลือกคลาสพิเศษ

- `:not(complex-selector-list)` — อนุญาตให้เลือกอินสแตนซ์ที่ **ไม่** ตรงกับตัวเลือกใดๆ ภายใน ซึ่งจะทำการปฏิเสธตัวเลือกอย่างมีประสิทธิภาพ เนื่องจากนิพจน์ภายในเป็นรายการของตัวเลือกที่ซับซ้อน จึงเป็นไปได้ที่จะกรองตามเงื่อนไขหลายประการ.

- `:has(relative-selector-list)` — อนุญาตให้เลือกอินสแตนซ์ตามว่ามีอินสแตนซ์ใดบ้างที่อยู่ภายใน ตัวเลือกจะถูกประเมินสัมพันธ์กับแต่ละอินสแตนซ์.

- `:in-radius(studs, complex-selector-list)` เลือกอินสแตนซ์ภายในจำนวนสตั๊ดที่กำหนด รายการตัวเลือกจะถูกประเมินกับอินสแตนซ์ทั้งหมดที่ตรงกับการค้นหา นี่คือการประเมินการเข้าร่วม.

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

-- รับลูกหลานทั้งหมดที่ไม่ใช่คลาส SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- รับลูกหลานทั้งหมดที่ไม่ใช่คลาส SpotLight หรือ PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- รับลูกหลานทั้งหมดที่ไม่มีแอตทริบิวต์ "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- รับลูกหลานทั้งหมดยกเว้นลูกของโมเดลที่มีแท็กว่า "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- รับลูกหลานที่มีอินสแตนซ์ Tool เป็นลูกหลานของตนเอง
print(Workspace:QueryDescendants(":has(Tool)"))
-- รับลูกหลาน MeshPart ที่มีลูกโดยตรงที่มีแท็กว่า "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- รับลูกหลาน MeshPart ที่มีลูกโดยตรงไม่ใช่คลาส SurfaceAppearance หรือ Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))

-- รับโมเดล Fireball ภายใน 10 สตั๊ดจาก HumanoidRootPart (ผู้เล่นหรือ NPC)
print(Workspace:QueryDescendants("Model.FireBall:in-radius(10, Model:has(> Part#HumanoidRootPart))"))
```


Instance:QueryDescendants

สตริงตัวเลือกที่ใช้กรององค์ประกอบ.


อาร์เรย์ของอินสแตนซ์ (ว่างเปล่าหากไม่มีการจับคู่กับตัวเลือก).


ส่งคืนอาร์เรย์ที่ประกอบด้วยลูกหลานทั้งหมดของอินสแตนซ์ที่ตรงกับ
สตริง `selector`。


โค้ดต่อไปนี้แสดงให้เห็นว่าชิ้นส่วนสามารถถูกเพิ่มกลับไปยัง DataModel ได้อย่างไรหลังจากถูกลบออก:

วิธีนี้ตั้งค่า `Class.Instance.Parent` ของวัตถุเป็น `nil` และทำเช่นเดียวกันกับลูกหลานทั้งหมด.

หากมีการอ้างอิงถึงวัตถุก่อนที่จะถูกลบ สามารถเรียกคืนวัตถุในภายหลังได้.


Instance:Remove

ตั้งค่า `Parent` ของวัตถุเป็น `nil` และทำเช่นเดียวกันกับลูกหลานทั้งหมด.


Instance:remove

วิธีนี้ลบแท็กออกจากอินสแตนซ์ จะไม่เกิดข้อผิดพลาดหากวัตถุไม่มีแท็ก การลบแท็กสำเร็จจะทำให้เกิดสัญญาณที่สร้างโดย `Class.CollectionService:GetInstanceRemovedSignal()` พร้อมแท็กที่กำหนด.

โปรดทราบว่าเมื่อแท็กอินสแตนซ์ มักจะมีการใช้ทรัพยากรบางอย่างเพื่อให้แท็กทำงานได้ เช่น การเชื่อมต่อเหตุการณ์หรือตาราง เพื่อป้องกันการรั่วไหลของหน่วยความจำ จึงเป็นความคิดที่ดีที่จะทำความสะอาดสิ่งเหล่านี้ (ตัดการเชื่อมต่อ ตั้งค่าเป็น `nil` เป็นต้น) เมื่อไม่ต้องการใช้งานอีกต่อไปสำหรับแท็ก.


Instance:RemoveTag

แท็กที่จะลบออกจากอินสแตนซ์.


ลบแท็กออกจากอินสแตนซ์.


รีเซ็ตคุณสมบัติเป็นค่าดีฟอลต์ ตัวอย่างเช่น การเรียก `ResetPropertyToDefault("Rotation")` บน `Class.TextLabel` เท่ากับการตั้งค่า `Class.TextLabel.Rotation|Rotation` เป็น `0` (ค่าดีฟอลต์ของคุณสมบัติ) วิธีนี้สามารถใช้เพื่อให้แน่ใจว่าสไตล์จะเขียนทับค่าดีฟอลต์ของคุณสมบัตินี้.


Instance:ResetPropertyToDefault

รีเซ็ตคุณสมบัติเป็นค่าดีฟอลต์.


Instance

`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาสของ Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`。


/reference/engine/classes/IntegrityService.yaml

ข้อมูลสรุป