Streamlabs Desktop
Macro Deck에 포함Streamlabs Desktop에서 장면을 전환하고 방송, 녹화, 오디오 소스를 제어하세요.
API 토큰 필드가 있는 Streamlabs Desktop 연결 대화 상자
- 장면 전환과 스튜디오 모드 트랜지션
- 방송, 녹화, 리플레이 버퍼 시작과 중지
- 오디오 소스 음소거와 볼륨 설정
- 장면의 소스 표시, 숨기기, 뒤집기, 회전, 맞추기
- 방송 및 녹화 상태와 시간에 대한 실시간 변수
Streamlabs Desktop 연동은 원격 제어 API를 통해 Macro Deck을 Streamlabs Desktop(구 Streamlabs OBS)에 연결합니다. Streamlabs Desktop이 보여 주는 API 토큰으로 연결하면, 그때부터 버튼으로 장면, 소스, 오디오, 출력을 제어할 수 있습니다.
할 수 있는 일
- 활성 장면을 전환하고, 스튜디오 모드를 켜거나 끄고, 스튜디오 모드 미리 보기를 라이브 출력으로 트랜지션합니다.
- 방송, 녹화, 리플레이 버퍼를 시작, 중지 또는 전환하고, 리플레이를 저장합니다.
- 장면의 소스를 표시하거나, 숨기거나, 전환합니다.
- 오디오 소스를 음소거하거나, 음소거를 해제하거나, 전환하고, 볼륨을 설정하거나 단계별로 높이고 낮춥니다.
- 소스에 변환을 실행합니다. 변환 초기화, 가로 또는 세로 뒤집기, 화면에 맞추기, 늘이기, 가운데 정렬, 회전이 가능합니다.
- 오디오 소스의 볼륨이나 음소거 상태, 또는 소스의 표시 여부를 변수로 읽습니다.
활용 예:
- BRB 장면으로 전환하고 마이크를 음소거하는 BRB 버튼.
- 리플레이 버퍼를 저장하는 클립 저장 버튼.
- 방송을 전환하고 라이브 중인지 보여 주는 방송 시작 버튼.
- 스트리밍 시작됨에서 실행되어 웹캠 소스를 표시하는 흐름.
동작 방식
Macro Deck은 Streamlabs Desktop이 보내는 이벤트를 수신하므로 장면, 방송, 녹화, 리플레이 버퍼, 스튜디오 모드 변수가 Streamlabs Desktop에서 하는 작업을 따라갑니다. 트리거는 장면이 바뀔 때, 방송이나 녹화가 시작, 중지되거나 상태가 바뀔 때, 리플레이 버퍼가 시작하거나 멈출 때, 스튜디오 모드가 바뀔 때, 소스가 음소거되거나 표시되거나 숨겨질 때 실행됩니다.
이 연동은 구성을 하나만 가집니다. 기본적으로 같은 컴퓨터의 Streamlabs Desktop에 연결합니다. 설정의 고급 설정에서 다른 컴퓨터의 주소를 입력할 수 있습니다. Streamlabs Desktop이 닫히면 Macro Deck은 계속 다시 연결을 시도합니다. Streamlabs Desktop에서 새 토큰을 생성하면 연동 페이지에 Streamlabs Desktop이 API 토큰을 거부했습니다가 표시되며, 새 토큰으로 설정을 다시 실행하면 됩니다.
준비물
- Windows, macOS 또는 Linux의 Macro Deck 3
- 이 컴퓨터나 같은 네트워크의 다른 컴퓨터에서 실행 중인 Streamlabs Desktop
- Streamlabs Desktop에서 켠 원격 제어와 그 API 토큰
설정하기
1단계: Streamlabs Desktop에서 API 토큰 찾기
Streamlabs Desktop에서 Settings를 열고 Remote Control을 여세요. 새 버전에서는 Mobile, Third Party Connections 아래에 있으며, 그곳에서 켜야 합니다. QR 코드를 클릭하고 show details를 선택해 API 토큰을 표시한 다음 복사하세요.
2단계: Macro Deck에서 Streamlabs Desktop 열기
Macro Deck의 사이드바에서 연동을 클릭하고 Streamlabs Desktop을 클릭하세요. 개요 탭의 구성 섹션에서 설정을 클릭하세요. 오른쪽 위의 스위치를 켜도 같은 대화 상자가 열리며, 설정을 마치면 연동이 켜집니다.
3단계: API 토큰 붙여 넣기
Streamlabs Desktop 연결 대화 상자에서 토큰을 API 토큰에 붙여 넣으세요.
Streamlabs Desktop이 다른 컴퓨터에서 실행 중이면 고급 설정을 켜고 그 컴퓨터의 IP 주소를 주소에 입력하세요. 포트가
59650과 다르다는 것을 알고 있지 않다면 포트는 비워 두세요. 계속을 클릭하세요. Macro Deck은 연결을 저장하기 전에 테스트합니다.4단계: 버튼에 Streamlabs Desktop 액션 추가
덱 페이지에서 사용할 버튼을 클릭하세요. 덱의 잠금이 해제되어 있어야 하며, 오른쪽 위 버튼에 잠금이라고 표시되어 있으면 해제된 상태입니다. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 Streamlabs Desktop을 선택한 다음 장면 설정 같은 액션을 고르세요. 장면을 선택한 다음 저장을 클릭하세요.
5단계: 버튼 누르기
스마트폰, 태블릿 또는 웹 클라이언트에서 버튼을 누르세요. Streamlabs Desktop이 그 장면으로 전환됩니다. 아무 일도 일어나지 않으면 Streamlabs Desktop이 실행 중인지, 연동 아래 Streamlabs Desktop 페이지에서 구성이 연결됨으로 표시되는지 확인하세요.
액션19
버튼에 넣거나 흐름에서 실행하세요.
- 장면 설정
- 활성 장면을 전환합니다.
- 스트림 시작
- 아직 라이브 중이 아니면 방송을 시작합니다.
- 스트림 중지
- 라이브 중이면 방송을 중지합니다.
- 스트리밍 전환
- 방송을 시작하거나 중지합니다.
- 녹화 시작
- 아직 녹화 중이 아니면 녹화를 시작합니다.
- 녹화 중지
- 현재 녹화를 중지합니다.
- 녹화 전환
- 녹화를 시작하거나 중지합니다.
- 리플레이 버퍼 시작
- 리플레이 버퍼를 시작합니다.
- 리플레이 버퍼 중지
- 리플레이 버퍼를 중지합니다.
- 리플레이 버퍼 전환
- 리플레이 버퍼를 시작하거나 중지합니다.
- 리플레이 저장
- 현재 리플레이 버퍼를 디스크에 저장합니다.
- 소스 표시 설정
- 장면의 소스를 표시하거나, 숨기거나, 전환합니다.
- 소스 표시 상태 가져오기
- 소스가 표시되는지 여부를 변수로 읽습니다.
- 오디오 소스 음소거
- 오디오 소스를 음소거하거나, 음소거를 해제하거나, 전환합니다.
- 오디오 볼륨 설정
- 오디오 소스의 볼륨을 설정하거나 높이거나 낮춥니다.
- 오디오 소스 상태 가져오기
- 오디오 소스의 볼륨이나 음소거 상태를 변수로 읽습니다.
- 장면 항목 액션
- 장면의 소스를 초기화, 뒤집기, 맞추기, 늘이기, 가운데 정렬 또는 회전합니다.
- 스튜디오 모드 전환
- 스튜디오 모드를 켜거나 끕니다.
- 스튜디오 모드 전환
- 스튜디오 모드 미리 보기를 라이브 출력으로 트랜지션합니다.
트리거14
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- 장면 변경됨
- 활성 장면이 바뀌었습니다. 특정 장면으로 한정할 수도 있습니다.
- 스트리밍 시작됨
- Streamlabs Desktop이 방송을 시작했습니다.
- 스트리밍 중지됨
- Streamlabs Desktop이 방송을 중지했습니다.
- 스트리밍 상태 변경됨
- 방송이 오프라인, 시작 중, 라이브, 종료 중, 다시 연결 중 사이에서 바뀌었습니다.
- 녹화 시작됨
- Streamlabs Desktop이 녹화를 시작했습니다.
- 녹화 중지됨
- Streamlabs Desktop이 녹화를 중지했습니다.
- 녹화 상태 변경됨
- 녹화가 오프라인, 시작 중, 녹화 중, 중지 중 사이에서 바뀌었습니다.
- 리플레이 버퍼 시작됨
- 리플레이 버퍼가 시작되었습니다.
- 리플레이 버퍼 중지됨
- 리플레이 버퍼가 중지되었습니다.
- 스튜디오 모드 변경됨
- 스튜디오 모드가 켜지거나 꺼졌습니다.
- 소스 음소거 변경됨
- 오디오 소스가 음소거되었거나 음소거가 해제되었습니다.
- 소스 표시 변경됨
- 장면에서 소스가 표시되었거나 숨겨졌습니다.
- 연결됨
- Macro Deck이 Streamlabs Desktop에 연결되었습니다.
- 연결 끊김
- Streamlabs Desktop과의 연결이 끊어졌습니다.
변수7
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
streamlabs_is_connected- Macro Deck이 Streamlabs Desktop에 연결되어 있는지 여부입니다.
streamlabs_current_scene- 활성 장면입니다.
streamlabs_scene_count- 장면의 개수입니다.
streamlabs_is_streaming,streamlabs_streaming_status,streamlabs_streaming_seconds- 방송 중인지 여부, 스트림 상태, 스트림이 진행된 시간입니다.
streamlabs_is_recording,streamlabs_recording_status,streamlabs_recording_seconds- 녹화 중인지 여부, 녹화 상태, 녹화가 진행된 시간입니다.
streamlabs_replay_buffer_active,streamlabs_replay_buffer_status- 리플레이 버퍼가 실행 중인지 여부와 그 상태입니다.
streamlabs_studio_mode_active- 스튜디오 모드가 켜져 있는지 여부입니다.
자주 묻는 질문
Streamlabs Desktop이 다른 컴퓨터에서 실행 중이어도 동작하나요?
네. 설정 중에 고급 설정을 켜고 그 컴퓨터의 IP 주소를 주소에 입력하세요. 포트 59650이 그 컴퓨터의 방화벽을 통과할 수 있어야 합니다.
Streamlabs Desktop이 API 토큰을 거부했습니다. 어떻게 해야 하나요?
Streamlabs Desktop에서 토큰이 다시 생성되었거나 원격 제어가 꺼졌습니다. 원격 제어를 켜고 현재 토큰을 표시한 다음 그 토큰으로 설정을 다시 실행하세요.
Streamlabs Desktop이 닫히면 어떻게 되나요?
Macro Deck은 계속 다시 연결을 시도하며, Streamlabs Desktop이 실행되면 다시 연결됩니다. 그때까지 액션은 Streamlabs Desktop이 연결되어 있지 않습니다. 메시지와 함께 실패합니다.
볼륨은 데시벨 단위인가요?
아니요. 오디오 볼륨 설정은 데시벨 값이 아니라 Streamlabs Desktop에 표시되는 페이더 위치(퍼센트)를 사용합니다.
API 토큰은 어디에 저장되나요?
Macro Deck은 토큰을 Macro Deck이 실행 중인 컴퓨터에 암호화하여 저장하며 Streamlabs Desktop에 연결할 때만 사용합니다.
스트리밍의 다른 연동
OBS Studio
Macro Deck에 포함장면을 전환하고, 방송·녹화·오디오를 제어하고, OBS Studio에서 일어나는 일에 반응하세요.
Meld Studio
Macro Deck에 포함Meld Studio에서 장면을 전환하고 준비하며, 레이어, 효과, 오디오 트랙을 제어하고, 라이브를 시작하세요.
Streamer.bot
Macro Deck에 포함Streamer.bot 액션을 실행하고, 채팅 메시지를 보내고, Streamer.bot이 보고하는 모든 이벤트에 반응하세요.
Twitch
Macro Deck에 포함Twitch 채팅과 방송 통계를 표시하고, 채팅을 관리하고, 투표와 광고를 실행하고, 팔로우·구독·레이드에 반응하세요.
YouTube
Macro Deck에 포함YouTube 실시간 채팅과 방송 통계를 표시하고, 제목과 태그를 바꾸고, 슈퍼 챗과 멤버에 반응하세요.