Skip to content

Desuq Cafe

문서 메뉴

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

개요

Unreal Engine 5.4 이상을 위한 완전한 기능의 OBS WebSocket 클라이언트 플러그인으로, Unreal Editor에서 직접, 그리고 런타임 환경에서 OBS Studio를 실시간으로 제어할 수 있습니다. 외부 스크립팅 없이 인게임 이벤트, 게임플레이 트리거, 또는 Sequencer 타임라인에서 OBS를 구동하는 스트리머, VTuber, 버추얼 프로덕션 워크플로우를 위해 제작되었습니다.

OBS를 제어하는 다양한 방법

방법사용 사례
OBS Component손쉬운 Blueprint 통합을 위해 모든 액터에 추가
OBS Trigger Volume액터가 특정 영역에 진입하거나 벗어날 때 OBS 동작을 자동으로 트리거
Sequencer TrackLevel 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 명령을 효율적으로 전송합니다.

다음 단계

  • 설치: 플러그인을 설치하고 OBS WebSocket 서버를 활성화합니다.
  • 빠른 시작: 몇 분 안에 OBS를 제어하기 시작하는 네 가지 방법.