Twitch
Macro Deck에 포함Twitch 채팅과 방송 통계를 표시하고, 채팅을 관리하고, 투표와 광고를 실행하고, 팔로우·구독·레이드에 반응하세요.
Twitch 채팅 위젯과 시청자, 채팅 참여자, 팔로워를 보여 주는 Twitch 방송 통계 위젯
- Twitch 채팅 및 Twitch 방송 통계 위젯
- 제목과 카테고리 설정, 광고 실행, 레이드 시작, 클립 만들기
- 버튼으로 투표, 예측, 샤웃아웃, 채팅 모드
- 팔로우, 구독, 응원, 레이드, 포인트 사용에 대한 트리거
- 여러 Twitch 계정 연결
Twitch 연동은 하나 이상의 Twitch 계정을 Macro Deck에 연결합니다. 짧은 코드로 Twitch에 로그인하면, Macro Deck이 채널의 이벤트를 발생하는 즉시 받고 그 계정으로 채널에서 작업할 수 있습니다.
할 수 있는 일
- 방송 제목, 카테고리, 태그를 바꾸고, 채팅 메시지와 공지를 보내고, 샤웃아웃을 합니다.
- 광고 시간을 실행하거나 다음 광고를 미루고, 레이드를 시작하거나 취소하고, 클립이나 스트림 마커를 만듭니다.
- 투표와 예측을 시작하고 끝내며, 채널 포인트 사용을 완료 또는 환불로 처리합니다.
- 채팅 관리: 사용자를 차단하거나 타임아웃하고, 차단을 해제하고, 메시지를 삭제하고, 채팅을 지우고, 이모티콘 전용, 팔로워 전용, 저속, 구독자 전용, 고유 채팅 모드를 켜거나 끕니다.
- Twitch 채팅 위젯에 이모티콘과 배지가 포함된 채팅을 표시하고, 그 위젯에서 채팅을 관리합니다.
- Twitch 방송 통계 위젯에 방송 상태, 시청자, 채팅 참여자, 팔로워와 구독자, 제목, 카테고리, 방송 시간을 표시합니다.
활용 예:
- 제목과 카테고리를 설정하고 공지를 보내는 곧 시작 버튼.
- 90초 광고를 실행하는 광고 시간 버튼.
- 클립을 만들고 그 편집 URL을 변수에 쓰는 클립 버튼.
- 특정 보상에 대한 채널 포인트 보상 사용에서 실행되어 OBS 장면을 전환하는 흐름.
- 레이드 받음에서 실행되어 레이드한 사람에게 샤웃아웃을 하는 흐름.
동작 방식
Macro Deck은 연결된 계정마다 Twitch 이벤트를 구독하므로 새 팔로워, 응원, 레이드 받음 같은 트리거가 몇 초 안에 실행됩니다. 시청자 수 같은 방송 값은 30초마다 Twitch에서 읽어 옵니다. 모든 값은 twitch_<account>_<value> 형식의 변수로 제공되므로(예: twitch_mychannel_viewer_count) 직접 만든 위젯과 조건에서 사용할 수 있습니다.
Twitch 계정을 여러 개 연결할 수 있습니다. 모든 액션에는 계정 필드가 있고, 모든 트리거를 한 계정으로 한정할 수 있습니다. Twitch가 Macro Deck이 요청한 권한을 모두 주지 않으면 연동에 실행되지 않을 이벤트가 나열되고 다시 연결하도록 안내합니다. Twitch와의 연결이 끊기면 Macro Deck이 스스로 다시 연결합니다. 계정을 30일 동안 Macro Deck에서 사용하지 않거나 Twitch에서 접근 권한을 취소하면 로그인이 만료되고, 연동에서 계정을 다시 연결하라고 안내합니다.
준비물
- 인터넷에 연결된 Windows, macOS 또는 Linux의 Macro Deck 3
- Twitch 계정
- 광고 실행에는 방송 중인 제휴 또는 파트너 채널이 필요함
- 클립과 스트림 마커는 채널이 방송 중일 때만 동작함
설정하기
1단계: Macro Deck에서 Twitch 열기
Macro Deck의 사이드바에서 연동을 클릭하고 Twitch를 클릭하세요. 개요 탭의 구성 섹션에서 구성 추가를 클릭하세요. 오른쪽 위의 스위치를 켜도 같은 대화 상자가 열리며, 설정을 마치면 연동이 켜집니다.
2단계: Twitch에서 접근 승인
Twitch 계정 연결 대화 상자에 기기 코드가 표시됩니다. Twitch를 열고 승인을 클릭하면 코드가 이미 입력된 상태로 브라우저에서 Twitch가 열립니다. 연결하려는 계정으로 로그인하고 접근을 승인하세요.
직접 등록한 Twitch 애플리케이션을 사용하려면 고급 설정을 켜고 **자체 클라이언트 ID(고급)**에 그 클라이언트 ID를 입력하세요. Macro Deck의 기본 애플리케이션을 사용하려면 이 필드를 비워 두세요.
3단계: 설정 마치기
Macro Deck으로 돌아와 계속을 클릭하세요. Macro Deck은 계정 이름을 따라 구성 이름을 정합니다. 예: Twitch (mychannel). 대화 상자에 **설정이 완료되었습니다.**가 표시되면 완료를 클릭하세요.
4단계: 버튼에 Twitch 액션 추가
덱 페이지에서 사용할 버튼을 클릭하세요. 덱의 잠금이 해제되어 있어야 하며, 오른쪽 위 버튼에 잠금이라고 표시되어 있으면 해제된 상태입니다. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 Twitch를 선택한 다음 채팅 메시지 보내기 같은 액션을 고르세요. 계정을 고르고 메시지를 입력한 다음 저장을 클릭하세요.
5단계: 버튼 누르기
스마트폰, 태블릿 또는 웹 클라이언트에서 버튼을 누르세요. Twitch 채팅에 메시지가 나타납니다. 덱에서 채팅을 보려면 Twitch 채팅 위젯을 추가하세요.
액션20
버튼에 넣거나 흐름에서 실행하세요.
- 제목과 카테고리 설정
- 방송 제목, 카테고리 또는 태그를 바꿉니다. 비워 둔 필드는 건드리지 않습니다.
- 채팅 메시지 보내기
- 연결된 계정으로 채널 채팅에 메시지를 보내며, 답장으로 보낼 수도 있습니다.
- 공지 보내기
- 고른 색으로 강조된 공지를 채팅에 게시합니다.
- 쇼아웃 보내기
- 다른 채널에 샤웃아웃을 합니다. Twitch는 2분에 한 번만 허용합니다.
- 채팅 지우기
- 채널 채팅의 모든 메시지를 지웁니다.
- 채팅 메시지 삭제
- 채팅에서 메시지 하나를 삭제합니다.
- 채팅 모드 설정
- 이모티콘 전용, 팔로워 전용, 저속, 구독자 전용, 고유 채팅 모드를 켜거나 끄거나 전환합니다.
- 광고 실행
- 30초에서 3분까지의 광고 시간을 시작합니다.
- 다음 광고 미루기
- 예정된 다음 광고 시간을 5분 뒤로 미룹니다.
- 레이드 시작
- 채널의 시청자를 다른 채널로 보냅니다.
- 레이드 취소
- 아직 진행되지 않은 레이드를 멈춥니다.
- 클립 만들기
- 방송의 마지막 30초를 클립으로 만들고, 클립의 편집 URL을 변수에 쓸 수 있습니다.
- 스트림 마커 만들기
- 나중에 편집할 수 있도록 방송의 현재 지점을 표시합니다.
- 사용자 차단 또는 타임아웃
- 시청자를 차단하거나, 기간을 지정하면 타임아웃합니다.
- 사용자 차단 해제
- 차단이나 타임아웃을 해제합니다.
- 투표 만들기
- 선택지가 2~5개인 투표를 시작합니다.
- 투표 종료
- 진행 중인 투표를 끝냅니다.
- 예측 만들기
- 결과가 2~10개인 채널 포인트 예측을 시작합니다.
- 예측 종료
- 진행 중인 예측을 확정하거나, 잠그거나, 취소합니다.
- 보상 사용 처리
- 채널 포인트 사용을 완료로 표시하거나 환불합니다(같은 Twitch 애플리케이션이 만든 보상만 가능).
트리거39
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- 방송 시작
- 채널이 방송을 시작했습니다.
- 방송 종료
- 채널이 방송을 멈췄습니다.
- 채널 정보 업데이트됨
- 제목, 카테고리, 언어 또는 콘텐츠 라벨이 바뀌었습니다.
- 광고 휴식 시작됨
- 채널에서 광고 시간이 시작되었습니다.
- 새 팔로워
- 누군가 채널을 팔로우했습니다.
- 새 구독
- 누군가 채널을 구독했습니다. 특정 등급으로 한정할 수도 있습니다.
- 재구독
- 누군가 채팅에서 재구독을 알렸습니다.
- 구독 선물
- 누군가 채널에 구독을 선물했습니다.
- 구독 종료
- 채널 구독이 만료되었습니다.
- 응원
- 누군가 채널에서 비트로 응원했습니다.
- 레이드 받음
- 다른 채널이 이 채널로 레이드했습니다.
- 레이드 보냄
- 이 채널이 다른 채널로 레이드했습니다.
- 샤웃아웃 받음
- 다른 채널이 이 채널에 샤웃아웃을 했습니다.
- 샤웃아웃 보냄
- 채널이 샤웃아웃을 보냈습니다.
- 채널 포인트 보상 사용
- 시청자가 채널 포인트 보상을 사용했습니다. 특정 보상으로 한정할 수도 있습니다.
- 자동 보상 사용됨
- 시청자가 Twitch에 내장된 채널 포인트 보상 중 하나를 사용했습니다.
- 사용 처리됨
- 채널 포인트 사용이 수락되었거나 환불되었습니다.
- 투표 시작
- 채널에서 투표가 시작되었습니다.
- 투표 종료
- 채널의 투표가 끝났습니다.
- 예측 시작
- 채널에서 예측이 시작되었습니다.
- 예측 잠김
- 예측이 더 이상 참여를 받지 않습니다.
- 예측 종료
- 예측이 확정되었거나 취소되었습니다.
- 하이프 트레인 시작
- 채널에서 하이프 트레인이 시작되었습니다.
- 하이프 트레인 진행
- 채널의 하이프 트레인이 진행되었습니다.
- 하이프 트레인 종료
- 채널의 하이프 트레인이 끝났습니다.
- 목표 시작
- 크리에이터 목표가 시작되었습니다.
- 목표 진행
- 크리에이터 목표가 진행되었습니다.
- 목표 종료
- 크리에이터 목표가 끝났습니다.
- 채팅 알림
- 채팅의 구독, 재구독, 선물, 레이드, 공지, 자선 알림. 특정 종류로 한정할 수도 있습니다.
- 채팅 지워짐
- 채널 채팅이 지워졌습니다.
- 채팅 메시지 삭제됨
- 채팅 메시지 하나가 삭제되었습니다.
- 채팅 모드 변경됨
- 이모티콘 전용, 팔로워 전용, 저속, 구독자 전용, 고유 채팅 모드가 전환되었습니다.
- 사용자 차단 또는 타임아웃됨
- 시청자가 차단되었거나 타임아웃되었습니다.
- 사용자 차단 해제
- 시청자의 차단이 해제되었습니다.
- VIP 추가
- 시청자가 VIP 자격을 받았습니다.
- VIP 제거
- 시청자가 VIP 자격을 잃었습니다.
- Twitch 이벤트(고급)
- Macro Deck이 아직 다루지 않는 이벤트를 포함한 모든 Twitch 이벤트를 원본 페이로드와 함께 제공합니다.
- 연결됨
- Macro Deck이 계정을 Twitch에 연결했습니다.
- 연결 끊김
- Twitch와의 연결이 끊어졌습니다.
변수10
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
twitch_<account>_is_connected- 계정이 Twitch에 연결되어 있는지 여부입니다.
twitch_<account>_is_live- 채널이 라이브 중인지 여부입니다.
twitch_<account>_stream_title,twitch_<account>_stream_category- 현재 방송 제목과 카테고리입니다.
twitch_<account>_viewer_count,twitch_<account>_uptime_seconds- 시청자 수와 방송이 진행된 시간(초)입니다.
twitch_<account>_follower_count,twitch_<account>_subscriber_count,twitch_<account>_subscriber_points- 채널의 팔로워 수, 구독자 수, 구독 포인트 합계입니다.
twitch_<account>_chatter_count- 본인과 봇을 포함해 채팅에 있는 모든 사람의 수입니다.
twitch_<account>_stream_thumbnail_url- 현재 방송 썸네일의 URL입니다.
twitch_<account>_display_name,twitch_<account>_login- 계정의 표시 이름과 로그인 이름입니다.
twitch_<account>_emote_only,twitch_<account>_followers_only,twitch_<account>_followers_only_duration,twitch_<account>_slow_mode,twitch_<account>_slow_mode_wait_time,twitch_<account>_subscriber_only,twitch_<account>_unique_chat- 채팅 모드입니다: 이모티콘 전용, 팔로워 전용과 그 기간(분), 슬로 모드와 대기 시간(초), 구독자 전용, 고유 채팅.
twitch_<account>_last_follower,twitch_<account>_last_subscriber,twitch_<account>_last_cheerer,twitch_<account>_last_raider- 가장 최근의 팔로워, 구독자, 응원한 사람, 레이드한 사람입니다.
위젯2
위젯 선택기에서 덱에 추가하세요.
- Twitch 채팅
- 이모티콘과 배지가 포함된 채널 채팅을 표시합니다. 누르면 메시지 삭제, 타임아웃, 차단을 할 수 있는 더 큰 채팅이 열립니다.
- Twitch 방송 통계
- 방송 상태, 시청자, 채팅 참여자, 팔로워와 구독자, 제목, 카테고리, 방송 시간을 고른 스타일로 표시합니다.
자주 묻는 질문
Twitch 계정을 여러 개 연결할 수 있나요?
네. 구성 추가를 다시 클릭하고 다른 계정으로 승인하세요. 각 액션에는 계정 필드가 있고, 변수에는 계정 이름이 붙습니다. 예: twitch_mychannel_is_live.
왜 다시 로그인해야 하나요?
Twitch는 30일 동안 사용하지 않거나 Twitch에서 Macro Deck의 접근 권한을 취소하면 로그인을 끝냅니다. 그러면 연동에 로그인이 만료되었다고 표시됩니다. 다시 연결로 접근을 다시 승인하세요.
액션이 실패하는 이유는 무엇인가요?
많은 액션은 특정 상황에서만 동작합니다. 클립 만들기와 스트림 마커 만들기는 채널이 방송 중이어야 하고, 광고 실행은 방송 중인 제휴 또는 파트너 채널이 필요하며, 쇼아웃 보내기는 2분에 한 번만 동작합니다. Twitch가 권한을 주지 않았다면 계정을 다시 연결해 권한을 허용하세요.
기존 보상의 사용을 처리할 수 없는 이유는 무엇인가요?
Twitch는 애플리케이션이 직접 만든 보상의 사용만 처리하도록 허용합니다. Twitch 대시보드에서 만든 보상은 API로 처리할 수 없습니다.
채팅 위젯에서 누가 채팅을 관리할 수 있나요?
덱을 사용할 수 있는 사람이라면 누구나 가능합니다. 채팅을 표시만 하려면 위젯 설정에서 채팅 대화상자에서 관리 허용을 끄세요.
Twitch 토큰은 어디에 저장되나요?
Macro Deck은 액세스 토큰과 갱신 토큰을 Macro Deck이 실행 중인 컴퓨터에 암호화하여 저장합니다. Twitch 비밀번호는 Macro Deck에 입력하지 않으며, Twitch에서 직접 접근을 승인합니다.
스트리밍의 다른 연동
OBS Studio
Macro Deck에 포함장면을 전환하고, 방송·녹화·오디오를 제어하고, OBS Studio에서 일어나는 일에 반응하세요.
Meld Studio
Macro Deck에 포함Meld Studio에서 장면을 전환하고 준비하며, 레이어, 효과, 오디오 트랙을 제어하고, 라이브를 시작하세요.
Streamlabs Desktop
Macro Deck에 포함Streamlabs Desktop에서 장면을 전환하고 방송, 녹화, 오디오 소스를 제어하세요.
Streamer.bot
Macro Deck에 포함Streamer.bot 액션을 실행하고, 채팅 메시지를 보내고, Streamer.bot이 보고하는 모든 이벤트에 반응하세요.
YouTube
Macro Deck에 포함YouTube 실시간 채팅과 방송 통계를 표시하고, 제목과 태그를 바꾸고, 슈퍼 챗과 멤버에 반응하세요.