`FluidForceSensor` là một `Class.SensorBase` xuất kết quả mô phỏng lực chất lỏng
từ khung vật lý cuối cùng cho phần mà nó được gắn vào.
Cảm biến xuất ra `Class.FluidForceSensor.Force|Force`,
`Class.FluidForceSensor.Torque|Torque` và
`Class.FluidForceSensor.CenterOfPressure|CenterOfPressure` được tính toán
bởi mô phỏng lực chất lỏng trên khung vật lý cuối cùng.


Tính toán không đồng bộ lực, mô men xoắn và trung tâm áp lực cho phần
cha của cảm biến dựa trên các đầu vào đã cung cấp.


FluidForceSensor:EvaluateAsync

linearVelocity

Tốc độ tuyến tính trong tọa độ thế giới.


angularVelocity

Tốc độ góc trong tọa độ thế giới.


cframe

`Datatype.CFrame` để được sử dụng cho đánh giá.


Một tuple gồm `Class.FluidForceSensor.Force|Force`,
`Class.FluidForceSensor.Torque|Torque` và
`Class.FluidForceSensor.CenterOfPressure|CenterOfPressure` được tính toán
khi dựa trên các tham số đầu vào.


FluidForceSensor

Trung tâm áp lực lắp ráp bị dịch ra khỏi trung tâm khối lượng của nó trong
tọa độ thế giới.


FluidForceSensor.CenterOfPressure

Lực chất lỏng lắp ráp trong tọa độ thế giới.


FluidForceSensor.Force

Mô men xoắn chất lỏng lắp ráp trong tọa độ thế giới.


FluidForceSensor.Torque

Một `Class.SensorBase` xuất ra `Class.FluidForceSensor.Force|Force`,
`Class.FluidForceSensor.Torque|Torque` và
`Class.FluidForceSensor.CenterOfPressure|CenterOfPressure`.


Một `Class.SensorBase` là một thể hiện mà khi được gán cho một `Class.BasePart`,
phát ra dữ liệu bổ sung về thế giới xung quanh phần đó. Dữ liệu này được
trình bày trong danh mục thuộc tính "output" của cảm biến. Thông thường, các hệ thống khác
sẽ tiêu thụ dữ liệu xuất ra từ cảm biến.


SensorBase.OnSensorOutputChanged

SensorBase:Sense

SensorBase

Xác định cách mà cảm biến sẽ cập nhật dữ liệu xuất ra của nó.

Với `Enum.SensorUpdateType.OnRead`, logic cảm biến nội bộ sẽ được thực thi để
dữ liệu thuộc tính xuất ra luôn được cập nhật. Trong chế độ này, cảm biến sẽ
chỉ chạy nếu bạn đọc các thuộc tính và chúng hiện tại đã lỗi thời.

Với `Enum.SensorUpdateType.Manual`, các thuộc tính xuất ra sẽ không bao giờ
thay đổi. Thay vào đó, bạn có thể viết các script của riêng bạn để thiết lập các thuộc tính
xuất ra theo ý bạn.


SensorBase.UpdateType

Xác định cách mà cảm biến sẽ cập nhật dữ liệu xuất ra của nó.


Một lớp trừu tượng cho các loại thể hiện cảm biến khác nhau.


`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
có thể là một phần của cây `Class.DataModel`.

Không thể trực tiếp tạo các đối tượng root `Instance`, nhưng hàm khởi tạo đặc biệt
`Datatype.Instance.new()` sẽ tạo các đối tượng qua mã, nhận tên lớp làm tham số và trả về đối tượng được tạo ra.

Minh họa việc phát hiện sự thay đổi trong tổ tiên của một instance bằng cách kết nối với sự kiện `Class.Instance.AncestryChanged`.

Parent của ChangingPart được đặt thành các giá trị khác nhau theo thời gian. Parent của part là tổ tiên của part, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt bất cứ khi nào nó thay đổi.

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng hoặc một trong
các tổ tiên của nó bị thay đổi.

Sự kiện này bao gồm hai tham số: `child` đề cập đến `Class.Instance`
đã thực sự thay đổi `Class.Instance.Parent`, trong khi `parent` đề cập đến
`Class.Instance.Parent` mới của instance này.

Bạn có thể sử dụng sự kiện này để theo dõi việc xóa một instance trong Studio,
hay như xóa bằng tay trong Explorer hoặc thông qua plugin. Nếu bạn cần
phát hiện khi một instance được hủy sử dụng `Class.Instance:Destroy()`,
hãy sử dụng sự kiện `Class.Instance.Destroying` thay thế.

Instance.AncestryChanged

child

`Class.Instance` mà `Class.Instance.Parent` của nó đã bị thay đổi.

parent

`Class.Instance.Parent` mới của `Class.Instance` mà
`Class.Instance.Parent` của nó đã bị thay đổi.

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng hoặc một trong
các tổ tiên của nó bị thay đổi.

Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên instance,
bao gồm khi một thuộc tính được đặt thành `nil`. Tên của thuộc tính đã thay đổi
được truyền đến hàm đã kết nối.

Ví dụ, đoạn mã sau kết nối hàm `attributeChanged()`
để kích hoạt bất cứ khi nào một trong các thuộc tính của phần thay đổi:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "đã thay đổi")
end

part.AttributeChanged:Connect(attributeChanged)
```
Xem thêm `Class.Instance:GetAttributeChangedSignal()` mà trả về một
sự kiện kích hoạt khi một thuộc tính nhất định thay đổi.

Instance.AttributeChanged

attribute

Tên của thuộc tính đã bị thay đổi.

Kích hoạt bất cứ khi nào một thuộc tính được thay đổi trên `Class.Instance`.

Đoạn mã này in ra tên của các đối tượng khi chúng được thêm vào Workspace:

Sự kiện xảy ra sau khi một đối tượng được gán làm cha mẹ cho `Class.Instance` này.

Lưu ý, khi sử dụng phương pháp này trên client để phát hiện các đối tượng được tạo ra bởi
server, cần sử dụng `Class.Instance:WaitForChild()` khi
chỉ mục của các đối tượng con của những đối tượng này. Điều này là do đối tượng và các đối tượng
con của nó không được đảm bảo sẽ tái tạo từ server đến client
một cách đồng thời. Ví dụ:

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

