Runtime Sets Demo

概要

Runtime Sets パターンのデモです。これは、シングルトンを使用せずに動的なオブジェクトコレクションを管理するScriptableObjectベースのアプローチです。

このデモでは以下を示します。

自動コレクション追跡を伴うオブジェクトのスポーンと破棄
コレクション変更時のイベント駆動UI更新
Inspectorでのアクティブオブジェクトのリアルタイム可視化

Runtime Sets Demo

使用している機能

機能	アセット	説明
Runtime Set	`SpawnedObjects` (GameObjectRuntimeSetSO)	すべてのスポーンされたオブジェクトを追跡
Event Channel	`OnSpawnClicked` (VoidEventChannelSO)	スポーンボタンイベント
Event Channel	`OnClearClicked` (VoidEventChannelSO)	クリアボタンイベント
Event Channel	`OnRuntimeSetUpdated` (VoidEventChannelSO)	コレクション変更通知

アーキテクチャ

graph LR
    subgraph "UI Layer"
        UI[RuntimeSetDemoUI]
        DSP[RuntimeSetDisplay]
    end

    subgraph "Event Channels"
        SPAWN_EVT[VoidEventChannelSO<br/>OnSpawnClicked]
        CLEAR_EVT[VoidEventChannelSO<br/>OnClearClicked]
        UPDATE_EVT[VoidEventChannelSO<br/>OnRuntimeSetUpdated]
    end

    subgraph "Runtime Set"
        SET[GameObjectRuntimeSetSO<br/>SpawnedObjects]
    end

    subgraph "Logic"
        SPAWNER[ObjectSpawner]
        CLEANER[RuntimeSetCleaner]
    end

    subgraph "Spawned Objects"
        OBJ[RuntimeSetMember]
    end

    UI -->|"RaiseEvent()"| SPAWN_EVT
    UI -->|"RaiseEvent()"| CLEAR_EVT
    SPAWN_EVT -->|"OnEventRaised"| SPAWNER
    SPAWNER -->|"Instantiate()"| OBJ
    OBJ -->|"OnEnable: Add()"| SET
    OBJ -->|"OnDisable: Remove()"| SET
    CLEAR_EVT -->|"OnEventRaised"| CLEANER
    CLEANER -->|"DestroyItems()"| SET
    SET -->|"onItemsChanged"| UPDATE_EVT
    UPDATE_EVT -->|"OnEventRaised"| DSP

重要なポイント: Runtime Setsはマネージャーシングルトンの必要性を排除します。オブジェクトはRuntimeSetMember.OnEnable()で自身を登録し、OnDisable()で解除します。これにより適切なライフサイクル管理が保証され、破棄や無効化時に自動的にコレクションから削除されます。

主要ファイル

ファイル	説明
`Scripts/RuntimeSetDemoUI.cs`	UIボタンをEventChannelsに接続
`Scripts/ObjectSpawner.cs`	オブジェクトをスポーン（prefabにはRuntimeSetMemberが必要）
`Scripts/RuntimeSetMember.cs`	prefab用の自己登録コンポーネント
`Scripts/ObjectDestroyer.cs`	衝突時にオブジェクトを破棄
`Scripts/RuntimeSetDisplay.cs`	現在のオブジェクト数を表示
`Scripts/RuntimeSetCleaner.cs`	RuntimeSetからすべてのオブジェクトをクリア
`ScriptableObjects/RuntimeSets/SpawnedObjects.asset`	GameObjectRuntimeSetSO

使い方

RuntimeSetsDemo シーンを開く
Play Modeに入る
Spawn Object をクリックしてランダムなキューブ/球体を生成
Projectウィンドウで SpawnedObjects アセットを選択し、リアルタイムの追跡を確認
スポーンされたオブジェクト同士を衝突させて破棄
Clear All をクリックしてすべてのオブジェクトを一度に削除

ユースケース

このパターンは、動的なオブジェクトコレクション管理が必要なシナリオに適用できます。

ユースケース	具体例
敵の管理	マネージャーシングルトンなしですべてのアクティブな敵を追跡
スポーンオブジェクト	動的に作成されたピックアップ、発射物、エフェクトの管理
UI要素	一括操作（すべて閉じる、すべて最小化）のためにアクティブなパネルを追跡
レベルクリーンアップ	シーン変更時にすべてのスポーンオブジェクトを破棄