CollectionService | 설명서 - Roblox 크리에이터 허브

엔진 클래스

CollectionService

만들 수 없음

서비스

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

요약

메서드

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

상속된 멤버

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

코드 샘플

컬렉션 서비스 사용한 치명적인 블록

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

코드 샘플

컬렉션 서비스 사용한 치명적인 블록

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

코드 샘플

컬렉션 서비스 사용한 치명적인 블록

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")