Workspace.ChildAdded:Connect(function(child)
	-- Sử dụng WaitForChild() vì các đứa trẻ có thể chưa được tái tạo
	local head = child:WaitForChild("Head")
end)
```
Lưu ý, sự kiện này chỉ hoạt động cho các đối tượng con ngay lập tức của
`Class.Instance`. Để có một sự kiện bắt tất cả các đối tượng con, hãy sử dụng
`Class.Instance.DescendantAdded`.

Xem thêm `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` đã được thêm vào.

Kích hoạt sau khi một đối tượng được phụ thuộc vào `Class.Instance` này.

Đoạn mã này in ra tên của các đối tượng khi chúng bị xóa khỏi
Workspace:

Kích hoạt sau khi một đứa trẻ bị xóa khỏi `Class.Instance` này.

Bị xóa đề cập đến khi một đối tượng có cha được thay đổi từ
`Class.Instance` này sang một cái gì đó khác ngoài `Class.Instance` này. Lưu ý, sự kiện này
cũng sẽ kích hoạt khi một đứa trẻ bị hủy (sử dụng
`Class.Instance:Destroy()`) vì hàm hủy đặt cha của đối tượng
thành `nil`.

Sự kiện này chỉ hoạt động cho những đứa trẻ ngay lập tức của
`Class.Instance`. Để có một sự kiện thu thập tất cả các đoạn con, sử dụng
`Class.Instance.DescendantRemoving`.

Xem thêm `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Kích hoạt sau khi một đứa trẻ bị xóa khỏi `Class.Instance` này.

Ví dụ dưới đây sẽ in ra tên của bất kỳ đối tượng nào được thêm vào
Workspace:

Sự kiện này kích hoạt sau khi một đoạn con được thêm vào `Class.Instance`.

Bởi vì nó kích hoạt cho mỗi đoạn con, việc đặt một đối tượng vào `Class.Instance`
cũng sẽ kích hoạt sự kiện này cho đối tượng này và tất cả các đoạn của nó một cách riêng biệt.

Nếu bạn chỉ quan tâm đến **những đứa trẻ trực tiếp** của
`Class.Instance`, hãy sử dụng `Class.Instance.ChildAdded` thay vào đó.

Xem thêm `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Kích hoạt sau khi một đoạn con được thêm vào `Class.Instance`.

Ví dụ sau in tên của bất kỳ đối tượng con nào khi nó đang được gỡ ra
khỏi Workspace:

Sự kiện này kích hoạt **ngay trước khi** cha `Class.Instance`
bị thay đổi đến mức mà một instance **đoạn con** sẽ không còn là đoạn con nữa.
`Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent` của một instance thành `nil`, vì vậy gọi phương thức đó trên một đoạn con của cha sẽ khiến sự kiện này kích hoạt.

Vì sự kiện này kích hoạt **trước khi** đoạn con bị xóa, cha của
đoạn con sẽ không bị thay đổi tại thời điểm kích hoạt sự kiện này. Nếu đoạn con là một **đứa trẻ trực tiếp** của cha, sự kiện này sẽ kích hoạt
trước `Class.Instance.ChildRemoved`.

Nếu một đoạn con có con cái, sự kiện này sẽ kích hoạt với đoạn con trước,
và sau đó là các đoạn con của nó.

##### Cảnh báo

Sự kiện này kích hoạt với đối tượng đoạn con đang được xóa.
Cố gắng thiết lập `Class.Instance.Parent|Parent` của đoạn con thành
một cái gì đó khác sẽ thất bại. Dưới đây là một ví dụ mà mô tả điều này:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Không gọi manipulate cha của đoạn con trong hàm này!
	-- Sự kiện này kích hoạt BỞI vì cha đã bị thao tác, và sự thay đổi chưa xảy ra
	-- Do đó, thật khó khăn khi thay đổi cha như thế này:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Xem thêm `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Kích hoạt ngay trước khi một đoạn con của `Class.Instance` bị xóa.

Mẫu này minh họa cách mà, khi sử dụng hành vi tín hiệu ngay lập tức, một Instance bị phá hủy sẽ giữ nguyên vị trí cho đến khi chức năng kết nối dừng lại.

Ví dụ này thể hiện cách mà, khi sử dụng hành vi tín hiệu hoãn,
   một Instance sẽ bị hủy trước khi tín hiệu được phát.

`Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi một
hàm kết nối vẫn đang sử dụng nó. Tuy nhiên, nếu hàm này chờ tại bất kỳ điểm nào,
`Class.Instance` và các đoạn con của nó sẽ được đặt thành `nil`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Immediate`, sự kiện này sẽ kích hoạt ngay trước khi `Class.Instance`
hoặc một trong các tổ tiên của nó bị hủy với `Class.Instance:Destroy()`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Deferred`, sự kiện này sẽ kích hoạt tại điểm tiếp theo,
điều này sẽ xảy ra sau khi `Class.Instance` hoặc một trong các tổ tiên của nó bị
hủy với `Class.Instance:Destroy()`.

Với hành vi `Enum.SignalBehavior.Deferred|Deferred`, kết nối một kịch bản
với sự kiện `Class.Instance.Destroying` của chính nó là vấn đề,
vì kịch bản sẽ bị xóa trước khi callback có thể được gọi (nghĩa là nó sẽ không
thực thi).

Khi xóa một `Class.Instance` trong Studio, chẳng hạn như xóa bằng tay
qua [Explorer](/studio/explorer) hoặc thông qua một plugin,
`Class.Instance` không bị xóa. Thay vào đó, cha của nó được đặt thành `nil`
điều mà bạn có thể theo dõi với `Class.Instance.AncestryChanged`.

Instance.Destroying

Kích hoạt ngay trước khi (hoặc bị hoãn đến sau) instance bị
hủy thông qua `Class.Instance:Destroy()`.

Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu nào được thay đổi trên instance,
bao gồm khi một thuộc tính được đặt thành `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("Các thuộc tính kiểu đã thay đổi")
end

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

Instance.StyledPropertiesChanged

Kích hoạt bất cứ khi nào một thuộc tính kiểu được thay đổi trên instance,
bao gồm khi một thuộc tính được đặt thành `nil`.

