CollectionService

CollectionService : Instance

Overview

인스턴스에 문자열 형태의 태그를 부여하여 유사한 속성을 가진 객체들을 효율적으로 그룹화하고 제어할 수 있도록 지원하는 서비스입니다.

서버에서 지정된 태그는 클라이언트로 자동 동기화되어, 양측에서 동일한 태그 상태를 유지할 수 있습니다.

Properties

Methods

AddTag

대상 인스턴스에 지정한 이름의 태그를 추가합니다.

Parameters

instance instance	대상 인스턴스입니다.
string tag	지정할 태그의 이름입니다.

Return

void

Code Samples

local Part = script.Parent
local CollectionService = game:GetService("CollectionService")

CollectionService:AddTag(Part, "SomeTag")

GetTags

대상 인스턴스에 적용된 태그 목록을 문자열 배열로 반환합니다. 특정 태그만 확인하는 HasTag()와 달리, 인스턴스에 적용된 모든 태그를 조회할 때 적합합니다.

Parameters

instance instance	대상 인스턴스입니다.

Return

Array	문자열로 구성된 배열입니다.

Code Samples

local Part = script.Parent
local CollectionService = game:GetService("CollectionService")

local Tags = CollectionService:GetTags(Part)
print(Tags)

HasTag

대상 인스턴스에 지정한 이름의 태그가 추가되어 있으면 true를 반환합니다.

Parameters

instance instance	대상 인스턴스입니다.
string tag	확인할 태그의 이름입니다.

Return

bool	태그의 존재 여부입니다.

Code Samples

local Part = script.Parent
local CollectionService = game:GetService("CollectionService")

local hasTag = CollectionService:HasTag(Part, "SomeTag")
print(hasTag)

RemoveTag

대상 인스턴스에 지정한 이름의 태그를 삭제하며, 해당 태그가 존재하지 않아도 오류 없이 동작합니다.

Parameters

instance instance	대상 인스턴스입니다.
string tag	삭제할 태그의 이름입니다.

Return

void

Code Samples

local Part = script.Parent
local CollectionService = game:GetService("CollectionService")

CollectionService:RemoveTag(Part, "SomeTag")

Events