CollectionService | Dokumentacja – Centrum twórców Roblox

Klasa silnika

CollectionService

Brak możliwości tworzenia

Usługa

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Podsumowanie

Metody

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

GetAllTags():{any}

GetCollection(class: string):Instances

Przestarzałe

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

Zdarzenia

ItemAdded(instance: Instance):RBXScriptSignal

Przestarzałe

ItemRemoved(instance: Instance):RBXScriptSignal

Przestarzałe

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Członkowie odziedziczeni

57 odziedziczonych od: Instance

6 odziedziczonych od: Object

Materiały referencyjne dotyczące interfejsów API

Metody

AddTag

Możliwości: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Parametry

instance:Instance

tag:string

Zwroty

()

GetAllTags

Zapis równoległy

Możliwości: Basic

CollectionService:GetAllTags():{any}

Zwroty

{any}

GetCollection

Przestarzałe

GetInstanceAddedSignal

Możliwości: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Parametry

tag:string

Zwroty

RBXScriptSignal

Przykłady kodu

Śmiertelne Klocki z użyciem 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

-- Zapisz połączenia, aby mogły zostać rozłączone, gdy tag zostanie usunięty
local connections = {}

local function onInstanceAdded(object)
	-- Potwierdź, że obiekt z tym tagiem jest BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jeśli na tym obiekcie znajduje się zapisane połączenie, rozłącz/usuń je
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Nasłuchuj, gdy ten tag zostanie przypisany do obiektów
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Również wykryj wszelkie obiekty, które już mają ten tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Możliwości: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Parametry

tag:string

Zwroty

RBXScriptSignal

Przykłady kodu

Śmiertelne Klocki z użyciem 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

-- Zapisz połączenia, aby mogły zostać rozłączone, gdy tag zostanie usunięty
local connections = {}

local function onInstanceAdded(object)
	-- Potwierdź, że obiekt z tym tagiem jest BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jeśli na tym obiekcie znajduje się zapisane połączenie, rozłącz/usuń je
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Nasłuchuj, gdy ten tag zostanie przypisany do obiektów
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Również wykryj wszelkie obiekty, które już mają ten tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Zapis równoległy

Możliwości: Basic

CollectionService:GetTagged(tag:string):Instances

Parametry

tag:string

Zwroty

Instances

Przykłady kodu

Śmiertelne Klocki z użyciem 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

-- Zapisz połączenia, aby mogły zostać rozłączone, gdy tag zostanie usunięty
local connections = {}

local function onInstanceAdded(object)
	-- Potwierdź, że obiekt z tym tagiem jest BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jeśli na tym obiekcie znajduje się zapisane połączenie, rozłącz/usuń je
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Nasłuchuj, gdy ten tag zostanie przypisany do obiektów
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Również wykryj wszelkie obiekty, które już mają ten tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Zapis równoległy

Możliwości: Basic

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

Parametry

instance:Instance

Zwroty

{any}

Przykłady kodu

Używanie tagów i CollectionService

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

local object = Workspace.Part

-- Dodaj tag
CollectionService:AddTag(object, "Deadly")

-- Zapytaj o tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " jest śmiertelny")
end

-- Wypisz tagi na obiekcie
local tags = CollectionService:GetTags(object)
print("Obiekt " .. object:GetFullName() .. " ma tagi: " .. table.concat(tags, ", "))

-- Usuń tag
CollectionService:RemoveTag(object, "Deadly")

HasTag

Zapis równoległy

Możliwości: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Parametry

instance:Instance

tag:string

Zwroty

boolean

Przykłady kodu

Używanie tagów i CollectionService

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

local object = Workspace.Part

-- Dodaj tag
CollectionService:AddTag(object, "Deadly")

-- Zapytaj o tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " jest śmiertelny")
end

-- Wypisz tagi na obiekcie
local tags = CollectionService:GetTags(object)
print("Obiekt " .. object:GetFullName() .. " ma tagi: " .. table.concat(tags, ", "))

-- Usuń tag
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

Możliwości: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Parametry

instance:Instance

tag:string

Zwroty

()

Przykłady kodu

Używanie tagów i CollectionService

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

local object = Workspace.Part

-- Dodaj tag
CollectionService:AddTag(object, "Deadly")

-- Zapytaj o tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " jest śmiertelny")
end

-- Wypisz tagi na obiekcie
local tags = CollectionService:GetTags(object)
print("Obiekt " .. object:GetFullName() .. " ma tagi: " .. table.concat(tags, ", "))

-- Usuń tag
CollectionService:RemoveTag(object, "Deadly")