Instance.childAdded

Phương thức này áp dụng một thẻ cho instance, không có hiệu ứng nếu thẻ đã được áp dụng. Thêm thẻ thành công sẽ kích hoạt một tín hiệu được tạo bởi
`Class.CollectionService:GetInstanceAddedSignal()` với thẻ đã cho.

##### Cảnh báo

- Các thẻ của một instance đã được thêm từ phía client sẽ bị bỏ qua nếu máy chủ sau đó thêm hoặc xóa một thẻ trên instance đó vì máy chủ
  nhân bản tất cả các thẻ cùng nhau và ghi đè lên các thẻ trước đó.

- Khi gán thẻ cho một instance, thông thường sẽ cần một số tài nguyên để
giao thẻ chức năng của nó, ví dụ như kết nối sự kiện hoặc bảng. Để ngăn ngừa rò rỉ bộ nhớ,
  tốt nhất là làm sạch những cái này (ngắt kết nối,
  đặt thành `nil`, v.v.) khi không còn cần thiết cho một thẻ. Làm điều này khi
  gọi `Class.Instance:RemoveTag()`, gọi
  `Class.Instance:Destroy()`, hoặc trong một hàm đã kết nối với một tín hiệu
  đã trả về bởi `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Phương thức này xóa tất cả các đứa trẻ và hậu duệ của một instance.

```
local part = Instance.new("Part")

-- Thêm một số ánh sáng lấp lánh
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
```
Nếu bạn không muốn xóa **tất cả** các đứa trẻ và hậu duệ, hãy sử dụng `Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để
lặp qua các đứa trẻ/hậu duệ đó và chọn những cái cần xóa. Ví dụ, đoạn mã sau sẽ xóa tất cả
`Class.BasePart|BaseParts` xuống từ một `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

Phương thức này xóa tất cả các đứa trẻ của một instance.

Chứng minh việc nhân bản một mô hình bằng cách sử dụng `Class.Instance:Clone()`.

`Clone()` tạo một bản sao của một instance và tất cả các đối tượng con của nó,
bỏ qua tất cả các instance không có
`Class.Instance.Archivable|Archivable`. Bản sao của instance gốc được
trả về bởi phương pháp này và `Class.Instance.Parent|Parent` của nó được đặt là
`nil`. Lưu ý rằng nếu instance đó có
`Class.Instance.Archivable|Archivable` được đặt thành `false`, phương pháp này sẽ
trả về `nil`.

Nếu một thuộc tính tham chiếu như `Class.ObjectValue.Value` được đặt trong một
instance được nhân bản, giá trị của thuộc tính trong bản sao phụ thuộc vào
giá trị của bản gốc:

- Nếu một thuộc tính tham chiếu đề cập đến một instance cũng được **nhân bản**,
  bản sao sẽ tham chiếu đến bản sao đó.
- Nếu một thuộc tính tham chiếu đề cập đến một instance **không** được nhân bản,
  cùng giá trị sẽ được giữ lại trong bản sao.


Instance:Clone

Tạo một bản sao của một instance và tất cả các hậu duệ của nó, bỏ qua những instance
không phải là `Class.Instance.Archivable|Archivable`.

Minh họa việc phá hủy một Phần sử dụng hàm `Class.Instance:Destroy()`.

Hàm này là cách chính xác để giải phóng các đối tượng không còn cần thiết.

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` cho tất cả các đối tượng con. Phương pháp này là cách chính xác để giải phóng
các đối tượng không còn cần thiết nữa.

Việc giải phóng các đối tượng không cần thiết rất quan trọng, vì các đối tượng và
kết nối không cần thiết trong một nơi sử dụng bộ nhớ, có thể dẫn đến các sự cố hiệu
suất nghiêm trọng theo thời gian.

Như một phương pháp tốt, sau khi gọi `Destroy()` trên một đối tượng, hãy đặt bất kỳ
biến nào tham chiếu đến đối tượng (hoặc các đối tượng con của nó) thành `nil`. Điều này
ngăn mã của bạn truy cập vào bất kỳ điều gì liên quan đến đối tượng đó.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Đừng làm điều này:
print(part.Name)  --> "Hello, world"
-- Thực hiện điều này để ngăn dòng trên hoạt động:
part = nil
```
Khi một `Class.Instance` đã được phá hủy bởi phương pháp này, nó không thể
được sử dụng lại vì thuộc tính `Class.Instance.Parent` bị khóa. Để
**tạm thời** xóa một đối tượng thay vì phá hủy nó, đặt
`Class.Instance.Parent|Parent` thành `nil`. Ví dụ:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Để phá hủy một đối tượng sau một khoảng thời gian xác định, sử dụng
`Class.Debris:AddItem()`.


Instance:Destroy

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối và gọi
`Destroy()` trên tất cả các đứa trẻ.

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Instance.Name`
được bằng tên đã cho.

Phương thức này hoạt động theo hướng lên trên, có nghĩa là bắt đầu từ `Class.Instance.Parent`
ngay lập tức và đi lên hướng `Class.DataModel`. Nếu không tìm thấy tổ tiên nào phù hợp, phương thức này trả về `nil`.

Đoạn mã sau đây sẽ tìm tổ tiên đầu tiên của đối tượng
có tên là `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Đối với các biến thể của phương thức này tìm tổ tiên của một lớp cụ thể,
xin xem `Class.Instance:FindFirstAncestorOfClass()` và
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Tên `Class.Instance.Name` được tìm kiếm.

Đối tượng `Class.Instance` được tìm thấy.

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Instance.Name`
được bằng tên đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Object.ClassName`
được bằng tên `className` đã cho.

Phương thức này hoạt động theo hướng lên trên, có nghĩa là bắt đầu tại `Class.Instance.Parent`
ngay lập tức và đi lên hướng `Class.DataModel`. Nếu không tìm thấy tổ tiên nào phù hợp, phương thức này trả về `nil`.

Một cách sử dụng phổ biến của phương thức này là tìm kiếm `Class.Model` mà
`Class.BasePart` thuộc về. Ví dụ:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Phương thức này là một biến thể của `Class.Instance:FindFirstAncestor()` mà
kiểm tra thuộc tính `Class.Object.ClassName` thay vì
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` cũng
được cung cấp, sử dụng phương thức `Class.Object:IsA()` thay thế để tôn trọng kế thừa lớp.

