Callback này được gọi một lần cho mỗi người chơi, ngay khi mức độ tin cậy của thiết bị của họ có sẵn. Sử dụng nó để quyết định xem người chơi có thể ở lại trong máy chủ hay không, dựa trên `Class.Player.DeviceTrustLevel` và bảng `measures`.

Hãy nhớ những điều sau khi bạn gán callback này:

- Bạn chỉ có thể gán nó từ một `Class.Script` ở phía máy chủ. Gán từ phía khách sẽ gây ra lỗi.
- Mỗi nơi chỉ có một callback. Nếu bạn gán nó nhiều hơn một lần, gán cuối cùng sẽ thay thế các gán trước đó.
- Nó chạy sau khi `Class.Players.PlayerAdded` được kích hoạt, vì việc kiểm tra thiết bị mất thời gian. Khi nó chạy, `Class.Player.DeviceTrustLevel` không bao giờ là `Enum.PlayerDeviceTrustLevel.Pending|Pending`.
- Nó có thể yield. Người chơi tiếp tục chơi trong khi nó chạy, vì vậy một người chơi bị từ chối có thể bị ngắt kết nối sau khi họ đã bắt đầu chơi.
- Nếu người chơi rời đi, hoặc các script của bạn loại bỏ họ, trước khi mức độ tin cậy của họ có sẵn, nó sẽ không được gọi cho người chơi đó.
- Roblox không kiểm tra thiết bị trong Studio, vì vậy nó không được gọi trong các bài kiểm tra chơi.

Roblox lọc một `Message` tùy chỉnh và rút ngắn các tin nhắn quá dài.
Nếu việc lọc sẽ thay đổi tin nhắn, Roblox sẽ hiển thị tin nhắn mặc định thay thế.

Roblox không đá người chơi trong mỗi trường hợp sau:

- Không có script nào gán callback.
- Callback trả về `nil`, một giá trị không phải là bảng, hoặc một bảng
  không có `Action` hợp lệ.
- Callback gây ra lỗi. Roblox báo cáo lỗi như bất kỳ lỗi script nào khác.
- Callback không trả về kịp thời.

Để xem các mẫu mã, hãy xem
[mức độ tin cậy của thiết bị](/scripting/security/device-trust).


IntegrityService.EvaluatePlayerDeviceTrust

player

Người `Class.Player` đang được đánh giá. Mức độ tin cậy của họ đã được thiết lập
trong `Class.Player.DeviceTrustLevel` khi callback này chạy.

measures

Một bảng các cặp khóa-giá trị giải thích mức độ tin cậy của thiết bị của người chơi. Một giá trị `true` có nghĩa là thiết bị đã vượt qua đo lường đó:

- `IsPlatformVersionSecure` &mdash; Hệ điều hành đang ở hoặc
  trên phiên bản tối thiểu mà Roblox coi là an toàn.
- `IsPlatformBootSecure` &mdash; Hệ điều hành đã khởi động trong một
  trạng thái an toàn.
- `IsAppSecure` &mdash; Ứng dụng Roblox chưa bị can thiệp.

Một đo lường không có sẵn trên thiết bị sẽ đọc là `true`, vì vậy hãy luôn
kiểm tra `Class.Player.DeviceTrustLevel` cũng như vậy.

Một bảng cho Roblox biết phải làm gì với người chơi, hoặc `nil` để giữ họ lại:

- `Action` &mdash; Bắt buộc. `Enum.PlayerDeviceTrustDecision.Reject`
  ngắt kết nối người chơi. `Enum.PlayerDeviceTrustDecision.Accept`
  giữ họ lại.
- `Message` &mdash; Tùy chọn. Tin nhắn mà một người chơi bị từ chối thấy.
  Nếu bạn bỏ qua nó, Roblox sẽ hiển thị một tin nhắn mặc định giải thích cách mà người chơi có thể sửa thiết bị của họ.

Quyết định xem một người chơi có thể ở lại trong máy chủ khi mức độ tin cậy của thiết bị của họ có sẵn hay không.

