CollectionService | Tài liệu - Trung Tâm Nhà Sáng Tạo Roblox

Lớp công cụ

CollectionService

Không Thể Tạo

Dịch Vụ

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Tóm Tắt

Phương Pháp

AddTag(instance: Instance,tag: string):()

GetAllTags():{any}

GetCollection(class: string):Instances

Đã Lỗi Thời

GetInstanceAddedSignal(tag: string):RBXScriptSignal

GetInstanceRemovedSignal(tag: string):RBXScriptSignal

GetTagged(tag: string):Instances

GetTags(instance: Instance):{any}

HasTag(instance: Instance,tag: string):boolean

RemoveTag(instance: Instance,tag: string):()

Sự Kiện

ItemAdded(instance: Instance):RBXScriptSignal

Đã Lỗi Thời

ItemRemoved(instance: Instance):RBXScriptSignal

Đã Lỗi Thời

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Thành viên kế thừa

57 thành viên kế thừa từ Instance

6 thành viên kế thừa từ Object

Tài Liệu Tham Khảo API

Phương Pháp

AddTag

Các khả năng: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Tham Số

instance:Instance

tag:string

Lợi Nhuận

()

GetAllTags

Ghi Song Song

Các khả năng: Basic

CollectionService:GetAllTags():{any}

Lợi Nhuận

{any}

GetCollection

Đã Lỗi Thời

GetInstanceAddedSignal

Các khả năng: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Tham Số

tag:string

Lợi Nhuận

RBXScriptSignal

Mẫu mã

Khối Chết người sử dụng CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Lưu các kết nối để chúng có thể được ngắt kết nối khi thẻ bị xóa
local connections = {}

local function onInstanceAdded(object)
	-- Xác nhận rằng đối tượng có thẻ này là một BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Nếu có một kết nối đã lưu trên đối tượng này, ngắt kết nối/xóa nó
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Lắng nghe sự kiện thẻ này được áp dụng cho các đối tượng
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Cũng phát hiện bất kỳ đối tượng nào đã có thẻ
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Các khả năng: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Tham Số

tag:string

Lợi Nhuận

RBXScriptSignal

Mẫu mã

Khối Chết người sử dụng CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Lưu các kết nối để chúng có thể được ngắt kết nối khi thẻ bị xóa
local connections = {}

local function onInstanceAdded(object)
	-- Xác nhận rằng đối tượng có thẻ này là một BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Nếu có một kết nối đã lưu trên đối tượng này, ngắt kết nối/xóa nó
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Lắng nghe sự kiện thẻ này được áp dụng cho các đối tượng
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Cũng phát hiện bất kỳ đối tượng nào đã có thẻ
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Ghi Song Song

Các khả năng: Basic

CollectionService:GetTagged(tag:string):Instances

Tham Số

tag:string

Lợi Nhuận

Instances

Mẫu mã

Khối Chết người sử dụng CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Lưu các kết nối để chúng có thể được ngắt kết nối khi thẻ bị xóa
local connections = {}

local function onInstanceAdded(object)
	-- Xác nhận rằng đối tượng có thẻ này là một BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Nếu có một kết nối đã lưu trên đối tượng này, ngắt kết nối/xóa nó
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Lắng nghe sự kiện thẻ này được áp dụng cho các đối tượng
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Cũng phát hiện bất kỳ đối tượng nào đã có thẻ
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Ghi Song Song

Các khả năng: Basic

CollectionService:GetTags(instance:Instance):{any}

Tham Số

instance:Instance

Lợi Nhuận

{any}

Mẫu mã

Sử dụng Tag và CollectionService

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

local object = Workspace.Part

-- Thêm một tag
CollectionService:AddTag(object, "Deadly")

-- Truy vấn một tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " là nguy hiểm")
end

-- Liệt kê các tag trên một đối tượng
local tags = CollectionService:GetTags(object)
print("Đối tượng " .. object:GetFullName() .. " có các tag: " .. table.concat(tags, ", "))

-- Xóa một tag
CollectionService:RemoveTag(object, "Deadly")

HasTag

Ghi Song Song

Các khả năng: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Tham Số

instance:Instance

tag:string

Lợi Nhuận

boolean

Mẫu mã

Sử dụng Tag và CollectionService

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

local object = Workspace.Part

-- Thêm một tag
CollectionService:AddTag(object, "Deadly")

-- Truy vấn một tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " là nguy hiểm")
end

-- Liệt kê các tag trên một đối tượng
local tags = CollectionService:GetTags(object)
print("Đối tượng " .. object:GetFullName() .. " có các tag: " .. table.concat(tags, ", "))

-- Xóa một tag
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

Các khả năng: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Tham Số

instance:Instance

tag:string

Lợi Nhuận

()

Mẫu mã

Sử dụng Tag và CollectionService

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

local object = Workspace.Part

-- Thêm một tag
CollectionService:AddTag(object, "Deadly")

-- Truy vấn một tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " là nguy hiểm")
end

-- Liệt kê các tag trên một đối tượng
local tags = CollectionService:GetTags(object)
print("Đối tượng " .. object:GetFullName() .. " có các tag: " .. table.concat(tags, ", "))

-- Xóa một tag
CollectionService:RemoveTag(object, "Deadly")