Instance:FindFirstAncestorOfClass

className

Tên `Class.Object.ClassName` được tìm kiếm.

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Object.ClassName`
được bằng tên `className` đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Object:IsA()`
trả về true cho lớp `className` đã cho.

Phương thức này hoạt động theo hướng lên trên, có nghĩa là bắt đầu từ `Class.Instance.Parent`
ngay lập tức và đi lên hướng `Class.DataModel`. Nếu không tìm thấy tổ tiên nào phù hợp, phương thức này trả về `nil`.

Khác với `Class.Instance:FindFirstAncestorOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` tôn trọng kế thừa lớp. Ví dụ:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Do đó, đoạn mã sau đây sẽ trả về tổ tiên đầu tiên là `Class.BasePart`, bất kể một tổ tiên 
có phải là `Class.WedgePart`, `Class.MeshPart` hay `Class.Part` hay không.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Xem thêm `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Trả về tổ tiên đầu tiên của `Class.Instance` mà `Class.Object:IsA()`
trả về true cho lớp `className` đã cho.

Phía dưới sẽ tìm kiếm trong Workspace cho một đối tượng có tên là "Brick". Nếu tìm thấy, nó
sẽ thay đổi tên của đối tượng thành "Foo".

Trả về đứa trẻ đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không có đứa trẻ nào như vậy tồn tại. Nếu tham số tùy chọn `recursive` là
`true`, phương thức này tìm kiếm trong tất cả các hậu duệ thay vì chỉ các đứa trẻ tức thì của `Class.Instance`.

##### Kiểm tra Sự tồn tại của một Đối tượng

`FindFirstChild()` là cần thiết nếu bạn cần xác minh một đối tượng tồn tại
trước khi tiếp tục. Cố gắng chỉ mục một đứa trẻ theo tên bằng toán tử chấm sẽ ném ra lỗi nếu đứa trẻ không tồn tại.

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

-- Dòng sau sẽ lỗi nếu phần không tồn tại trong không gian làm việc
Workspace.Part.Transparency = 0.5
```
Một cách tiếp cận tốt hơn là sử dụng `FindFirstChild()` để trước tiên kiểm tra `Part`,
 sau đó sử dụng một câu lệnh `if` để chạy mã cần thiết.

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

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

##### Tìm một Đứa trẻ có tên Khớp với một Thuộc tính

Đôi khi tên `Class.Instance.Name|Name` của một đối tượng là giống như một thuộc tính của `Class.Instance.Parent|Parent`.
Khi sử dụng toán tử chấm, các thuộc tính ưu tiên hơn các đứa trẻ nếu chúng chia sẻ một tên.

Trong ví dụ sau, một `Class.Folder` có tên `Color` được thêm vào một
`Class.Part`, mà cũng có thuộc tính `Class.Part.Color`. Lưu ý rằng
`part.Color` đề cập đến giá trị thuộc tính `Datatype.Color3`, không phải là bản thể đứa trẻ `Class.Folder`. Một lợi ích của việc sử dụng
`Class.Instance:FindFirstChild()|FindFirstChild()` là việc giới thiệu các thuộc tính mới không gây rủi ro cho mã của bạn.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- thuộc tính
local c2 = part:FindFirstChild("Color")  -- thư mục trẻ
```

##### Ghi chú về Hiệu suất

`Class.Instance:FindFirstChild()|FindFirstChild()` mất khoảng 20% thời gian hơn
so với việc sử dụng toán tử chấm và gần 8 lần hơn so với việc chỉ cần lưu trữ
một tham chiếu đến một đối tượng. Do đó, bạn nên tránh gọi nó trong mã phụ thuộc vào hiệu suất như trong các vòng lặp chặt chẽ hoặc các hàm kết nối đến
`Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
 lưu kết quả trong một biến, hoặc xem xét sử dụng
`Class.Instance.ChildAdded|ChildAdded` hoặc
`Class.Instance:WaitForChild()|WaitForChild()` để phát hiện khi một đứa trẻ có tên nhất định trở nên sẵn có.

Instance:FindFirstChild

Tên `Class.Instance.Name` để tìm kiếm.

recursive

Cho biết liệu tìm kiếm có nên được thực hiện đệ quy hay không.

Trả về đứa trẻ đầu tiên của `Class.Instance` được tìm thấy với tên đã cho.

Trả về con đầu tiên của `Class.Instance` có
`Class.Object.ClassName|ClassName` bằng với `className` đã cho.
Khác với `Class.Instance:FindFirstChildWhichIsA()`, phương pháp này chỉ trả về
các đối tượng có lớp khớp với `className`, bỏ qua tính kế thừa lớp. Nếu không
tìm thấy con phù hợp, phương pháp này sẽ trả về `nil`.


Instance:FindFirstChildOfClass

Tên `Class.Object.ClassName` cần tìm.

Trả về đứa trẻ đầu tiên của `Class.Instance` mà có
`Class.Object.ClassName|ClassName` bằng tên lớp đã cho.

Trả về con đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho `className` đã cho.

Nếu không tìm thấy con phù hợp, phương pháp này sẽ trả về `nil`. Nếu tham số
tùy chọn recursive là true, phương pháp này tìm kiếm tất cả các đối tượng con thay vì
chỉ là các con ngay lập tức của `Class.Instance`.

Khác với `Class.Instance:FindFirstChildOfClass()`, phương pháp này sử dụng
`Class.Object:IsA()` tôn trọng tính kế thừa lớp. Ví dụ:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Do đó, đoạn mã sau sẽ trả về con đầu tiên
`Class.BasePart`, bất kể nó là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Các nhà phát triển đang tìm kiếm một con theo tên nên sử dụng
`Class.Instance:FindFirstChild()` thay vì.


Instance:FindFirstChildWhichIsA

Trả về đứa trẻ đầu tiên của `Class.Instance` mà `Class.Object:IsA()`
trả về true cho lớp `className` đã cho.

Trả về hậu duệ đầu tiên tìm thấy với tên `Class.Instance.Name` đã cho.