`IntegrityService` cung cấp API để đo lường
[mức độ tin cậy của thiết bị](/scripting/security/device-trust) của mỗi
người chơi tham gia trò chơi của bạn. Roblox không thực hiện bất kỳ hành động nào dựa trên mức độ tin cậy của thiết bị; thay vào đó, bạn quyết định điều đó có nghĩa là gì cho trải nghiệm của bạn, chẳng hạn như
từ chối người chơi trên các thiết bị không đáng tin cậy, hạn chế các tính năng nhạy cảm, hoặc
chuyển người chơi đến một nơi khác.

Để chấp nhận hoặc từ chối mỗi người chơi khi mức độ tin cậy của họ có sẵn, hãy gán một
hàm cho
`Class.IntegrityService.EvaluatePlayerDeviceTrust|EvaluatePlayerDeviceTrust`.
Để đọc mức độ tin cậy của một người chơi bất kỳ lúc nào, hãy sử dụng
`Class.Player.DeviceTrustLevel`.

Mức độ tin cậy của thiết bị mô tả thiết bị của người chơi, không phải người chơi hoặc tài khoản của họ. **Nó không cho bạn biết liệu một người chơi có đang gian lận hay không.** Để xem các mẫu mã và hướng dẫn về việc chọn chính sách, hãy xem
[mức độ tin cậy của thiết bị](/scripting/security/device-trust).


IntegrityService

Một dịch vụ cho phép bạn quyết định cách trải nghiệm của bạn phản hồi với mức độ tin cậy của thiết bị của từng người chơi.

`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ể tạo trực tiếp các đối tượng `Instance` gốc, nhưng hàm khởi tạo đặc biệt
`Datatype.Instance.new()` tạo ra các đối tượng thông qua mã, nhận tên của lớp như một tham số và trả về đối tượng đã tạo.


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

Cha của ChangingPart được thiết lập với các giá trị khác nhau theo thời gian. Cha của
phần đó là tổ tiên của phần đó, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt
mỗi khi nó thay đổi.

Kích hoạt khi thể hiện này được thay đổi cha hoặc khi bất kỳ tổ tiên nào của
nó được thay đổi cha.

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


Instance.AncestryChanged

child

Thể hiện có thuộc tính `Class.Instance.Parent|Parent` đã thay đổi,
điều này có thể là thể hiện này hoặc một tổ tiên xa hơn, **không**
nhất thiết là thể hiện mà trình xử lý được kết nối.


parent

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng này 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
thể hiện, 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 đây 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()` trả về một sự kiện kích
hoạt khi một thuộc tính cụ thể đã thay đổi.


Instance.AttributeChanged

attribute

Tên của thuộc tính đã được 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 tên của các đối tượng khi chúng được thêm vào Workspace:


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance` này.

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

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

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

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


Instance.ChildAdded

Thể hiện `Class.Instance` đã được thêm vào.


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance` này.


Instance.childAdded

Đoạn mã này in 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 con được xóa khỏi `Class.Instance` này.

Bị xóa đề cập đến khi cha của một đối tượng được thay đổi từ `Class.Instance`
đến 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 con bị xóa (sử dụng `Class.Instance:Destroy()`) vì hàm
xóa đặt cha của một đối tượng thành `nil`.

Sự kiện này chỉ hoạt động cho các con ngay lập tức của `Class.Instance`.
Để có một sự kiện ghi lại tất cả các thế hệ, hãy sử dụng
`Class.Instance.DescendantRemoving`.

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


Instance.ChildRemoved

Thể hiện `Class.Instance` đã bị xóa.


Kích hoạt sau khi một con được xóa khỏi `Class.Instance` này.


Ví dụ sau đâ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 thế hệ được thêm vào `Class.Instance`.

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

Nếu bạn chỉ quan tâm đến **các con trực tiếp** của
`Class.Instance`, hãy sử dụng `Class.Instance.ChildAdded` thay thế.

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


Instance.DescendantAdded

descendant

