OBS Studio

OBS Studio 연동은 OBS에 내장된 WebSocket 서버(obs-websocket 5)를 통해 Macro Deck을 OBS에 연결합니다. 연결되면 방송 중에 OBS에서 하는 거의 모든 작업을 버튼으로 제어할 수 있고, OBS가 바뀐 내용을 알려 주므로 덱은 항상 현재 상태를 보여 줍니다.

할 수 있는 일

• 프로그램 장면, 스튜디오 모드 미리 보기 장면, 프로필 또는 장면 컬렉션을 전환합니다.
• 방송, 녹화, 리플레이 버퍼, 가상 카메라를 시작, 중지 또는 전환하고, 리플레이를 저장하고, 녹화를 일시 정지하고, 녹화 파일을 나누거나 챕터 마커를 추가합니다.
• 장면의 소스를 표시하거나 숨기고, 필터를 켜거나 끄고, 입력을 음소거하거나 볼륨을 퍼센트나 dB로 바꿉니다.
• 소스의 설정을 바꿉니다. 예를 들어 텍스트 소스의 텍스트, 이미지 또는 미디어 소스의 파일, 브라우저 소스의 URL을 바꿀 수 있습니다.
• 플러그인이 추가한 출력을 포함해 어떤 OBS 출력이든 이름으로 시작하고 중지합니다.

활용 예:

• BRB 장면으로 전환하고 마이크를 음소거하는 BRB 버튼.
• 녹화를 전환하고 OBS가 녹화 중인지, 일시 정지되었는지, 정지되었는지 보여 주는 녹화 버튼.
• 음악 입력의 obs_<input>_volume 변수에 연결되어, 움직이면 OBS의 볼륨이 바뀌는 슬라이더.
• OBS가 스트리밍 시작됨을 알리면 실행되어 알림을 보내는 흐름.

동작 방식

Macro Deck은 OBS가 보내는 이벤트를 수신하므로 현재 장면, 음소거 상태, 필터 상태 같은 변수는 OBS에서 바꾼 뒤 1초도 안 되어 업데이트됩니다. 토글 버튼은 상태가 활성인 동안 켜지며, OBS 자체에서 바꾼 경우에도 마찬가지입니다. FPS, CPU 사용량, 비트레이트, 드롭된 프레임 같은 통계는 1~2초마다 읽어 옵니다.

고정 변수 외에도 변수 선택기에는 연결된 OBS의 각 입력, 장면, 장면 항목, 필터가 볼륨, 음소거 상태, 표시 여부, 활성 상태와 함께 나열됩니다. 트리거는 장면 변경, 녹화 및 방송 변경, 저장된 리플레이와 스크린샷, 활성화된 입력, 직접 만든 OBS 스크립트가 브로드캐스트하는 사용자 지정 이벤트에 반응합니다.

구성을 여러 개 추가할 수 있습니다. 예를 들어 방송용 PC와 게임용 PC에 하나씩 둘 수 있습니다. 각 구성은 고유한 변수 세트를 가지며, 모든 액션에는 제어할 OBS를 고르는 구성 필드가 있습니다. OBS가 닫히거나 네트워크가 끊기면 Macro Deck은 계속 다시 연결을 시도하고 연결 끊김 및 연결됨 트리거를 실행합니다.