Phương thức này đã bị vô hiệu hóa và không thể sử dụng. Để tìm hậu duệ đầu tiên
của một instance, xem xét sử dụng tham số `recursive` trên
`Class.Instance:FindFirstChild()` thay thế.

Instance:FindFirstDescendant

Trả về hậu duệ đầu tiên tìm thấy với tên `Class.Instance.Name` đã cho.

Nếu `Class.Instance` là một `Class.Actor`, thì chính `Class.Actor` sẽ
được trả về. Nếu không, tổ tiên gần nhất `Class.Actor` của nó sẽ được trả về. Nếu không
có tổ tiên nào là `Class.Actor`, kết quả sẽ là `nil`.

Instance:GetActor

Đối tượng `Class.Actor` được tìm thấy.

Trả về `Class.Actor` liên kết với Instance, nếu có.

Phương thức này trả về giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có thuộc tính nào được gán, `nil` sẽ được trả về.

Ví dụ, đoạn mã sau thiết lập và sau đó lấy giá trị của
thuộc tính `InitialPosition` của instance:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

##### Xem Thêm

- `Class.Instance:SetAttribute()` khiến thuộc tính với tên đã cho được đặt
  thành giá trị đã cho.
- `Class.Instance:GetAttributes()` trả về một từ điển của các cặp khóa-giá trị
  cho mỗi thuộc tính của instance.

Instance:GetAttribute

Tên của thuộc tính đang được truy xuất.

Giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có
thuộc tính nào được gán, `nil` sẽ được trả về.

Trả về giá trị đã được gán cho tên thuộc tính đã cho.

Phương thức này trả về một sự kiện mà hoạt động giống hệt như
`Class.Object.Changed|Changed`, ngoại trừ chỉ kích hoạt khi thuộc tính đã cho thay đổi; thực chất nó tương tự như
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng
cho các thuộc tính.

Nói chung, tốt hơn là sử dụng phương thức này thay vì kết nối với
`Class.Object.Changed|Changed` với một hàm kiểm tra tên thuộc tính.
Các lần gọi tiếp theo đến phương thức này trên cùng một đối tượng với cùng một
 tên thuộc tính sẽ trả về cùng một sự kiện.

Đoạn mã sau đây trả về một tín hiệu sẽ kích hoạt hàm
`attributeChanged()` khi thuộc tính `InitialPosition` của phần thay đổi:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Thuộc tính đã thay đổi")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Xem thêm `Class.Instance.AttributeChanged` được kích hoạt bất cứ khi nào bất kỳ
thuộc tính nào bị thay đổi trên instance.

Instance:GetAttributeChangedSignal

Tên thuộc tính cụ thể cho mà tín hiệu thay đổi đang được trả về.

Một sự kiện được kích hoạt khi thuộc tính đã cho thay đổi.

Trả về một sự kiện mà sẽ được kích hoạt khi thuộc tính đã cho thay đổi.

Phương thức này trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính
nơi khóa là tên thuộc tính và giá trị là giá trị không phải `nil`.

Ví dụ, đoạn mã sau đây xuất ra các thuộc tính
và giá trị của một instance:

```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
```
Xem thêm `Class.Instance:GetAttribute()` trả về giá trị đã được gán cho
tên thuộc tính đã cho.

Instance:GetAttributes

Một từ điển các cặp (chuỗi → biến) cho mỗi thuộc tính nơi chuỗi là tên thuộc tính và biến là một giá trị khác `nil`.

Trả về một từ điển các thuộc tính của instance.

Dưới đây sẽ in tên của tất cả các đối tượng hiện tại trong Workspace khi chạy.

Trả về một mảng (một bảng có chỉ số số) chứa tất cả các
đối tượng con trực tiếp của instance, hoặc mọi `Class.Instance` mà
`Class.Instance.Parent|Parent` bằng object. Mảng có thể được
lặp lại bằng cách sử dụng vòng lặp số hoặc vòng lặp tổng quát:

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

-- Ví dụ vòng lặp số
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " là con số " .. i)
end
```

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

-- Ví dụ vòng lặp tổng quát
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " là con số " .. i)
end
```
Lưu ý rằng mảng trả về **không** được sắp xếp theo bất kỳ thứ tự nào, vì vậy
sắp xếp thủ công (ví dụ bằng cách sử dụng `Library.table.sort()`) được khuyến
nghị để sắp xếp các đứa trẻ được trả về bởi phương pháp này.