Kích hoạt sau khi một thế hệ đượ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`
thay đổi sao cho một thể hiện **thế hệ** sẽ không còn là một
thế hệ nữa. `Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent`
của một thể hiện thành `nil`, vì vậy việc gọi phương thức đó trên một thế hệ
của cha sẽ khiến sự kiện này được kích hoạt.

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

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

#### Cảnh báo

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

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Không thao tác với cha của thế hệ trong hàm này!
	-- Sự kiện này được kích hoạt BỞI vì cha đã được thao tác, và sự thay đổi chưa xảy ra
	-- Do đó, việc thay đổi cha như thế này là vấn đề:
	descendant.Parent = game
end)

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


Instance.DescendantRemoving

Thể hiện `Class.Instance` đang bị xóa.


Kích hoạt ngay trước khi một thế hệ 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 đang bị xóa vẫn giữ nguyên vị trí cho đến khi hàm kết nối tạm dừng.

Ví dụ này cho thấy cách mà, khi sử dụng hành vi tín hiệu Deferred, một Instance
được xóa trước khi tín hiệu được phát.

Thể hiện `Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi một hàm
được kết nối vẫn đang sử dụng nó. Tuy nhiên, nếu hàm tạm dừng tại bất kỳ điểm nào,
`Class.Instance` và các thế hệ của nó sẽ được gán 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ẽ được kích hoạt ngay trước khi
`Class.Instance` hoặc một trong các tổ tiên của nó bị xóa bằng
`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ẽ được kích hoạt tại điểm tiếp tục
tiếp theo, sẽ xảy ra sau khi `Class.Instance` hoặc một trong các tổ tiên của nó
bị xóa bằng `Class.Instance:Destroy()`.

Với hành vi `Enum.SignalBehavior.Deferred|Deferred`, việc 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 (có 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 thủ công
thông qua [Explorer](/studio/explorer) hoặc thông qua một plugin,
`Class.Instance` không bị xóa. Thay vào đó, cha đượ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 (hoặc bị hoãn đến sau) khi thể hiện bị
xóa thông qua `Class.Instance:Destroy()`.


Minh họa `Class.Instance.StyledPropertiesChanged`.


Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu dáng nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được đặt thành `nil`.


Instance.StyledPropertiesChanged

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


Phương pháp này áp dụng một thẻ cho đối tượng, không có hiệu lực nếu thẻ đã
được áp dụng. Việc 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 đối tượng đã được thêm từ phía khách hàng sẽ bị loại bỏ nếu máy chủ
  sau đó thêm hoặc xóa một thẻ trên đối tượng đó 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 đối tượng, thường có một số tài nguyên được sử dụng để
  cung cấp chức năng cho thẻ, chẳng hạn 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à dọn dẹp chúng (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 được kết nối với một tín hiệu
  được trả về bởi `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Thẻ để áp dụng cho đối tượng.


Áp dụng một thẻ cho đối tượng.


Hàm con trả về một mảng các con của đối tượng.


Instance:children

Trả về một mảng các con của đối tượng.


Phương pháp này hủy tất cả các con và hậu duệ của một đối tượng.

```
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 hủy **tất cả** các con và hậu duệ, hãy sử dụng
`Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để
lặp qua các con/hậu duệ đó và chọn những gì cần hủy. Ví dụ, đoạn mã sau sẽ hủy tất cả
`Class.BasePart|BaseParts` 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 pháp này hủy tất cả các con của một đối tượng.


Minh họa 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 đối tượng và tất cả các hậu duệ của nó,
bỏ qua tất cả các đối tượng không phải là
`Class.Instance.Archivable|Archivable`. Bản sao của đối tượng gốc được
trả về bởi phương pháp này và `Class.Instance.Parent|Parent` của nó được đặt thành
`nil`. Lưu ý rằng nếu chính đối tượng 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 thiết lập trong một
đối tượng đã được sao chép, giá trị của thuộc tính của 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 tham chiếu đến một đối tượng cũng được sao chép,
  bản sao sẽ tham chiếu đến bản sao.
- Nếu một thuộc tính tham chiếu tham chiếu đến một đối tượng không được sao chép,
  giá trị giống nhau được duy trì trong bản sao.


Instance:Clone

Một bản sao của đối tượng, hoặc `nil` nếu đối tượng không phải là
`Class.Instance.Archivable|Archivable`.


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


