이 번역은 최신 영어 원문보다 늦을 수 있습니다. 영어 버전 보기

Details Panels

이 플러그인은 풍부하고 커스터마이즈된 디테일 패널을 제공하여, 플레이 모드 없이 에디터에서 직접 OBS를 제어할 수 있습니다. OBS Component를 가진 모든 액터와 OBS Trigger Volume 액터에 전용 패널이 제공됩니다.

디테일 UI가 아닌 에디터 코드에서 OBS를 제어하는 방법은 Editor Subsystem을 참고하세요. 아래 모든 섹션에서 공통으로 사용하는 위젯·색상·간격 상수 규칙은 Style System에 문서화되어 있습니다.

OBS Component Details Panel

OBS Component가 있는 액터를 선택하면, 디테일 패널에 펼칠 수 있는 섹션들이 렌더링됩니다. 많은 섹션이 기본적으로 접혀 있으며, 어떤 섹션이 표시되는지는 컴포넌트의 기능 선택기에 의해서도 결정됩니다(아래 참고).

기능 / 컴포넌트 선택기

패널 상단에 고정된 기능 선택기는 어떤 섹션이 렌더링되고 컴포넌트가 어떤 OBS 이벤트 스트림을 구독할지 제어하는 토글 카드 그리드입니다.

잠긴 Connection(항상 활성화) 기반 카드.
토글 카드(기본값: Scenes 및 Recording & Streaming), 각 카드에는 간단한 영문 레이블과 한 줄 툴팁이 있으며, 켜짐/꺼짐 상태에 따라 상태 점과 강조 테두리가 표시됩니다.
Enable all / Reset 버튼.

카드를 토글하면 컴포넌트의 EnabledFeatures 속성에 비트가 기록되고(저장 및 되돌리기 가능), 패널이 재빌드되어 활성화된 섹션만 표시됩니다. 일부 기능은 활성화 시 더 높은 빈도의 이벤트 스트림을 구독하기도 합니다(예: 장면 변형 이벤트).

핵심 장점은 UI 명확성과 선택하지 않은 이벤트 스트림에 구독하지 않는 것입니다. 핸들러 자체는 지연 생성되며 비용이 적습니다.

Connection 섹션

Connection 섹션은 상단 근처에 항상 펼쳐진 상태로 고정된, 눈에 잘 띄는 강조 카드입니다.

Host / Port / Password: 연결 설정(편집 가능한 속성). 비밀번호 필드는 기본적으로 마스킹되며, 눈 모양 토글로 표시할 수 있습니다.
Auto Connect: BeginPlay 시 자동으로 연결합니다.
Status Indicator: 시각적 연결 상태(녹색 = 연결됨, 노란색 = 연결 중, 회색 = 연결 끊김).
Connect / Disconnect / Refresh: 제어 버튼.
연결이 끊긴 상태에서만 연결하라는 힌트가 표시됩니다.

Configuration 섹션 (기본적으로 접혀 있음)

Scene Collections
- 현재 장면 모음 드롭다운: 장면 모음 선택 / 전환
- 새 장면 모음 텍스트 입력과 Create 버튼
- 새로 고침 버튼
Profiles
- 현재 프로필 드롭다운: 프로필 선택 / 전환
- Delete 버튼(현재 프로필에서는 비활성화)
- 새 프로필 텍스트 입력과 Create 버튼
- 새로 고침 버튼
Video Settings
- 방송 / 녹화 중 경고 텍스트(설정 잠금)
- Base Resolution: 가로 × 세로 스핀박스
- Output Resolution: 가로 × 세로 스핀박스
- FPS 드롭다운(30, 60, 120, 29.97, 59.94)
- Apply 버튼(방송 / 녹화 중에는 비활성화)
- 새로 고침 버튼
Stream Service Settings
- 현재 방송 중 경고 텍스트(변경 사항은 재시작 후 적용)
- Service Type 드롭다운(Custom RTMP / Common Service)
- Server URL 입력(Custom RTMP 선택 시 표시)
- Common Service 드롭다운: Twitch, YouTube, Facebook 등(Common Service 선택 시 표시)
- Stream Key 입력(Show / Hide 토글이 있는 비밀번호 마스킹)
- Use Authentication 체크박스
- Username 입력(인증 활성화 시 표시)
- Password 입력(인증 활성화 시 표시, 항상 마스킹)
- Apply / Refresh 버튼