Xem thêm phương pháp `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Một mảng chứa các đứa trẻ của instance.

Trả về một mảng chứa tất cả các đứa trẻ của instance.

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox. Lưu ý rằng:

- Mục này được bảo vệ. Cố gắng sử dụng nó trong một `Class.Script` hoặc
  `Class.LocalScript` sẽ gây ra lỗi.
- Một ID gỡ lỗi là một ID được sử dụng trong các quy trình gỡ lỗi. Nó cho phép một trình gỡ lỗi đọc từng hướng dẫn trước khi ứng dụng xử lý nó. Tất cả các đối tượng trong
  Roblox hoạt động như các quy trình và mỗi lần chạy hướng dẫn (hoặc 'mã') có thể
  được gỡ lỗi nếu cần.
- Điều này có thể hữu ích cho các plugin cần phân biệt các đối tượng tương tự
  với nhau (như các đối tượng có cùng tên).

Instance:GetDebugId

scopeLength

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox.

GetDescendants thường được sử dụng để thực hiện một thao tác trên tất cả các hậu duệ là một
loại đối tượng cụ thể. Đoạn mã trong ví dụ này sử dụng GetDescendants và
`Class.Instance:IsA()` để tìm tất cả các phần trong workspace và đổi
them thành màu xanh lá cây.

Phương pháp đối tượng này trả về một mảng chứa tất cả các
đối tượng con của đối tượng đó. Khác với `Class.Instance:GetChildren()`, chỉ trả về
các đối tượng con ngay lập tức của một đối tượng, phương pháp này tìm mọi con của đối tượng,
và mọi con của những đứa trẻ đó, và cứ như vậy.

Lưu ý rằng mảng trả về **không** được sắp xếp theo bất kỳ thứ tự nào, vì vậy
sắp xếp thủ công (ví dụ bằng cách sử dụng `Library.table.sort()`) được khuyến
nghị để sắp xếp các đối tượng con được trả về bởi phương pháp này. Cũng nên xem xét
phương pháp `Class.Instance:QueryDescendants()|QueryDescendants()` để truy vấn
các đối tượng con bằng một tổ hợp các bộ chọn và tổ hợp.


Instance:GetDescendants

Một mảng chứa các hậu duệ của instance.

Trả về một mảng chứa tất cả các hậu duệ của instance.

Mẫu mã này trình bày hành vi của `Class.Instance:GetFullName()`. 
Nó cho thấy chức năng hoạt động như thế nào khi được gọi trên một đối tượng không nằm trong 
hệ thống phân cấp `DataModel`, và nó cũng cho thấy giá trị trả về không thoát được 
những ký tự đặc biệt.

Ví dụ mã này tái cài đặt hàm `Class.Instance:GetFullName()` trong
Lua.

Trả về một chuỗi mô tả về nguồn gốc của instance. Chuỗi này là một
chuỗi nối của `Class.Instance.Name|Name` của đối tượng và các
tổ tiên của nó, được phân cách bởi dấu chấm. `Class.DataModel` (`game`) không
được tính đến. Ví dụ, một `Class.Part` trong `Class.Workspace` có thể
trả về `Class.Workspace.Part`.

Khi được gọi trên một `Class.Instance` không phải là một tổ tiên của
`Class.DataModel`, phương pháp này tính đến tất cả các tổ tiên cho đến và bao gồm
tổ tiên cao nhất mà không có `Class.Instance.Parent|Parent`.

Phương pháp này rất hữu ích cho việc ghi nhật ký và gỡ lỗi. Bạn không nên cố gắng
phân tích chuỗi trả về cho bất kỳ hoạt động hữu ích nào; phương pháp này không
thoát dấu chấm (hoặc bất kỳ ký hiệu nào khác) trong tên đối tượng. Nói cách khác,
cho dù đầu ra của nó thường xuất hiện như một định danh Luau hợp lệ, nhưng nó không
được đảm bảo.


Instance:GetFullName

Tên đầy đủ của `Class.Instance`.

Trả về một chuỗi mô tả tổ tiên của instance.

Phương thức này trả về giá trị đã được kiểu chữ hoặc sửa đổi một cách rõ ràng của thuộc tính
được chỉ định, hay giá trị thuộc tính mặc định nếu nó chưa được kiểu chữ/sửa đổi. Điều này khác
một chút so với việc truy cập giá trị thuộc tính trực tiếp, chẳng hạn như `[GuiObject].Rotation`, trả về giá trị mặc định hoặc
đã sửa đổi của thuộc tính.

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

-- Tham chiếu đến một nút
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (giá trị mặc định)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Áp dụng độ quay thông qua thuộc tính quy tắc kiểu
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (giá trị kiểu theo quy tắc)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Sửa đổi/ghi đè thuộc tính kiểu một cách rõ ràng
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (giá trị đã sửa đổi)
print(button.Rotation) --> 45 (giá trị đã sửa đổi)
```

Instance:GetStyled

Giá trị đã được kiểu chữ hoặc sửa đổi một cách rõ ràng của thuộc tính được chỉ định, hoặc
giá trị thuộc tính mặc định nếu nó chưa được kiểu chữ/sửa đổi.

Trả về giá trị đã được kiểu chữ hoặc sửa đổi một cách rõ ràng của thuộc tính được chỉ định,
hay giá trị thuộc tính mặc định nếu nó chưa được kiểu chữ/sửa đổi.

Phương thức này trả về một sự kiện mà hoạt động giống hệt như
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` event,
ngoại trừ chỉ kích hoạt khi thuộc tính kiểu cho kiểu đã cho thay đổi. Nói chung, tốt hơn
để sử dụng phương thức này thay vì một kết nối với
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` với một hàm kiểm tra tên thuộc tính. Các lần gọi tiếp theo đến phương thức này trên cùng một đối tượng với cùng một thuộc tính sẽ trả về cùng một sự kiện.

Lưu ý rằng sự kiện này sẽ không truyền bất kỳ tham số nào cho hàm đã kết nối,
vì vậy giá trị của thuộc tính đã thay đổi phải được đọc trực tiếp bên trong một
tập lệnh.

```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("Thuộc tính kiểu đã thay đổi!")
end

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

Instance:GetStyledPropertyChangedSignal

property

Tên thuộc tính kiểu mà bạn muốn lắng nghe sự thay đổi.

Sự kiện được kích hoạt khi thuộc tính kiểu đã cho thay đổi.

Phương thức này trả về một mảng các thẻ đã được áp dụng cho instance đã cho, dưới dạng
chuỗi. Bạn có thể thêm thẻ trong Studio tại
[Properties](/studio/properties) cửa sổ hoặc tại chạy với
`Class.Instance:AddTag()|AddTag()`.

Phương thức này hữu ích khi bạn muốn thực hiện một điều gì đó với nhiều thẻ trên
một instance một lần. Tuy nhiên, không hiệu quả khi sử dụng phương thức này để
kiểm tra sự tồn tại của một thẻ đơn; thay vào đó, hãy sử dụng
`Class.Instance:HasTag()|HasTag()` để kiểm tra một thẻ cụ thể.

Instance:GetTags

Lấy một mảng chứa tất cả các thẻ đã được áp dụng cho instance.

Phương thức này trả về `true` nếu thẻ được cung cấp đã được thêm vào đối tượng. Bạn có thể thêm thẻ tại Studio trong
[Properties](/studio/properties) cửa sổ hoặc tại chạy với
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Kiểm tra xem instance có một thẻ cho trước hay không.

Chứng minh việc xác định xem một thể hiện có phải là tổ tiên của một thể hiện khác hay không bằng cách sử dụng `Class.Instance:IsAncestorOf()`

Workspace và SpawnLocation là tổ tiên của decal của SpawnLocation.
Workspace là tổ tiên của SpawnLocation.

SpawnLocation và decal của nó là con cháu của Workspace, không phải tổ tiên.
Decal là một con cháu của SpawnLocation, không phải tổ tiên.

Trả về true nếu một `Class.Instance` là tổ tiên của hậu duệ đã cho.

Một `Class.Instance` được coi là tổ tiên của một đối tượng nếu
`Class.Instance.Parent` của đối tượng hoặc một trong các tổ tiên của nó có `Class.Instance.Parent`
được đặt thành `Class.Instance`.

Xem thêm, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Đúng nếu `Class.Instance` là tổ tiên của hậu duệ đã cho.

Trả về true nếu một `Class.Instance` là tổ tiên của hậu duệ đã cho.

Trả về `true` nếu một `Class.Instance` là hậu duệ của tổ tiên đã cho.

Lưu ý rằng `IsDescendantOf()` không thể được sử dụng với một tham số `nil` để
trove vạch ra xem một đối tượng đã bị xóa hay không.

Xem thêm `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Đúng nếu `Class.Instance` là hậu duệ của tổ tiên đã cho.

