OBS Component & Scene Watching
The OBS Component (UInhyeongOBSComponent) is a per-actor ActorComponent wrapper around the OBS connection. Add it to any Actor to get a self-contained OBS controller with auto-connect support, a feature picker in the Details panel, and the full set of OBS control methods.
It mirrors the Subsystem API: the same scenes, recording/streaming, audio, and transition methods are available on the component, scoped to that actor’s connection. Use the component when you want explicit, per-actor control (e.g. multiple OBS connections). Use the global Subsystem when one shared connection is enough.
Editor: The component is configured entirely through its Details Panels, including a feature picker that gates which sections render, a prominent Connection card, and the Watched Scenes picker described below.
Scene Watching
The OBS Component includes a scene-watching feature that fires events when OBS switches to or away from specific scenes you care about. This lets gameplay react to scene changes, including manual scene switches made directly in OBS.
Configuration
// In Blueprint or C++
OBSComponent->WatchedScenes.Add("Boss Arena");
OBSComponent->WatchedScenes.Add("Cutscene");
// Or at runtime
OBSComponent->AddWatchedScene("Victory Screen");
OBSComponent->RemoveWatchedScene("Cutscene");
WatchedScenes is an editable list of scene names. AddWatchedScene / RemoveWatchedScene mutate it at runtime.
Events
| Event | Fires when |
|---|---|
OnEnteredWatchedScene(SceneName) | OBS switches to a watched scene |
OnLeftWatchedScene(SceneName) | OBS switches away from a watched scene |
Use Cases
- Trigger game events when specific OBS scenes activate.
- Sync game state with OBS scene changes.
- React to manual scene switches performed in OBS.
Editor: Watched Scenes picker
The component’s Details panel includes a Watched Scenes section with a scene picker (populated from OBS while connected) to add entries, and a remove button per scene, so the list is fully editable without code.
See Also
- Subsystem API: the full method surface the component mirrors.
- Details Panels: the component’s editor UI and feature picker.
- OBS Trigger Volume: no-code spatial automation that can target a specific OBS Component.