개요
Unreal Engine 5.4 이상을 위한 완전한 기능의 OBS WebSocket 클라이언트 플러그인으로, Unreal Editor에서 직접, 그리고 런타임 환경에서 OBS Studio를 실시간으로 제어할 수 있습니다. 외부 스크립팅 없이 인게임 이벤트, 게임플레이 트리거, 또는 Sequencer 타임라인에서 OBS를 구동하는 스트리머, VTuber, 버추얼 프로덕션 워크플로우를 위해 제작되었습니다.
OBS를 제어하는 다양한 방법
| 방법 | 사용 사례 |
|---|---|
| OBS Component | 손쉬운 Blueprint 통합을 위해 모든 액터에 추가 |
| OBS Trigger Volume | 액터가 특정 영역에 진입하거나 벗어날 때 OBS 동작을 자동으로 트리거 |
| Sequencer Track | Level Sequence에 동기화된 타임라인 기반 OBS 제어 |
| Game Subsystem | 게임 코드 어디서나 전역으로 접근 가능 |
| Editor Subsystem | 플레이 모드에 진입하지 않고도 에디터에서 OBS 제어 |
완전한 OBS 제어
- Sequencer 통합 - 타임라인 기반 OBS 제어:
- Event Trigger Track - 40가지 이상의 개별 동작 (녹화, 방송, 장면 전환 등)
- Keyframeable Tracks - 볼륨, 밸런스, 변형, 색상, 필터 설정, 전환 시간, 미디어 커서를 위한 부드러운 보간
- Continuous State Tracks - 섹션 동안 상태 유지 (음소거, 표시 여부, 잠금, 블렌드 모드, 필터 활성화, 스튜디오 모드, 전환)
- Media Sync Track - Sequencer 타임라인에 OBS 미디어 재생을 동기화
- 애니메이션 이전 상태 복원, 동작 배치 처리, 33ms 스로틀링
- 설정 - 장면 모음, 프로필, 비디오 설정 (해상도, FPS)
- 장면 - 장면 전환, 소스 표시/숨기기, 장면 목록 조회
- 장면 항목 - 추가, 제거, 복제, 잠금/잠금 해제, 순서 변경 (z 순서), 블렌드 모드
- 장면 항목 변형 - 위치, 스케일, 회전, 자르기, 바운딩 박스 제어
- 스튜디오 모드 - 라이브 전환 전 장면 미리보기, 스튜디오 전환
- 전환 - 장면 전환 변경, 시간 설정, 전환 진행 상태 모니터링
- 필터 - 소스 필터 추가, 제거, 활성화/비활성화, 순서 변경
- 스크린샷 - 임의의 소스에서 메모리 또는 파일로 스크린샷 캡처, 크기 조정 옵션 포함
- 녹화 - 시작, 중지, 일시 정지, 재개, 녹화 분할, 챕터 마커 추가, 녹화 디렉터리 설정
- 방송 - 상태 모니터링과 함께 방송 시작 및 중지
- 가상 카메라 - 가상 카메라 출력 시작 및 중지
- Replay Buffer - 인스턴트 리플레이 시작, 중지, 저장
- 일반 출력 제어 - 이름으로 임의의 출력 시작, 중지, 토글 (커스텀/플러그인 출력용)
- 방송 자막 - 방송 중 CEA-608 클로즈드 캡션 전송
- 오디오 - 임의의 입력에 대해 음소거, 음소거 해제, 볼륨, 밸런스, 동기화 오프셋, 모니터링 유형, 트랙 라우팅 조정
- 입력 관리 - 입력 (소스) 생성, 제거, 이름 변경
- 입력 설정 - 소스의 텍스트, URL, 파일 경로, 색상 구성
- 미디어 소스 - 미디어 입력 재생, 일시 정지, 중지, 탐색
- 자동 재연결 - 연결이 끊겼을 때 지수 백오프를 사용한 자동 재연결
풍부한 에디터 통합
- 실시간 상태 표시기를 포함한 커스텀 디테일 패널
- 최소화된 컴포넌트 / 기능 선택기: 패널 상단의 카드 그리드에서 필요한 기능 도메인만 선택합니다. 선택되지 않은 도메인은 숨겨지며, 대량 이벤트 스트림이 구독되지 않습니다. 연결은 항상 활성 상태입니다. 기본 선택값 (장면 + 녹화 및 방송)으로 시작하며, 전체 활성화 및 초기화 기능이 있습니다.
- 마스킹 처리된 (표시/숨기기) 비밀번호 필드가 있는, 항상 펼쳐진 두드러진 연결 카드
- 확장 가능한 소스 목록이 있는 장면 브라우저
- 볼륨 조정이 포함된 오디오 입력 컨트롤
- 원클릭 녹화/방송 컨트롤
- 플레이 모드에 진입하지 않고도 동작하는 테스트 컨트롤
- 공유 스타일 시스템을 통한 일관된 스타일링
Take Recorder 통합 (실험적)
| 기능 | 설명 |
|---|---|
| 자동 녹화 시작/중지 | Take Recorder 시작/중지에 OBS 녹화가 동기화됨 |
| 챕터 마커 | Take Recorder의 마크된 프레임이 OBS 챕터가 됨 |
| 가상 카메라 동기화 | 테이크와 OBS 가상 카메라를 선택적으로 동기화 |
| 장면 전환 | 테이크 시작/중지 시 특정 OBS 장면으로 전환 |
| 포스트롤 | Take Recorder가 중지된 후 N초 동안 OBS 녹화를 계속 실행 |
| 파일 연관 | 테이크 에셋 경로와 함께 OBS 파일 경로를 기록 |
효율적인 요청 배치 처리
구성 가능한 실행 모드를 사용하여 단일 네트워크 요청으로 여러 OBS 명령을 효율적으로 전송합니다.