Trả về `true` nếu một `Class.Instance` là hậu duệ của tổ tiên đã cho.

Phương pháp này chỉ ra liệu một thuộc tính cụ thể đã được sửa đổi từ
mặc định do mã khởi tạo hay không. Nếu được gọi trên một instance vừa mới được tạo
thông qua mã (`Datatype.Instance.new()`), phương pháp này sẽ trả về `false`. Nếu
được gọi trên một đối tượng mới được tạo bởi quy trình làm việc trong Studio như
[Explorer](/studio/explorer) chèn cửa sổ, kết quả có thể khác.

Ví dụ, khi truy vấn thuộc tính
`Class.TextLabel.BackgroundColor3|BackgroundColor3` của một
`Class.TextLabel` được chèn qua [Explorer](/studio/explorer)
sẽ trả về `true`, nhưng khi truy vấn cùng một thuộc tính của một
`Class.TextLabel` được tạo thông qua `Datatype.Instance.new()` sẽ trả về
`false`, giả sử không có thay đổi nào khác được thực hiện đối với
`Class.TextLabel.BackgroundColor3|BackgroundColor3` của nó.

Lưu ý rằng nếu phương pháp này trả về `true`, kiểu dáng sẽ **không** ảnh hưởng
đến thuộc tính vì việc sửa đổi một thuộc tính cụ thể sẽ ưu tiên hơn việc
thay đổi kiểu dáng cho nó. Để đặt lại một thuộc tính về mặc định do
mã khởi tạo và cho phép kiểu dáng trên đó, hãy sử dụng
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Boolean chỉ ra liệu thuộc tính đã được sửa đổi so với
mặc định do mã khởi tạo hay không.


Trả về `true` nếu giá trị lưu trữ trong thuộc tính được chỉ định không bằng
mặc định do mã khởi tạo.


Phương pháp đối tượng này trả về một mảng chứa các thuộc tính của đối tượng đó
giống như chuỗi `selector` đã cung cấp. Chuỗi `selector` có thể
bao gồm nhiều bộ chọn và tổ hợp để khớp với các đặc điểm như tên lớp,
tên instance, mối quan hệ phân cấp, cũng như các giá trị cụ thể của thuộc tính và
thuộc tính của instance. Ngữ pháp `selector` tương tự như cái đang sử dụng trong
`Class.StyleRule` với chỉ một vài khác biệt về các phần nào của ngữ pháp được hỗ trợ hoặc không.

##### Bộ chọn

<table>
<thead>
  <tr>
    <th>Bộ chọn</th>
    <th>Mô tả</th>
    <th>Ví dụ</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>ClassName</code></td>
    <td>Khớp với các instance của lớp được chỉ định trong một
<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>Khớp với các instance đã được gán thẻ bằng <code>Class.CollectionService</code>.</td>
    <td><code>.Fruit</code><br /><code>.IntenseLight</code></td>
  </tr>
  <tr>
    <td><code>#Name</code></td>
    <td>Khớp với các instance của một <code>Class.Instance.Name</code> cụ thể.</td>
    <td><code>#RedTree</code><br /><code>#CloseButton</code></td>
  </tr>
  <tr>
    <td><code>[property = value]</code></td>
    <td>Khớp với các instance có thuộc tính được chỉ định và thuộc tính đó có giá trị được chỉ định. Giá trị boolean, số, và chuỗi đều được hỗ trợ. Chữ cái, số, <code>_</code>, và <code>-</code> có thể được sử dụng mà không cần đặt giá trị trong dấu ngoặc kép.
    </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>Khớp với các instance có thuộc tính được chỉ định và thuộc tính đó có giá trị được chỉ định. Những hạn chế tương tự áp dụng như đối với các bộ chọn thuộc tính.</td>
    <td width="30%"><code>[$MyAttribute = 10]</code></td>
  </tr>
</tbody>
</table>

Lưu ý rằng các bộ chọn có thể được kết hợp. Ví dụ,
`Model.Apple[$Kind = "Red"][$State = 4]` sẽ khớp với các instance là một
`Class.Model` với thẻ `Apple` được thiết lập và có một thuộc tính `Kind`
bằng với chuỗi `"Red"` cũng như một thuộc tính `State` bằng `4`.

##### Tổ hợp

<table>
<thead>
  <tr>
    <th>Tổ hợp</th>
    <th>Mô tả</th>
    <th>Ví dụ</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>&gt;</code></td>
    <td>Khớp với các instance là <b>các con trực tiếp</b> của những bộ lọc trước đó.</td>
    <td><code>Part &gt; .SwordHandle</code></td>
  </tr>
  <tr>
    <td><code>&gt;&gt;</code></td>
    <td>Khớp với các instance là <b>các đứa con</b> của các bộ lọc trước đó.</td>
    <td><code>Model &gt;&gt; .TreeOnFire</code></td>
  </tr>
  <tr>
    <td width="10%"><code>,</code></td>
    <td>Xác định một danh sách các bộ chọn độc lập cho truy vấn đứa con.</td>
    <td width="50%"><code>Part.TagA, Part[$UseForce = true]</code></td>
  </tr>
</tbody>
</table>

Lưu ý rằng bộ lọc đầu tiên mặc định là tổ hợp con `>>`. Nếu bộ chọn bắt đầu bằng một `>`, chỉ có các con được truy cập; ví dụ
`>Part.Apple` chọn **các con trực tiếp** là một `Class.Part` và có
một thẻ `Apple`.

