본문으로 건너뛰기

3. 플랫폼 API 노드와 잇기

이 단계에서 할 일: 방송 플랫폼의 채팅·후원 수신 노드를 MARS 이벤트 입력 노드에 연결해서, 실제 채팅 !Throw로 리액션이 실행되게 합니다.

준비물​

  • 2단계까지 끝낸 씬 (규칙 Throw 활성)
  • 쓰는 플랫폼의 연동 플러그인과 로그인
    • 치지직: 창작마당 CHZZK 플러그인
    • SOOP: 창작마당 SOOP 플러그인
    • 트위치: Warudo 기본 기능 (Settings → Twitch에서 연결)

따라 하기​

  1. 블루프린트 탭에서 **+**로 새 블루프린트를 만들고 이름을 플랫폼 → MARS로 짓습니다. 리액션 블루프린트와 따로 두는 것이 관리하기 쉽습니다.
  2. 플랫폼 수신 노드를 놓습니다. 예: 치지직이면 치지직 채팅 수신.
  3. Moraecat 카테고리에서 MARS 이벤트 입력 노드를 놓습니다.
  4. MARS 이벤트 입력의 이벤트 유형을 고릅니다. 채팅 노드에 연결하면 채팅, 후원 노드면 후원. 이벤트 유형을 바꾸면 아래 칸 이름이 그 유형에 맞게 바뀝니다. (예: 후원 → 금액 · 메시지 · 후원 종류, 구독 → 개월 수 · 메시지 · 티어)
  5. 아래 표대로 선을 잇습니다. 흐름 출력(→ 모양)은 실행에, 데이터는 같은 뜻의 칸에 연결합니다. 없는 칸은 비워 둬도 됩니다.
  6. 씬을 저장합니다.
치지직 채팅 수신CHZZK 플러그인
MARS 이벤트 입력이벤트 유형: 채팅

이벤트마다 MARS 이벤트 입력을 하나씩 둡니다. 채팅과 후원을 모두 쓰면 이벤트 입력 노드도 두 개입니다.

치지직 (CHZZK 플러그인)​

수신 노드MARS 이벤트 유형수신 노드 출력 → MARS 이벤트 입력
치지직 채팅 수신채팅Exit → 실행 · Nickname → 닉네임 · SenderChannelId → 사용자 ID · Content → 메시지
치지직 후원 수신후원Exit → 실행 · DonatorNickname → 닉네임 · DonatorChannelId → 사용자 ID · PayAmount → 금액 · DonationText → 메시지 · DonationType → 후원 종류
치지직 구독 수신구독Exit → 실행 · SubscriberNickname → 닉네임 · SubscriberChannelId → 사용자 ID · Month → 개월 수 · TierName → 티어

SOOP (SOOP 플러그인)​

수신 노드MARS 이벤트 유형수신 노드 출력 → MARS 이벤트 입력
SOOP 채팅 메시지채팅Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · Message → 메시지
SOOP 별풍선 선물후원Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · Count → 금액 (별풍선 개수)
SOOP 연속 구독구독Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · SubscriptionMonths → 개월 수
SOOP 구독구독Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID
별풍선은 개수로 들어옵니다

SOOP 별풍선의 Count는 원화가 아니라 별풍선 개수입니다. 규칙의 금액 조건도 개수로 적습니다. (예: 별풍선 10개 → 기준 금액 10)

트위치 (Warudo 기본)​

수신 노드MARS 이벤트 유형수신 노드 출력 → MARS 이벤트 입력
트위치 채널 메시지를 받았을 때채팅Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · Message → 메시지
Twitch 비트를 받았을 때후원Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · BitsUsed → 금액 · Message → 메시지
Twitch 구독을 받았을 때구독Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · CumulativeMonths → 개월 수 · Message → 메시지
Twitch 채널포인트를 받았을 때채널 포인트Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · RewardCost → 포인트 · UserInput → 시청자 글 · RewardTitle → 보상 이름
트위치 채널 팔로우를 받았을 때팔로우Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID
Twitch 레이드를 받았을 때레이드Exit → 실행 · RaiderDisplayName → 닉네임 · RaiderUsername → 사용자 ID · RaiderViewerCount → 시청자 수

트위치 노드 설명은 Warudo 노드 레퍼런스에도 있습니다.

포트 이름이 다르게 보이면

표의 영어 이름은 플러그인이 내부에서 쓰는 포트 이름입니다. Warudo 언어나 플러그인 버전에 따라 노드 위에는 한국어 이름으로 보일 수 있습니다. 위에서 아래 순서는 같습니다.

방송 없이 확인하기​

실제 채팅 없이도 확인할 수 있습니다.

  • 치지직: 치지직 수신 테스트 노드의 테스트 버튼으로 가짜 채팅·후원을 보낼 수 있습니다. 내용에 !Throw를 넣고 눌러 보세요.
  • 공통: 키를 눌렀을 때 노드를 MARS 이벤트 입력의 실행에 잇고, 이벤트 입력의 이벤트 유형을 채팅, 메시지를 !Throw로 직접 적은 뒤 그 키를 누릅니다.

MARS 이벤트 입력의 성공은 "요청을 받았다"는 뜻입니다(리액션이 끝났다는 뜻이 아닙니다). 거절로 나가면 노드의 최근 오류와 허브 MARS 실행 상태의 최근 알림을 확인하세요.

됐는지 확인​

  • 방송 채팅(또는 테스트)으로 !Throw를 보내면 고양이가 날아옵니다.
  • !throw(소문자)나 !Throw!는 실행되지 않습니다. 규칙이 정확히 일치로 되어 있기 때문입니다.
  • 허브 MARS 실행 상태에서 실행 중·대기 수가 바뀌었다가 0으로 돌아옵니다.

다음 단계: 4. 내 리액션을 MARS 호환으로 만들기