OBS Component와 장면 감시

OBS Component (UInhyeongOBSComponent)는 OBS 연결을 감싸는 액터별 ActorComponent 래퍼입니다. 어떤 액터에든 추가하면 자동 연결 지원, 디테일 패널의 기능 선택기, 그리고 OBS 제어 메서드 전체를 갖춘 독립적인 OBS Controller를 얻을 수 있습니다.

이 컴포넌트는 Subsystem API를 그대로 반영합니다. 동일한 장면, 녹화/방송, 오디오, 전환 메서드가 컴포넌트에도 존재하며, 해당 액터의 연결 범위 내에서 동작합니다. 여러 OBS 연결이 필요한 경우처럼 명시적인 액터별 제어가 필요할 때 컴포넌트를 사용하고, 공유 연결 하나로 충분할 때는 전역 Subsystem을 사용하세요.

Editor: 컴포넌트는 Details Panels을 통해 전적으로 구성됩니다. 여기에는 어떤 섹션을 렌더링할지 제어하는 기능 선택기, 눈에 띄는 연결 카드, 그리고 아래에 설명된 감시 중인 장면 선택기가 포함됩니다.

장면 감시

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으로 런타임에 목록을 변경할 수 있습니다.

이벤트

활용 사례

• 특정 OBS 장면이 활성화될 때 게임 이벤트를 트리거합니다.
• 게임 상태를 OBS 장면 변경과 동기화합니다.
• OBS에서 수행한 수동 장면 전환에 반응합니다.

Editor: 감시 중인 장면 선택기

컴포넌트의 디테일 패널에는 Watched Scenes 섹션이 포함되어 있으며, 연결 상태에서 OBS로부터 목록을 채우는 장면 선택기와 장면별 삭제 버튼이 있어 코드 없이도 목록을 완전히 편집할 수 있습니다.

참고 항목

• Subsystem API: 컴포넌트가 반영하는 전체 메서드 목록입니다.
• Details Panels: 컴포넌트의 에디터 UI와 기능 선택기입니다.
• OBS Trigger Volume: 특정 OBS Component를 대상으로 할 수 있는 노코드 공간 기반 자동화입니다.