CollectionService | เอกสาร - ศูนย์กลางครีเอเตอร์ Roblox

Engine Class

CollectionService

ไม่สามารถสร้าง

บริการ

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

สรุป

วิธีการ

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

GetAllTags():{any}

GetCollection(class: string):Instances

เลิกใช้แล้ว

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):()

เหตุการณ์

ItemAdded(instance: Instance):RBXScriptSignal

เลิกใช้แล้ว

ItemRemoved(instance: Instance):RBXScriptSignal

เลิกใช้แล้ว

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

สมาชิกที่ได้รับทอด

สมาชิก 57 คนที่รับทอดมาจาก Instance

สมาชิก 6 คนที่รับทอดมาจาก Object

เอกสารอ้างอิงเกี่ยวกับ API

วิธีการ

AddTag

ความสามารถ: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

พารามิเตอร์

instance:Instance

tag:string

ส่งค่ากลับ

()

GetAllTags

เขียนพร้อมๆ กัน

ความสามารถ: Basic

CollectionService:GetAllTags():{any}

ส่งค่ากลับ

{any}

GetCollection

เลิกใช้แล้ว

GetInstanceAddedSignal

ความสามารถ: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

พารามิเตอร์

tag:string

ส่งค่ากลับ

RBXScriptSignal

ตัวอย่างโค้ด

บล็อกอันตรายโดยใช้ 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

-- บันทึกการเชื่อมต่อเพื่อให้สามารถตัดการเชื่อมต่อเมื่อแท็กถูกลบออก
local connections = {}

local function onInstanceAdded(object)
	-- ยืนยันว่าออบเจ็กต์ที่มีแท็กนี้เป็น BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- หากมีการเชื่อมต่อที่บันทึกไว้บนวัตถุนี้ ให้ตัดการเชื่อมต่อ/ลบมัน
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- ฟังการนำแท็กนี้ไปใช้กับวัตถุ
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- ยังตรวจจับว่าวัตถุใดที่มีแท็กอยู่แล้ว
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

ความสามารถ: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

พารามิเตอร์

tag:string

ส่งค่ากลับ

RBXScriptSignal

ตัวอย่างโค้ด

บล็อกอันตรายโดยใช้ 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

-- บันทึกการเชื่อมต่อเพื่อให้สามารถตัดการเชื่อมต่อเมื่อแท็กถูกลบออก
local connections = {}

local function onInstanceAdded(object)
	-- ยืนยันว่าออบเจ็กต์ที่มีแท็กนี้เป็น BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- หากมีการเชื่อมต่อที่บันทึกไว้บนวัตถุนี้ ให้ตัดการเชื่อมต่อ/ลบมัน
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- ฟังการนำแท็กนี้ไปใช้กับวัตถุ
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- ยังตรวจจับว่าวัตถุใดที่มีแท็กอยู่แล้ว
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

เขียนพร้อมๆ กัน

ความสามารถ: Basic

CollectionService:GetTagged(tag:string):Instances

พารามิเตอร์

tag:string

ส่งค่ากลับ

Instances

ตัวอย่างโค้ด

บล็อกอันตรายโดยใช้ 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

-- บันทึกการเชื่อมต่อเพื่อให้สามารถตัดการเชื่อมต่อเมื่อแท็กถูกลบออก
local connections = {}

local function onInstanceAdded(object)
	-- ยืนยันว่าออบเจ็กต์ที่มีแท็กนี้เป็น BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- หากมีการเชื่อมต่อที่บันทึกไว้บนวัตถุนี้ ให้ตัดการเชื่อมต่อ/ลบมัน
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- ฟังการนำแท็กนี้ไปใช้กับวัตถุ
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- ยังตรวจจับว่าวัตถุใดที่มีแท็กอยู่แล้ว
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

เขียนพร้อมๆ กัน

ความสามารถ: Basic

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

พารามิเตอร์

instance:Instance

ส่งค่ากลับ

{any}

ตัวอย่างโค้ด

การใช้แท็กและ CollectionService

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

local object = Workspace.Part

-- เพิ่มแท็ก
CollectionService:AddTag(object, "Deadly")

-- ค้นหาแท็ก
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " เป็นอันตราย")
end

-- แสดงรายการแท็กบนวัตถุ
local tags = CollectionService:GetTags(object)
print("วัตถุ " .. object:GetFullName() .. " มีแท็ก: " .. table.concat(tags, ", "))

-- ลบแท็ก
CollectionService:RemoveTag(object, "Deadly")

HasTag

เขียนพร้อมๆ กัน

ความสามารถ: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

พารามิเตอร์

instance:Instance

tag:string

ส่งค่ากลับ

boolean

ตัวอย่างโค้ด

การใช้แท็กและ CollectionService

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

local object = Workspace.Part

-- เพิ่มแท็ก
CollectionService:AddTag(object, "Deadly")

-- ค้นหาแท็ก
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " เป็นอันตราย")
end

-- แสดงรายการแท็กบนวัตถุ
local tags = CollectionService:GetTags(object)
print("วัตถุ " .. object:GetFullName() .. " มีแท็ก: " .. table.concat(tags, ", "))

-- ลบแท็ก
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

ความสามารถ: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

พารามิเตอร์

instance:Instance

tag:string

ส่งค่ากลับ

()

ตัวอย่างโค้ด

การใช้แท็กและ CollectionService

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

local object = Workspace.Part

-- เพิ่มแท็ก
CollectionService:AddTag(object, "Deadly")

-- ค้นหาแท็ก
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " เป็นอันตราย")
end

-- แสดงรายการแท็กบนวัตถุ
local tags = CollectionService:GetTags(object)
print("วัตถุ " .. object:GetFullName() .. " มีแท็ก: " .. table.concat(tags, ", "))

-- ลบแท็ก
CollectionService:RemoveTag(object, "Deadly")