Scenes 섹션

Current Scene: 상태 표시기와 함께 표시
Switch To: 활성 장면을 변경하는 드롭다운
Trigger Scene: 트리거 시 전환할 장면(TriggerSceneName 설정)
Available Scenes Header: 장면 수와 + New Scene 버튼(장면 생성 대화상자 열기)이 있는 레이블
Scene List: 장면마다 펼칠 수 있는 영역:
- Scene Row Header: 장면 이름(현재 장면이면 굵은 녹색), 괄호 안에 소스 수, Rename 버튼, Delete 버튼(빨간색, 현재 장면에서는 비활성화)
- Transition Override(펼쳐진 장면 내부): 전환 드롭다운(“(No Override)“로 초기화), 시간 스핀박스(50 ~ 20000ms), Clear 버튼
- Source List: 각 소스에 표시 여부 체크박스, 잠금 토글, Z 순서 위/아래 버튼, 변형 편집 버튼, 제거 버튼
- + Add Source: 소스 선택기를 열어(모든 OBS 입력과 중첩을 위한 다른 장면 목록) CreateSceneItem을 통해 선택 항목을 추가

Scene Item Transform 섹션

Selection Header: 선택한 소스 이름과 장면
Fetch / Duplicate / Clear: OBS에서 새로 고침, 항목 복제, 또는 선택 해제
Position: X / Y 좌표 스핀박스
Scale: X / Y 스케일 스핀박스(0.01 정밀도)
Rotation: ° 기호가 있는 각도 스핀박스
Crop: 좌 / 우 / 상 / 하 픽셀 스핀박스
Bounding Box: Type 드롭다운(None, Stretch, Scale Inner, …)과 Width / Height 스핀박스
Source Info(읽기 전용): 원본 크기, 현재 계산된 크기
Blend Mode: 합성 모드 드롭다운(Normal, Additive, Subtract, …)

참고: Scenes 섹션에서 임의의 소스에 있는 변형 편집 버튼을 클릭하면 여기서 변형 편집 대상으로 선택됩니다.

Studio Mode 섹션

Studio Mode Status: 상태 표시기와 함께 Enabled / Disabled 표시
Enable / Disable 버튼
Preview Scene: 현재 미리보기 장면 표시(활성화 시)
Set Preview: 미리보기 장면을 선택하는 드롭다운(활성화 시)
Transition 버튼: 미리보기를 프로그램으로 전환(활성화 시)

Transitions 섹션

Current Transition: 상태 표시기와 함께 표시(활성 전환 중 노란색)
Transitioning…: 활성 전환 중 표시되는 상태 행
Type: 전환 종류(Fade, Cut, Stinger, …)
Duration: 편집 가능한 입력이 있는 현재 시간. Cut 등의 고정 전환에서는 비활성화되며 “(fixed)” 레이블이 표시됩니다.
Switch To: 활성 전환을 변경하는 드롭다운

Recording & Streaming 섹션

Recording Status: 녹화 중 타임코드 표시, 상태 표시기(빨간색 = 녹화 중, 노란색 = 일시 정지, 회색 = 정지), Start / Stop / Pause 버튼
Record Directory: 현재 디렉터리 표시(읽기 전용), Browse 버튼(폴더 선택기, 다음 녹화 시 적용), Refresh 버튼(OBS에서 현재 디렉터리 가져오기)
Record Split & Chapters(OBS 30.2+): Split File 버튼(녹화 중 활성화), 챕터 이름 입력(선택 사항), Add Chapter 버튼(Hybrid MP4 전용, 녹화 중 활성화)
Streaming Status: 방송 중 타임코드 표시, 상태 표시기(빨간색 = 방송 중, 회색 = 오프라인), Go Live / End Stream 버튼
Stream Captions: 자막 텍스트 입력, Send 버튼(방송 중 활성화)

