CollectionService | Documentation - Hub Création Roblox

Classe de moteur

CollectionService

Création impossible

Service

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Résumé

Méthodes

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

GetAllTags():{any}

GetCollection(class: string):Instances

Déprécié

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

Événements

ItemAdded(instance: Instance):RBXScriptSignal

Déprécié

ItemRemoved(instance: Instance):RBXScriptSignal

Déprécié

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Membres hérités

57 hérité du Instance

6 hérité du Object

Référence API

Méthodes

AddTag

Capacités : Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Paramètres

instance:Instance

tag:string

Retours

()

GetAllTags

Écrire en parallèle

Capacités : Basic

CollectionService:GetAllTags():{any}

Retours

{any}

GetCollection

Déprécié

GetInstanceAddedSignal

Capacités : Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Paramètres

tag:string

Retours

RBXScriptSignal

Échantillons de code

Briques Mortelles utilisant 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

-- Sauvegarder les connexions pour qu'elles puissent être déconnectées lorsque le tag est supprimé
local connections = {}

local function onInstanceAdded(object)
	-- Confirmer que l'objet avec ce tag est un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- S'il y a une connexion stockée sur cet objet, la déconnecter / la supprimer
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Écouter l'application de ce tag aux objets
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Détecter également tous les objets qui ont déjà le tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Capacités : Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Paramètres

tag:string

Retours

RBXScriptSignal

Échantillons de code

Briques Mortelles utilisant 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

-- Sauvegarder les connexions pour qu'elles puissent être déconnectées lorsque le tag est supprimé
local connections = {}

local function onInstanceAdded(object)
	-- Confirmer que l'objet avec ce tag est un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- S'il y a une connexion stockée sur cet objet, la déconnecter / la supprimer
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Écouter l'application de ce tag aux objets
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Détecter également tous les objets qui ont déjà le tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Écrire en parallèle

Capacités : Basic

CollectionService:GetTagged(tag:string):Instances

Paramètres

tag:string

Retours

Instances

Échantillons de code

Briques Mortelles utilisant 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

-- Sauvegarder les connexions pour qu'elles puissent être déconnectées lorsque le tag est supprimé
local connections = {}

local function onInstanceAdded(object)
	-- Confirmer que l'objet avec ce tag est un BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- S'il y a une connexion stockée sur cet objet, la déconnecter / la supprimer
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Écouter l'application de ce tag aux objets
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Détecter également tous les objets qui ont déjà le tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Écrire en parallèle

Capacités : Basic

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

Paramètres

instance:Instance

Retours

{any}

Échantillons de code

Utilisation des Tags et de CollectionService

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

local object = Workspace.Part

-- Ajouter un tag
CollectionService:AddTag(object, "Mortel")

-- Interroger un tag
if CollectionService:HasTag(object, "Mortel") then
	print(object:GetFullName() .. " est mortel")
end

-- Lister les tags sur un objet
local tags = CollectionService:GetTags(object)
print("L'objet " .. object:GetFullName() .. " a des tags : " .. table.concat(tags, ", "))

-- Enlever un tag
CollectionService:RemoveTag(object, "Mortel")

HasTag

Écrire en parallèle

Capacités : Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Paramètres

instance:Instance

tag:string

Retours

boolean

Échantillons de code

Utilisation des Tags et de CollectionService

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

local object = Workspace.Part

-- Ajouter un tag
CollectionService:AddTag(object, "Mortel")

-- Interroger un tag
if CollectionService:HasTag(object, "Mortel") then
	print(object:GetFullName() .. " est mortel")
end

-- Lister les tags sur un objet
local tags = CollectionService:GetTags(object)
print("L'objet " .. object:GetFullName() .. " a des tags : " .. table.concat(tags, ", "))

-- Enlever un tag
CollectionService:RemoveTag(object, "Mortel")

RemoveTag

Capacités : Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Paramètres

instance:Instance

tag:string

Retours

()

Échantillons de code

Utilisation des Tags et de CollectionService

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

local object = Workspace.Part

-- Ajouter un tag
CollectionService:AddTag(object, "Mortel")

-- Interroger un tag
if CollectionService:HasTag(object, "Mortel") then
	print(object:GetFullName() .. " est mortel")
end

-- Lister les tags sur un objet
local tags = CollectionService:GetTags(object)
print("L'objet " .. object:GetFullName() .. " a des tags : " .. table.concat(tags, ", "))

-- Enlever un tag
CollectionService:RemoveTag(object, "Mortel")