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

GetTagged

특정 태그가 설정된 객체들을 반환합니다.

단, 게임의 DataModel 구조 안에 포함되어 있는 객체만을 대상으로 하며, 아직 부모가 지정되지 않았거나 DataModel 구조 외부에 있는 객체는 결과에서 제외됩니다.

Parameters

string tag	조회할 태그의 이름입니다.

Return

Array	지정된 태그가 적용된 객체들의 배열입니다.

Code Samples

local CollectionService = game:GetService("CollectionService")
local Array = CollectionService:GetTagged("SomeTag")

for i = 1, #Array do
    print(Array)	
end

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