Instance:clone

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

Hàm này là cách đúng để 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()` trên tất cả các con. Phương pháp này là cách đúng để loại bỏ
các đối tượng không còn cần thiết.

Việc loại bỏ các đối tượng không cần thiết là 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 vấn đề hiệu suất nghiêm trọng theo thời gian.

Như một thực tiễn tốt nhấ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 hậu duệ của nó) thành `nil`. Điều này
ngăn chặn mã của bạn truy cập 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"
-- Làm điều này để ngăn dòng trên hoạt động:
part = nil
```
Khi một `Class.Instance` đã bị 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** loại bỏ một đối tượng thay vì hủy nó, hãy đặt
`Class.Instance.Parent|Parent` thành `nil`. Ví dụ:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Để hủy một đối tượng sau một khoảng thời gian nhất định, hãy 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 con.


Instance:destroy

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

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

Đoạn mã sau 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 pháp này tìm tổ tiên của một lớp cụ thể,
xin vui lòng xem `Class.Instance:FindFirstAncestorOfClass()` và
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

Đố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` bằng với tên đã cho.


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

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

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

```
local model = part:FindFirstAncestorOfClass("Model")
```
Phương pháp 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
tồn tại, sử dụng phương pháp `Class.Object:IsA()` thay thế để tôn trọng kế thừa lớp.


Instance:FindFirstAncestorOfClass

className

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


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


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

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

Khác với `Class.Instance:FindFirstAncestorOfClass()`, phương pháp 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 sẽ trả về tổ tiên đầu tiên là `Class.BasePart`, bất kể nó là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
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 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ề con đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không có con nào như vậy tồn tại. 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 hậu duệ thay vì chỉ các con ngay lập tức 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 con bằng tên sử dụng toán tử chấm sẽ gây ra lỗi nếu con không tồn tại.

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

-- Dòng sau sẽ gây 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`,
rồi sử dụng một câu lệnh `if` để chạy mã cần nó.

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

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

#### Tìm một con có tên khớp với một thuộc tính

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

Trong ví dụ sau, một `Class.Folder` có tên là `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` tham chiếu đến giá trị thuộc tính `Datatype.Color3`, không phải là con
`Class.Folder` instance. 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 con
```

#### 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 lâu hơn so với việc chỉ đơn giả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 được kết nối với
`Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
hãy lưu kết quả vào 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 con có tên cho trước trở nên khả dụng.


Instance:FindFirstChild

recursive

Có hay không việc tìm kiếm nên được thực hiện đệ quy.


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


Instance:findFirstChild

Trả về con đầu tiên của `Class.Instance` mà
`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 mà lớp của chúng khớp với `className`, bỏ qua kế thừa lớp. Nếu không tìm thấy con khớp, phương pháp này trả về `nil`.


Instance:FindFirstChildOfClass

Trả về con đầu tiên của `Class.Instance` mà
`Class.Object.ClassName|ClassName` bằng với 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 khớp, phương pháp này trả về `nil`. Nếu tham số
tùy chọn đệ quy là true, phương pháp này tìm kiếm tất cả các hậu duệ thay vì chỉ 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 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 là `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 tìm kiếm một con theo tên, nên sử dụng
`Class.Instance:FindFirstChild()` thay thế.


Instance:FindFirstChildWhichIsA

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


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

Phương pháp 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 đối tượng, hãy 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 được tìm thấy với tên `Class.Instance.Name` đã cho.


Nếu `Class.Instance` là một `Class.Actor`, chính `Class.Actor` đó sẽ
được trả về. Nếu không, tổ tiên gần nhất của nó là `Class.Actor` sẽ được trả về. Nếu không có
tổ tiên nào là `Class.Actor`, kết quả 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 pháp 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 đối tượng:

```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()` thiết lập thuộc tính với tên đã cho thành giá trị đã cho.
- `Class.Instance:GetAttributes()` trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính của đối tượng.


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 pháp này trả về một sự kiện hoạt động giống hệt như sự kiện
`Class.Object.Changed|Changed`, ngoại trừ nó chỉ được kích hoạt khi thuộc tính đã cho thay đổi; về cơ bản nó tương tự như
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng
cho các thuộc tính.

