CollectionService | Documentación del Centro de creación de Roblox

Clase de motor

CollectionService

No creable

Servicio

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

Resumen

Métodos

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

GetAllTags():{any}

GetCollection(class: string):Instances

Obsoleto

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

Eventos

ItemAdded(instance: Instance):RBXScriptSignal

Obsoleto

ItemRemoved(instance: Instance):RBXScriptSignal

Obsoleto

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Miembros heredados

57 heredado de Instance

6 heredado de Object

Referencia API

Métodos

AddTag

Capacidades: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Parámetros

instance:Instance

tag:string

Devuelve

()

GetAllTags

Escribir paralelo

Capacidades: Basic

CollectionService:GetAllTags():{any}

Devuelve

{any}

GetCollection

Obsoleto

GetInstanceAddedSignal

Capacidades: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Parámetros

tag:string

Devuelve

RBXScriptSignal

Muestras de código

Ladrillos Mortales utilizando 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

-- Guarda las conexiones para que puedan ser desconectadas cuando se elimine la etiqueta
local connections = {}

local function onInstanceAdded(object)
	-- Confirma que el objeto con esta etiqueta es un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Si hay una conexión almacenada en este objeto, desconéctala/elímínala
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Escucha por esta etiqueta siendo aplicada a objetos
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- También detecta cualquier objeto que ya tenga la etiqueta
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Capacidades: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Parámetros

tag:string

Devuelve

RBXScriptSignal

Muestras de código

Ladrillos Mortales utilizando 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

-- Guarda las conexiones para que puedan ser desconectadas cuando se elimine la etiqueta
local connections = {}

local function onInstanceAdded(object)
	-- Confirma que el objeto con esta etiqueta es un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Si hay una conexión almacenada en este objeto, desconéctala/elímínala
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Escucha por esta etiqueta siendo aplicada a objetos
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- También detecta cualquier objeto que ya tenga la etiqueta
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Escribir paralelo

Capacidades: Basic

CollectionService:GetTagged(tag:string):Instances

Parámetros

tag:string

Devuelve

Instances

Muestras de código

Ladrillos Mortales utilizando 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

-- Guarda las conexiones para que puedan ser desconectadas cuando se elimine la etiqueta
local connections = {}

local function onInstanceAdded(object)
	-- Confirma que el objeto con esta etiqueta es un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Si hay una conexión almacenada en este objeto, desconéctala/elímínala
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Escucha por esta etiqueta siendo aplicada a objetos
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- También detecta cualquier objeto que ya tenga la etiqueta
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Escribir paralelo

Capacidades: Basic

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

Parámetros

instance:Instance

Devuelve

{any}

Muestras de código

Usando Etiquetas y CollectionService

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

local object = Workspace.Part

-- Agregar una etiqueta
CollectionService:AddTag(object, "Deadly")

-- Consultar una etiqueta
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " es mortal")
end

-- Listar etiquetas en un objeto
local tags = CollectionService:GetTags(object)
print("El objeto " .. object:GetFullName() .. " tiene etiquetas: " .. table.concat(tags, ", "))

-- Eliminar una etiqueta
CollectionService:RemoveTag(object, "Deadly")

HasTag

Escribir paralelo

Capacidades: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Parámetros

instance:Instance

tag:string

Devuelve

boolean

Muestras de código

Usando Etiquetas y CollectionService

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

local object = Workspace.Part

-- Agregar una etiqueta
CollectionService:AddTag(object, "Deadly")

-- Consultar una etiqueta
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " es mortal")
end

-- Listar etiquetas en un objeto
local tags = CollectionService:GetTags(object)
print("El objeto " .. object:GetFullName() .. " tiene etiquetas: " .. table.concat(tags, ", "))

-- Eliminar una etiqueta
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

Capacidades: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Parámetros

instance:Instance

tag:string

Devuelve

()

Muestras de código

Usando Etiquetas y CollectionService

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

local object = Workspace.Part

-- Agregar una etiqueta
CollectionService:AddTag(object, "Deadly")

-- Consultar una etiqueta
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " es mortal")
end

-- Listar etiquetas en un objeto
local tags = CollectionService:GetTags(object)
print("El objeto " .. object:GetFullName() .. " tiene etiquetas: " .. table.concat(tags, ", "))

-- Eliminar una etiqueta
CollectionService:RemoveTag(object, "Deadly")