OBS Component とシーン監視
OBS Component（UInhyeongOBSComponent）は、アクタごとに OBS 接続をラップする ActorComponent です。任意の アクタ に追加することで、自動接続サポート、詳細パネルの機能ピッカー、そして OBS の全制御メソッドを備えた自己完結型の OBS Controller を利用できます。
これは Subsystem API を反映しており、同じシーン、録画/配信、音声、トランジションのメソッドがコンポーネント上でも利用可能で、そのアクタの接続にスコープされます。複数の OBS 接続など、アクタごとに明示的な制御が必要な場合はコンポーネントを使用してください。共有接続が1つで十分な場合はグローバルな Subsystem を使用してください。
エディタ: コンポーネントはすべて Details Panels から設定します。設定には、どのセクションを表示するかを制御する機能ピッカー、目立つ 接続カード、および後述の Watched Scenes ピッカーが含まれます。
シーン監視
OBS Component にはシーン監視機能が含まれており、OBS が指定したシーンに切り替わったとき、または切り替わった先から離れたときにイベントを発火します。これにより、OBS で直接行われた手動のシーン切り替えを含む、シーン変更にゲームプレイを反応させることができます。
設定
// In Blueprint or C++
OBSComponent->WatchedScenes.Add("Boss Arena");
OBSComponent->WatchedScenes.Add("Cutscene");
// Or at runtime
OBSComponent->AddWatchedScene("Victory Screen");
OBSComponent->RemoveWatchedScene("Cutscene");WatchedScenes はシーン名の編集可能なリストです。AddWatchedScene / RemoveWatchedScene を使うと、ランタイムにリストを変更できます。
イベント
| イベント | 発火タイミング |
|---|---|
OnEnteredWatchedScene(SceneName) | OBS が監視中のシーンに切り替わったとき |
OnLeftWatchedScene(SceneName) | OBS が監視中のシーンから切り替わって離れたとき |
ユースケース
- 特定の OBS シーンがアクティブになったときにゲームイベントをトリガーする。
- ゲームの状態を OBS のシーン変更と同期させる。
- OBS で行われた手動のシーン切り替えに反応する。
エディタ: Watched Scenes ピッカー
コンポーネントの詳細パネルには Watched Scenes セクションがあり、接続中に OBS から取得したシーンを選択して追加できるシーンピッカーと、シーンごとの削除ボタンが用意されています。コードを書かずにリストを完全に編集できます。
関連項目
- Subsystem API: コンポーネントが反映しているメソッドの全一覧。
- Details Panels: コンポーネントのエディタ UI と機能ピッカー。
- OBS Trigger Volume: 特定の OBS Component をターゲットにできるノーコードの空間自動化。