Thông thường, tốt hơn là sử dụng phương pháp 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 cuộc gọi tiếp theo đến phương pháp 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 trả về một tín hiệu 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 thay đổi trên đối tượng.


Instance:GetAttributeChangedSignal

Tên của thuộc tính đã chỉ định 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 được kích hoạt khi thuộc tính đã cho thay đổi.


Phương pháp 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à một giá trị không phải `nil`.

Ví dụ, đoạn mã sau xuất ra các thuộc tính và giá trị của một đối tượng:

```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 của thuộc tính và biến là một giá trị không phải nil.


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


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 chỉ mục số) chứa tất cả các con trực tiếp của đối tượng,
hoặc mọi `Class.Instance` mà `Class.Instance.Parent|Parent` của nó bằng với đối tượng. Mảng có thể được lặp qua 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
việc sắp xếp thủ công (ví dụ sử dụng `Library.table.sort()`) được khuyến nghị cho
việc sắp xếp các con đượ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 con của đối tượng.


Trả về một mảng chứa tất cả các con của đối tượng.


Instance:getChildren

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 lệnh trước khi một ứ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ệnh chạy (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 (chẳng hạn 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 hậu duệ
của đối tượng đó. Khác với `Class.Instance:GetChildren()`, chỉ trả về
các 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,
mọi con của những con đó, và cứ thế.

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
việc sắp xếp thủ công (ví dụ sử dụng `Library.table.sort()`) được khuyến nghị cho
việc sắp xếp các hậu duệ được trả về bởi phương pháp này. Cũng xem xét phương pháp
`Class.Instance:QueryDescendants()|QueryDescendants()` để truy vấn
các hậu duệ bằng cách kế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 đối tượng.


Trả về một mảng chứa tất cả các hậu duệ của đối tượng.


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.

Mẫu mã này tái triển khai hàm `Class.Instance:GetFullName()` trong
Lua.


Trả về một chuỗi mô tả về tổ tiên của đối tượng. Chuỗi 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 tách bằng dấu chấm. `Class.DataModel` (`game`) không
được xem xét. 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 hậu duệ của
`Class.DataModel`, phương pháp này xem xét tất cả các tổ tiên lên đến và bao gồm
một tổ tiên cao nhất không có `Class.Instance.Parent|Parent`.

Phương pháp này hữu ích cho việc ghi lại 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
tránh dấu các 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ệ, nó không
được đảm bảo.


Instance:GetFullName

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


Trả về một chuỗi mô tả về tổ tiên của đối tượng.


Minh họa `Class.Instance:GetStyled()`.


Phương pháp này trả về giá trị đã được định kiểu hoặc sửa đổi rõ ràng của thuộc tính
đã chỉ định, hoặc giá trị thuộc tính mặc định nếu nó chưa được định kiểu/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.


Instance:GetStyled

Tên của thuộc tính để truy vấn.


selector

Bộ chọn tùy chọn cho đối tượng giả mà bạn đang nhắm đến trên đối tượng.


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


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


Minh họa `Class.Instance:GetStyledPropertyChangedSignal()`.


Phương pháp này trả về một sự kiện hoạt động giống hệt như sự kiện
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
ngoại trừ nó chỉ được kích hoạt khi thuộc tính kiểu đã cho thay đổi. Thông thường, tốt hơn là sử dụng phương pháp này thay vì 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 cuộc gọi tiếp theo đến phương pháp 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.

Lưu ý rằng sự kiện này sẽ không truyền bất kỳ đối số nào cho một 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 trong một
kịch bản.


Instance:GetStyledPropertyChangedSignal

property

Tên của 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.


Trả về một sự kiện được kích hoạt khi thuộc tính kiểu đã cho thay đổi trên đối tượng.


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

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


Instance:GetTags

Một mảng chuỗi, mỗi chuỗi đại diện cho một thẻ đã áp dụng cho đối tượng.


Lấy một mảng tất cả các thẻ đã áp dụng cho đối tượng.


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


Instance:HasTag

Thẻ để kiểm tra trên đối tượng.


`true` nếu đối tượng có thẻ đã cho, `false` nếu không.


Kiểm tra xem đối tượng có một thẻ đã cho 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 `Class.Instance.Parent`
 của cha nó đượ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 tham số `nil` để
kiểm tra xem một đối tượng đã bị loại bỏ hay chưa.

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.


Instance:isDescendantOf

Phương pháp này chỉ ra xem một thuộc tính cụ thể đã được sửa đổi từ
mặc định được khởi tạo bằng mã hay chưa. Nếu được gọi trên một đối tượng 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 các quy trình Studio như
cửa sổ [Explorer](/studio/explorer) chèn, kết quả có thể khác.

Ví dụ, truy vấn thuộc tính
`Class.TextLabel.BackgroundColor3|BackgroundColor3` của một
`Class.TextLabel` được chèn qua cửa sổ [Explorer](/studio/explorer)
sẽ trả về `true`, nhưng truy vấn cùng 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 phương pháp này chỉ trả về kết quả hữu ích cho các dịch vụ và
các đối tượng do người dùng tạo. Giá trị trả về cho các thuộc tính do hệ thống
điền vào của các đối tượng như `Class.PackageLink` là hành vi không xác định.

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


Instance:IsPropertyModified

Boolean cho biết liệu thuộc tính có được sửa đổi từ
mặc định được khởi tạo bằng mã hay không.


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


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

#### Bộ chọn

- `ClassName` — Khớp với các đối tượng của lớp đã chỉ định trong mối quan hệ
  `Class.Object:IsA()`.
- `.Tag` — Khớp với các đối tượng được gán thẻ với thẻ `Class.CollectionService`.
- `#Name` — Khớp với các đối tượng có `Class.Instance.Name` cụ thể.
- `[property = value]` — Khớp với các đối tượng có thuộc tính đã chỉ định
  và thuộc tính đó có giá trị đã chỉ định. Các giá trị Boolean, số và
  chuỗi được hỗ trợ. Chữ cái, số, `_`, và `-` có thể được sử dụng
  mà không cần đặt giá trị trong dấu ngoặc kép.