Bộ tổ hợp mặc định cũng có thể được chỉ định rõ ràng, như trong
`>>SpotLight.Red` giống như `SpotLight.Red`.

Chỉ những phần tử khớp với bộ lọc mới được đưa vào mảng. Ví dụ,
`>#ExistingChild, >#MissingChild, >#AnotherExistingChild` sẽ trả về một
mảng với hai phần tử và sẽ không có `nil` cho đứa trẻ bị thiếu.


Instance:QueryDescendants

selector

Chuỗi bộ chọn được sử dụng để lọc các phần tử.

Một mảng các instance (rỗng nếu không có gì khớp với bộ chọn).

Đoạn mã sau đây minh họa cách một phần có thể được thêm lại vào DataModel
sau khi bị xóa:

Phương thức này đặt `Class.Instance.Parent` của đối tượng thành `nil`, và làm 
tương tự cho tất cả các hậu duệ của nó.

Nếu đối tượng được tham chiếu trước khi bị xóa, có thể lấy lại nó
vào một thời điểm sau.

Instance:Remove

Đặt `Parent` của đối tượng thành `nil`, và làm điều tương tự cho tất cả các
hậu duệ của nó.

Phương thức này xóa một thẻ khỏi một instance. Nó sẽ không ném ra lỗi nếu
đối tượng không có thẻ. Việc xóa một thẻ thành công sẽ kích hoạt một tín hiệu được tạo bởi
`Class.CollectionService:GetInstanceRemovedSignal()` với thẻ đã cho.

Lưu ý rằng khi gán thẻ cho một instance, thông thường sẽ cần một số tài nguyên để
giao thẻ chức năng của nó, ví dụ như kết nối sự kiện hoặc bảng. Để ngăn ngừa rò rỉ bộ nhớ, nên làm sạch những cái này
(ngắt kết nối, đặt thành `nil`, v.v.) khi không còn cần thiết cho một thẻ.

Instance:RemoveTag

Đặt thuộc tính về giá trị mặc định của nó. Ví dụ, gọi
`ResetPropertyToDefault("Rotation")` trên một `Class.TextLabel` tương đương với việc đặt
thuộc tính `Class.TextLabel.Rotation|Rotation` của nó thành `0` (giá trị mặc định của thuộc tính). Phương thức này có thể được sử dụng để đảm bảo rằng kiểu chữ sẽ ghi đè
giá trị mặc định của thuộc tính này.

Instance:ResetPropertyToDefault

Đặt thuộc tính về giá trị mặc định của nó.

Phương thức này đặt thuộc tính với tên đã cho thành giá trị đã cho. Nếu
giá trị đã cho là `nil`, thuộc tính sẽ được xóa, vì `nil` là
gia trị mặc định.

Ví dụ, đoạn mã sau thiết lập thuộc tính `InitialPosition` của instance thành `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))
```

##### Giới Hạn

Yêu cầu và hạn chế về tên:

- Tên chỉ được sử dụng các ký tự chữ và số.
  - Bạn cũng có thể bao gồm dấu chấm, dấu gạch ngang, dấu chéo, và gạch dưới.
- Không cho phép khoảng trắng hoặc các ký hiệu độc nhất (như @, ~, !) .
- Chuỗi phải có 100 ký tự hoặc ít hơn.
- Tên không được bắt đầu bằng **RBX** trừ khi caller là một
  script lõi của Roblox (dành riêng cho Roblox).

Khi cố gắng đặt một thuộc tính cho một loại không được hỗ trợ, một lỗi sẽ
được ném ra.

##### Xem Thêm

- `Class.Instance:GetAttribute()` trả về giá trị mà đã được gán cho tên
  thuộc tính đã cho.
- `Class.Instance:GetAttributes()` trả về một từ điển của các cặp khóa-giá trị
  cho mỗi thuộc tính của instance.

Instance:SetAttribute

Tên của thuộc tính đang được thiết lập.

value

Giá trị để đặt thuộc tính cụ thể.

Đặt thuộc tính với tên đã cho thành giá trị đã cho.

Mã sau sẽ chờ một thể hiện có tên "Part" được thêm vào
Workspace.

Trả về con cái của `Class.Instance` với tên đã cho. Nếu
con cái không tồn tại, nó sẽ chờ luồng hiện tại cho đến khi có.
Nếu tham số `timeOut` được chỉ định, phương thức này sẽ hết thời gian sau
số giây được chỉ định và trả về `nil`.

##### Cách Sử Dụng Chính

`Class.Instance:WaitForChild()|WaitForChild()` cực kỳ quan trọng khi
làm việc với mã chạy bởi client trong `Class.LocalScript`. Roblox
không đảm bảo thời gian hoặc thứ tự mà các đối tượng được
nhân bản từ server đến client. Thêm vào đó, nếu một trải nghiệm
có `Class.Workspace.StreamingEnabled` được đặt là true,
`Class.BasePart|BaseParts` ở quá xa nhân vật của người chơi
có thể không được phát trực tiếp đến client, có thể gây ra lỗi cho các kịch bản khi chỉ mục các đối tượng chưa tồn tại trên client.

##### Ghi Chú

- Phương thức này không chờ nếu một con cái với tên đã cho tồn tại khi
  gọi.
- `Class.Instance:FindFirstChild()` là một sự thay thế hiệu quả hơn cho
  `Class.Instance:WaitForChild()|WaitForChild()` cho các đối tượng được
  giả định là tồn tại.
- Nếu một cuộc gọi đến phương thức này vượt quá 5 giây mà không trả về,
  và không có tham số `timeOut` nào được chỉ định, một cảnh báo sẽ được in ra cho
  đầu ra rằng luồng có thể chờ vô thời hạn.

Instance:WaitForChild

Trả về đứa trẻ của `Class.Instance` có tên đã cho. Nếu đứa trẻ
không tồn tại, nó sẽ chờ cho luồng hiện tại cho đến khi nó tồn tại.

Instance

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
có thể là một phần của cây `Class.DataModel`.

/reference/engine/classes/FluidForceSensor.yaml

FluidForceSensor

Tóm Tắt

Thuộc Tính

Thuộc Tính

Phương Pháp

Sự Kiện

Sự Kiện

Thuộc Tính

Phương Pháp

Sự Kiện

Trên trang này