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

継承されたメンバー

Instanceから継承された57

Objectから継承された6

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