- `[$attribute]` — Khớp với các đối tượng có thuộc tính đã chỉ định
  [thuộc tính](/studio/properties#instance-attributes) được thiết lập.
- `[$attribute = value]` — Khớp với các đối tượng có thuộc tính đã chỉ định **và** thuộc tính đó có giá trị đã chỉ định. Các
  giới hạn tương tự áp dụng như đối với các bộ chọn thuộc tính. Nếu bạn muốn kiểm tra sự vắng mặt của một thuộc tính, đừng truy vấn nó như `nil`; thay vào đó hãy sử dụng
  lớp giả `:not` như trong `:not([$attribute])`.

Các bộ chọn cũng có thể được kết hợp. Ví dụ,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` sẽ khớp với các đối tượng là
một `Class.Model` được gán thẻ là `Apple` và có thuộc tính `Variety`
bằng `Fuji` cũng như thuộc tính `Flavor` bằng `4`.

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

-- Lấy tất cả các hậu duệ MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Lấy tất cả các hậu duệ được gán thẻ là "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Lấy tất cả các hậu duệ có tên là "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Lấy tất cả các hậu duệ có thuộc tính CanCollide được đặt thành false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Lấy tất cả các hậu duệ có thuộc tính "FuelCapacity" được gán
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Lấy tất cả các hậu duệ có thuộc tính "FuelCapacity" được đặt thành 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Tổ hợp

Các tổ hợp cho phép bạn kết hợp các bộ chọn cơ bản để khớp các mối quan hệ cấp bậc sâu hơn.

- `>` — Khớp với các đối tượng là **con trực tiếp** của các bộ lọc trước đó.

- `>>` — Khớp với các đối tượng là **hậu duệ** của các bộ lọc trước đó. Đây là bộ lọc đầu tiên mặc định, có nghĩa là `SpotLight.Red`
  giống như `>> SpotLight.Red`.

- `,` — Chỉ định một danh sách các bộ chọn độc lập cho truy vấn hậu duệ. Chỉ các phần tử khớp với bộ lọc được đặt trong
  mảng trả về; `nil` sẽ không được bao gồm cho các phần không khớp trong danh sách truy vấn.

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

-- Lấy các con trực tiếp của bất kỳ Mô hình nào được gán thẻ là "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Lấy các con trực tiếp là một Phần và được gán thẻ là "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Lấy các hậu duệ của bất kỳ Mô hình nào có thuộc tính "OnFire" được đặt thành true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Lấy các hậu duệ MeshPart được gán thẻ là "SwordPart" HOẶC có thuộc tính "OnFire" được đặt thành true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Bộ chọn lớp giả

- `:not(complex-selector-list)` — Cho phép chọn các đối tượng **không** khớp với bất kỳ bộ chọn nào bên trong,
  thực hiện một phép phủ định của các bộ chọn. Vì biểu thức bên trong là một danh sách các bộ chọn phức tạp,
  nên có thể lọc dựa trên nhiều điều kiện.

- `:has(relative-selector-list)` — Cho phép chọn các đối tượng dựa trên
  các đối tượng mà chúng chứa bên trong. Danh sách bộ chọn được đánh giá
  tương đối với mỗi đối tượng.

- `:in-radius(studs, complex-selector-list)` Chọn các đối tượng trong
  số lượng studs đã chỉ định. Danh sách bộ chọn được đánh giá chống lại tất cả
  các đối tượng khớp với truy vấn. Nó thực sự đánh giá một phép nối.

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

-- Lấy tất cả các hậu duệ KHÔNG phải là lớp SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Lấy tất cả các hậu duệ KHÔNG phải là lớp SpotLight HOẶC PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Lấy tất cả các hậu duệ KHÔNG có thuộc tính "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Lấy tất cả các hậu duệ NGOẠI TRỪ các con của một Mô hình được gán thẻ là "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Lấy các hậu duệ chứa một đối tượng Tool như là hậu duệ của chính chúng
print(Workspace:QueryDescendants(":has(Tool)"))
-- Lấy các hậu duệ MeshPart chứa một con trực tiếp được gán thẻ là "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Lấy các hậu duệ MeshPart có các con trực tiếp KHÔNG phải là lớp SurfaceAppearance hoặc Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))

-- Lấy các Mô hình Fireball trong vòng 10 studs của một HumanoidRootPart (Người chơi hoặc NPC)
print(Workspace:QueryDescendants("Model.FireBall:in-radius(10, Model:has(> Part#HumanoidRootPart))"))
```


Instance:QueryDescendants

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


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


Trả về một mảng chứa tất cả các hậu duệ của đối tượng khớp với
chuỗi `selector`.


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 thế hệ của nó.

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


Instance:Remove

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


Instance:remove

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

Lưu ý rằng khi gán thẻ cho một thể hiện, thường có một số tài nguyên được sử
dụng để cung cấp chức năng cho thẻ, chẳng hạn 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à dọn dẹp chúng (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 lại mộ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 `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 dáng sẽ ghi đè giá trị mặc định của thuộc tính này.


Instance:ResetPropertyToDefault

Tên của thuộc tính cần đặt lại.


Đặt lại mộ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ị được cung cấp là `nil`, thuộc tính sẽ bị xóa, vì `nil` được trả về
mặc định.

Ví dụ, đoạn mã sau đây đặt thuộc tính `InitialPosition` của thể hiện 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 gạch chéo và dấu gạch
  dưới.
- Không được phép có khoảng trắng hoặc ký hiệu độc đáo (như @, ~, !) nào.
- Chuỗi phải có 100 ký tự trở xuống.
- Tên không được phép bắt đầu bằng **RBX** trừ khi người gọi là một
  kịch bản lõi của Roblox (dành riêng cho Roblox).

Khi cố gắng đặt thuộc tính thành một kiểu không được hỗ trợ, một lỗi sẽ
được ném ra.

#### Xem thêm

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


Instance:SetAttribute

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


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


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/IntegrityService.yaml

Tóm tắt