Advanced Outputs 섹션 (기본적으로 접혀 있음)

이름으로 커스텀 / 플러그인 출력을 제어하는 파워 유저를 위한 섹션입니다.

Output Selection: 출력 드롭다운(검색된 출력 목록), Refresh 버튼
Output Controls: Start / Stop / Toggle 버튼(출력 선택 시 활성화), Status 버튼
Output Status Display: 선택한 출력 이름, 활성 상태 표시기(Active / Inactive / Reconnecting), 타임코드, 전송 / 기록된 바이트(B/KB/MB/GB), 네트워크 혼잡 비율, 프레임 통계(전달됨 / 전체 / 건너뜀)

가상 카메라 섹션

Status: 상태 표시기와 함께 Active / Inactive 표시
Start / Stop 버튼

Replay Buffer 섹션

Status: 상태 표시기와 함께 Recording / Inactive 표시
Start / Stop / Save 버튼(Save는 버퍼가 활성 상태일 때만 활성화)

Audio Inputs 섹션 (기본적으로 접혀 있음)

Create New Input(접을 수 있음): 대상 장면 드롭다운, 입력 이름 필드, 새로 고침이 있는 입력 종류 드롭다운, 선택적 JSON 설정(접을 수 있음), Enabled 체크박스, Create 버튼(장면, 이름, 종류 필요)
OBS의 모든 오디오 입력 목록, 각 항목에:
- Mute 표시기: 녹색(음소거 해제), 빨간색(음소거), 회색(알 수 없음)
- 인라인 이름 변경: 입력 이름을 더블클릭하여 편집
- 볼륨 표시: 현재 dB 수준
- Remove 버튼: 입력 삭제(확인 필요)
- Mute / Unmute 토글
- 볼륨 슬라이더: 드래그하여 조절(-100 ~ +26 dB)
- Reset: 0 dB로 설정
- Advanced(입력별로 접을 수 있음): Balance(L/R 슬라이더 + 중앙 초기화), Sync Offset(-950 ~ 20000ms + 초기화), Monitor 드롭다운(None / Monitor Only / Monitor and Output), Tracks(1 ~ 6 라우팅용 체크박스 6개)
비활성 소스(어떤 장면에서도 활성화되지 않은 소스)는 흐리게 표시됩니다.

Media Inputs 섹션 (기본적으로 접혀 있음)

모든 미디어 소스(ffmpeg, vlc, 미디어 유형) 목록
입력별 컨트롤: 활동 표시기(임의 장면에서 활성화 여부)와 Play / Pause / Stop / Restart 버튼
비활성 소스는 흐리게 표시

Input Settings 섹션 (기본적으로 접혀 있음)

Input Dropdown: 보거나 편집할 입력 선택
Input Type: 입력 종류(text, browser, image, …)
Refresh Button: OBS에서 최신 설정 가져오기
Dynamic Settings UI: 입력 유형에 따라 변경됨:
- Text Sources: 여러 줄 텍스트 에디터
- Browser Sources: URL 필드, 크기 표시
- Image Sources: 파일 경로 필드
- Media Sources: 파일 경로 필드, 반복 체크박스
- Color Sources: 색상 선택기(클릭하여 열기)
- Other Types: 읽기 전용 JSON 표시
편집 시 변경 사항이 즉시 적용됩니다.

Source Filters 섹션 (기본적으로 접혀 있음)

Source Dropdown: 필터를 보거나 편집할 소스 선택
Refresh Buttons: 필터 목록 또는 사용 가능한 필터 유형 새로 고침
Filter List: 선택한 소스의 모든 필터, 활성화/비활성화 체크박스, 이름 + 읽기 쉬운 유형, 인덱스 위치, 위/아래 이동 버튼, 제거 버튼 포함
Add New Filter: 필터 유형 드롭다운(OBS에서), 이름 입력, Add Filter 버튼

