Streamer.bot
Macro Deck에 포함Streamer.bot 액션을 실행하고, 채팅 메시지를 보내고, Streamer.bot이 보고하는 모든 이벤트에 반응하세요.
주소, 포트, 엔드포인트, 비밀번호가 있는 Streamer.bot 연결 대화 상자
- 인수와 함께 어떤 Streamer.bot 액션이든 실행
- 사용자 지정 코드 트리거 실행
- Twitch, YouTube, Trovo, Kick으로 채팅 메시지 보내기
- Streamer.bot이 보고하는 모든 이벤트에 반응
- Streamer.bot 전역 변수를 Macro Deck으로 읽기
Streamer.bot 연동은 Macro Deck을 Streamer.bot의 WebSocket 서버에 연결합니다. 버튼으로 Streamer.bot에서 만든 액션을 시작할 수 있고, Streamer.bot이 보고하는 모든 것(채팅 메시지, 팔로우, 구독, 레이드, 채널 포인트 사용, 타이머, 사용자 지정 코드 이벤트)으로 Macro Deck의 흐름을 시작할 수 있습니다.
할 수 있는 일
- Streamer.bot 액션을 실행합니다. 내 액션 목록에서 고르고 선택적으로 인수를 전달하면, 액션은 이를
%key%로 읽습니다. - 사용자 지정 코드 트리거를 실행합니다. 이때도 인수를 선택적으로 전달할 수 있습니다.
- Streamer.bot을 통해 Twitch, YouTube, Trovo, Kick으로 방송자 계정이나 봇 계정으로 채팅 메시지를 보냅니다. 메시지에는 Macro Deck 변수와 이벤트 값을 넣을 수 있습니다.
- 영구 저장되거나 세션에만 유지되는 Streamer.bot 전역 변수를 Macro Deck 변수로 읽습니다.
- Streamer.bot 이벤트 트리거로 어떤 Streamer.bot 이벤트에든 반응합니다. 범위를 좁히려면 Twitch 같은 소스와 이벤트를 고르고, 모든 것에 반응하려면 둘 다 비워 두세요. 흐름은 사용자, 메시지, 원본 이벤트 데이터를 JSON으로 받습니다.
활용 예:
- Streamer.bot 액션을 실행하면서 장면 이름을 인수로 전달하는 장면: 게임 버튼.
- 채팅 메시지 보내기 액션 두 개로 같은 알림을 Twitch와 YouTube에 올리는 수분 보충 버튼.
- Streamer.bot의 Twitch 팔로우 이벤트에서 실행되어 Macro Deck에 알림을 표시하는 흐름.
- Streamer.bot 전역 변수에서 카운터를 읽어 라벨로 표시하는 버튼.
동작 방식
Macro Deck은 Streamer.bot에 계속 연결된 상태로 이벤트가 발생하는 즉시 받습니다. 변수는 연결 여부, Streamer.bot 버전, 인스턴스 이름, 방송자의 이름과 플랫폼을 보여 줍니다. Streamer.bot이 닫히거나 WebSocket 서버가 멈추면 Macro Deck은 계속 다시 연결을 시도하며, 연결됨 및 연결 끊김 트리거로 흐름이 반응할 수 있습니다. 이 연동은 구성을 하나만 가집니다.
준비물
- Windows, macOS 또는 Linux의 Macro Deck 3
- 이 컴퓨터나 같은 네트워크의 다른 컴퓨터에서 실행 중인 Streamer.bot
- Streamer.bot의 Servers/Clients > WebSocket Server에서 시작한 WebSocket 서버
설정하기
1단계: Streamer.bot에서 WebSocket 서버 시작
Streamer.bot에서 Servers/Clients > WebSocket Server를 열고 서버가 시작되어 있는지 확인하세요. 주소, 포트, 엔드포인트를 적어 두고, 인증을 켰다면 비밀번호도 적어 두세요.
2단계: Macro Deck에서 Streamer.bot 열기
Macro Deck의 사이드바에서 연동을 클릭하고 Streamer.bot을 클릭하세요. 개요 탭의 구성 섹션에서 설정을 클릭하세요. 오른쪽 위의 스위치를 켜도 같은 대화 상자가 열리며, 설정을 마치면 연동이 켜집니다.
3단계: 연결 정보 입력
Streamer.bot 연결 대화 상자를 채우세요.
- 주소: Streamer.bot이 같은 컴퓨터에서 실행 중이면
127.0.0.1, 아니면 그 컴퓨터의 IP 주소. - 포트: WebSocket 서버 포트, 기본값은
8080. - 엔드포인트: 서버가 수신하는 경로, 기본값은
/. - 비밀번호: Streamer.bot에서 인증을 켠 경우에만.
계속을 클릭하세요. Macro Deck은 연결을 저장하기 전에 테스트합니다.
- 주소: Streamer.bot이 같은 컴퓨터에서 실행 중이면
4단계: 버튼에 Streamer.bot 액션 추가
덱 페이지에서 사용할 버튼을 클릭하세요. 덱의 잠금이 해제되어 있어야 하며, 오른쪽 위 버튼에 잠금이라고 표시되어 있으면 해제된 상태입니다. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 Streamer.bot을 선택한 다음 액션 실행을 고르세요. 액션에서 Streamer.bot 액션을 선택하고, 필요하면 인수를 추가하세요. 그런 다음 저장을 클릭하세요.
5단계: 버튼 누르기
스마트폰, 태블릿 또는 웹 클라이언트에서 버튼을 누르세요. Streamer.bot이 액션을 실행합니다. 아무 일도 일어나지 않으면 Streamer.bot의 WebSocket 서버가 시작되어 있는지, 연동 아래 Streamer.bot 페이지에서 구성이 연결됨으로 표시되는지 확인하세요.
액션4
버튼에 넣거나 흐름에서 실행하세요.
- 액션 실행
- Streamer.bot 액션을 실행하며, 인수를 선택적으로 전달할 수 있습니다.
- 코드 트리거 실행
- Streamer.bot 사용자 지정 코드 트리거를 실행하며, 인수를 선택적으로 전달할 수 있습니다.
- 채팅 메시지 보내기
- Streamer.bot을 통해 Twitch, YouTube, Trovo, Kick으로 채팅 메시지를 보냅니다.
- 전역 변수 가져오기
- Streamer.bot 전역 변수를 Macro Deck 변수로 읽습니다.
트리거3
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- Streamer.bot 이벤트
- 채팅 메시지, 팔로우, 구독, 레이드, 채널 포인트 사용, 타이머, 사용자 지정 코드 이벤트처럼 Streamer.bot이 보고하는 모든 것입니다. 소스와 이벤트로 범위를 좁힐 수 있습니다.
- 연결됨
- Macro Deck이 Streamer.bot에 연결되었습니다.
- 연결 끊김
- Streamer.bot과의 연결이 끊어졌습니다.
변수5
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
streamerbot_is_connected- Macro Deck이 Streamer.bot에 연결되어 있는지 여부입니다.
streamerbot_version- Streamer.bot 버전입니다.
streamerbot_instance_name- Streamer.bot 인스턴스의 이름입니다.
streamerbot_broadcaster_name- Streamer.bot의 방송자 계정입니다.
streamerbot_broadcaster_platform- 방송자 계정의 플랫폼입니다.
자주 묻는 질문
Streamer.bot이 다른 컴퓨터에서 실행 중이어도 동작하나요?
네. 그 컴퓨터의 IP 주소를 주소에 입력하세요. Streamer.bot의 WebSocket 서버는 다른 컴퓨터가 접근할 수 있는 주소에서 수신해야 하며, 그 컴퓨터의 방화벽에서 포트가 열려 있어야 합니다.
비밀번호가 필요한가요?
Streamer.bot에서 WebSocket 서버의 인증을 켠 경우에만 필요합니다. Macro Deck은 비밀번호를 Macro Deck이 실행 중인 컴퓨터에 암호화하여 저장합니다.
Streamer.bot 액션에 값을 전달하려면 어떻게 하나요?
액션 실행이나 코드 트리거 실행의 인수에 추가하세요. 각 키는 Streamer.bot에서 %key%로 사용할 수 있습니다.
Streamer.bot이 닫히면 어떻게 되나요?
Macro Deck은 계속 다시 연결을 시도하며, WebSocket 서버가 돌아오면 다시 연결됩니다. 그때까지 액션은 Streamer.bot이 연결되어 있지 않습니다. 메시지와 함께 실패합니다.
전역 변수 가져오기에서 변수가 없다고 나오는 이유는 무엇인가요?
이름을 확인하고, Streamer.bot에서 변수가 영구 저장되어 있는지 확인하세요. 현재 세션에서만 유지되는 변수를 읽으려면 액션에서 저장된 값 사용을 끄세요.
스트리밍의 다른 연동
OBS Studio
Macro Deck에 포함장면을 전환하고, 방송·녹화·오디오를 제어하고, OBS Studio에서 일어나는 일에 반응하세요.
Meld Studio
Macro Deck에 포함Meld Studio에서 장면을 전환하고 준비하며, 레이어, 효과, 오디오 트랙을 제어하고, 라이브를 시작하세요.
Streamlabs Desktop
Macro Deck에 포함Streamlabs Desktop에서 장면을 전환하고 방송, 녹화, 오디오 소스를 제어하세요.
Twitch
Macro Deck에 포함Twitch 채팅과 방송 통계를 표시하고, 채팅을 관리하고, 투표와 광고를 실행하고, 팔로우·구독·레이드에 반응하세요.
YouTube
Macro Deck에 포함YouTube 실시간 채팅과 방송 통계를 표시하고, 제목과 태그를 바꾸고, 슈퍼 챗과 멤버에 반응하세요.