Screenshots 섹션 (기본적으로 접혀 있음)

Status: 상태 표시기와 함께 Ready / Capturing / Success / Error 표시
Source Dropdown: 임의의 장면 또는 입력([Scene] SceneName 또는 [Input] InputName 형식으로 표시)
Format Dropdown: PNG, JPG, WebP, BMP
Quality Slider: 0 ~ 100%(JPG / WebP에서만 표시)
Size: 가로 × 세로 스핀박스(0 = 원본 해상도)
Capture Button: 메모리에 캡처하고 미리보기 표시
Save to File: 파일 경로 입력(OBS 머신의 경로)과 Save 버튼
Preview: 마지막으로 캡처한 스크린샷 표시
Last Saved: 가장 최근에 저장된 파일의 경로

Trigger Volume Details Panel

OBS Trigger Volume 액터를 선택하면, 다음 섹션들이 포함된 단일 커스텀 OBS Trigger Volume 카테고리가 표시됩니다. 트리거 배후의 게임플레이 모델에 대해서는 Trigger Volume 가이드를 참고하세요.

Trigger Shape 섹션

Shape Type: Box 또는 Sphere 드롭다운
Box Extent: 반크기 벡터(박스는 각 방향으로 이 값의 2배 크기), Box에서만 표시
Sphere Radius: 부동소수점, Sphere에서만 표시

Appearance 섹션

Debug Draw: Show in Editor / Show at Runtime, Draw Solid(박스 전용), Line Thickness, Volume Color, Action Label
Styled Mesh: Volume Style(None / Glow / Hologram / Pulse / Custom). Custom 머티리얼 선택기는 Volume Style = Custom일 때만 표시됩니다.

볼륨 스타일링 요약은 Style System을 참고하고, 머티리얼 레시피는 전용 스타일 시스템 문서를 참고하세요.

Trigger Settings 섹션

Trigger Event: OnEnter, OnExit, 또는 Both
Actor Filtering: Actor Class 필터, Specific Actor 참조
Behavior: Cooldown(초), Enabled, One-Shot
Connection(선택 사항): 대상 OBS Component(없으면 글로벌 Subsystem으로 폴백)

Conditions 섹션

모든 조건이 AND 논리로 결합됨을 설명하는 안내 텍스트
Output State: Recording Requirement와 Streaming Requirement, 각각 삼중 상태 드롭다운(Any / Required / Disallowed)
Scene Conditions: Required / Excluded Scene, 실시간 OBS 장면 드롭다운에서 선택
Audio Activity: 입력별 발화 중 / 대기 조건, 입력 선택기와 실시간 발화 점 표시
Source Visibility: 소스별 Visible / Hidden 조건, 장면 + 소스 선택기와 실시간 표시 점 표시

Actions 섹션

On Enter Actions / On Exit Actions: 배열 에디터(Trigger Event에 따라 표시)
각 동작은 실시간 OBS 이름 드롭다운(장면 / 입력 / 소스, 그리고 온디맨드 Filter 및 Hotkey 선택기)을 사용하며, 행 헤더에 {Type}: {target} 요약이 인라인으로 표시됩니다.

Test Controls 섹션

Warning Box: OBS 연결을 사용할 수 없을 때 표시(연결 설정 방법 안내)
Connection Status: 상태 표시기 포함
Conditions Status: 모든 조건이 충족되는지 표시
Refresh 버튼: 상태 재확인
Execute Enter / Exit 버튼: 테스트를 위한 동작 수동 발생

참고: 수동 실행은 조건을 무시합니다(연결 요건 제외).

Style System

위의 모든 섹션은 공유 FOBSDetailsPanelStyle 헬퍼로 구성되어 있으며, 일관된 간격 상수, 상태 색상, 위젯 팩토리(상태 점, 레이블이 있는 행, 값 텍스트, 구분선, 서브섹션 헤더)를 제공합니다. 전체 레퍼런스는 Style System을 참고하세요.