사용 가이드

🚀 시작하기

가입하고 후원 페이지와 위젯을 준비하는 기본 흐름이에요.

1. 가입 & 프로필 설정

회원가입(이메일 또는 구글 로그인) → 대시보드 접속
프로필 설정에서 방송명·소개·후원 목표 입력
방송 플랫폼(치지직/유튜브/SOOP/트위치)과 채널을 등록 — 채팅·후원 통합에 사용돼요

2. 후원 페이지 링크 공유

대시보드 → 후원 내역 섹션의 후원 페이지 URL(donate.html?to=핸들)을 방송 프로필·공지·유튜브 설명란에 넣으면 시청자가 바로 후원할 수 있어요.

3. OBS에 위젯 넣기 (공통)

대시보드 → 위젯 섹션에서 원하는 위젯의 URL 복사
OBS → 소스 추가 → 브라우저 → URL 붙여넣기 → 너비/높이 설정
여러 위젯(알림·목표·채팅 등)은 각각 별도 브라우저 소스로 추가

💡 위젯 URL엔 본인 인증 토큰이 들어있어요. 남에게 공유하지 마세요.

🔔 후원 알림 종류

시청자가 후원 페이지에서 고르는 후원 방식이에요. 모두 통합 알림창 위젯 하나에서 표시됩니다. 자동

종류	설명
💬 일반	닉네임·금액·메시지가 알림 카드로 표시
🔊 음성(TTS)	메시지를 음성으로 읽어줌 (OBS 브라우저 소스에서 소리 재생)
🎬 영상	후원자가 넣은 유튜브 영상이 알림과 함께 재생
🖼️ 이미지 / 🎨 그림	이미지 URL 또는 후원자가 직접 그린 그림 표시
❓ 퀴즈	메시지에 문제를 넣어 채팅 참여 유도
✏️ 미니	최소 100원 가벼운 텍스트 후원(음성 없음)
🎰 룰렛 / 🎁 럭키박스	결제 후 서버가 무작위 결과 추첨(연출용, 정산액엔 영향 없음)
⚔️ 퀘스트 / 🎮 플레이	미션 응원 / 화면 가득 터지는 참여형 효과
🏷️ 스티커	화면 원하는 위치에 스티커 팝업
✨ 시그니처	화면 전체를 채우는 5~7초 프리미엄 연출
🎵 노래신청	곡을 신청 → 노래신청 위젯 대기열에 등록 (아래 참고)

💡 룰렛·럭키박스·플레이 항목 구성은 대시보드 → 간편설정에서 편집할 수 있어요.

📺 방송 위젯 (OBS)

대시보드 → 위젯 섹션에서 각 URL을 복사해 OBS 브라우저 소스로 넣으세요. 자동

위젯 종류

위젯	표시 내용
통합 알림창	모든 후원 알림(위 종류 전부)이 여기서 표시 — 필수 위젯
후원 목표	목표 금액 대비 누적 진행률 바
누적 후원	전체 누적 후원 금액(전 출처 합산)
후원자 랭킹	이번 달 후원자 TOP 5
실시간 투표 / 미션 진행바	진행 중인 투표 집계 / 미션 누적·달성률
엑셀 방송	대시보드에서 편집한 스코어보드 표를 실시간 표시
노래신청 / 타이머	신청곡 대기열 / 방송 카운트다운
채팅 오버레이	방송 플랫폼 채팅을 화면에 표시

🎨 위젯 외형 설정

대시보드 → 위젯 → 각 위젯의 설정 버튼에서 크기·위치·스타일(기본/미니멀/강조/투명)을 저장하면, 목표·누적·랭킹·투표·미션·엑셀방송·노래신청·타이머 위젯에 바로 적용돼요.

💡 통합 알림창의 위치는 OBS에서 소스를 직접 옮겨 조절하세요(알림 애니메이션 보호를 위해 외형설정은 모드 위젯에만 적용됩니다).

🎮 리모컨

방송 중 알림을 손으로 제어해요. 자동

대시보드 → 리모컨 섹션 또는 remote.html?handle=핸들(폰에서 열기)에서:

일시정지 / 재개 — 알림 큐를 멈추거나 다시 흐르게
스킵 — 현재 재생 중인 알림 건너뛰기
대기열 비우기 — 밀린 알림 삭제
볼륨 — TTS·영상 소리 조절
테스트 재생 — 알림이 잘 뜨는지 미리 확인(실집계엔 반영 안 됨)

💡 리모컨과 대시보드의 일시정지 상태는 실제 위젯 상태와 실시간으로 동기화돼요.

🔗 외부 후원 통합

다른 플랫폼 후원을 유네이션 위젯 하나로 합쳐서 표시해요. 대시보드 → 외부 후원 통합에서 설정.

치지직 · 유튜브 · SOOP 자동

채널 ID/핸들/아이디만 등록하면 치즈·슈퍼챗·별풍선 후원을 실시간으로 직접 수집해 위젯에 표시합니다. (라이브 검증됨)

투네이션 설정필요

본인의 투네이션 알림위젯 키를 등록하면 실시간 수집돼요. 단 투네이션 비공식 연결이라 투네이션 구조 변경 시 끊길 수 있어요(베스트에포트).

펀네이션 · 위플랩 일부

실시간 자동 수집은 아직 미지원이에요. ① 웹훅으로 밀어넣거나 ② 과거 누적 기준값(이미 쌓인 총액)을 한 번 입력해 총 누적에 합산할 수 있어요.

합산 vs 정산

누적·목표·랭킹 표시는 전 출처(유네이션+투네이션+치지직+…)를 모두 합산해서 나와요. 단 실제 정산(출금)은 유네이션 자체 후원만 대상이에요(다른 플랫폼 돈은 해당 플랫폼에서 정산 — 이중 정산 방지).

🏦 계좌후원 자동 인식

폰에 오는 은행 입금 문자를 위젯에 자동 표시해요. 안드로이드 필요

설정 방법 (안드로이드 · MacroDroid)

Play스토어에서 MacroDroid(무료) 설치 → SMS 권한 허용
은행 앱에서 입금 알림(문자/푸시) 켜기
MacroDroid 매크로 추가 → 트리거: 수신 SMS(내용에 "입금" 포함 권장)
동작: HTTP 요청 · POST · URL = 대시보드의 웹훅 URL
헤더: Authorization: Bearer (연동키) · 본문: {"text":"[sms_message]"}
저장·활성화 → 소액 입금 테스트로 위젯에 뜨면 완료

💡 국민·신한·하나·우리·카카오뱅크·토스뱅크 문자 형식을 지원해요. 아이폰은 문자 자동전달 제한으로 미지원(안드로이드 폰에서 설정).

💜 팔로우 · 구독 알림

팔로우/구독 이벤트를 통합 알림창에 표시해요.

유튜브 멤버십 자동 — 유튜브 채널을 외부연동에 등록하면 라이브 채팅의 멤버십 가입/선물을 자동 감지해 알림으로 표시.

그 외 플랫폼 웹훅 — 대시보드 → 위젯의 팔로우·구독 알림 카드의 웹훅 주소로 봇/릴레이가 이벤트를 쏘면 알림이 떠요. (구독/팔로우 테스트 버튼으로 미리보기 가능)

💡 팔로우/구독 알림은 후원 금액엔 반영되지 않아요(알림만).

🗳️ 실시간 투표

시청자와 실시간으로 투표해요. 대시보드 → 위젯 → 투표 관리. 자동

투표 제목·선택지(2~8개) 입력 → 필요하면 "로그인한 계정만 투표" 체크(계정당 1표, 우회 방지)
투표 시작 → 후원 페이지·투표 위젯에 실시간 표시
시청자 투표는 1인 1표(재클릭 무시, 선택 변경 가능), 유효표(참여자 수)도 집계
종료 후 기록 보기에서 결과·최다득표·유효표 확인, CSV 내보내기·이미지 저장 가능

🎵 노래신청 (신청곡)

시청자가 후원하며 곡을 신청하고, 스트리머가 대기열로 관리해요.

시청자: 후원 페이지에서 🎵 노래신청 선택 → 곡 제목(+유튜브 링크) 입력 후 후원
스트리머: 대시보드 → 위젯 → 노래신청 카드에서 대기열 확인 / 다음 곡 재생 / 특정 곡 재생 / 비우기
OBS: 노래신청 위젯 URL로 지금 재생곡 + 대기목록 표시. URL 끝에 &audio=1을 붙이면 유튜브 링크가 있는 곡의 오디오까지 자동재생

⏱️ 타이머 (방송 시간연장)

후원할 때마다 방송 시간이 늘어나는 카운트다운이에요. 자동

대시보드 → 위젯 → 타이머 카드에서 리셋(분) → 시작
1,000원당 N초 추가 설정 → 후원이 들어오면 자동으로 시간 연장
수동으로 +5분·일시정지·리셋도 가능
OBS: 타이머 위젯 URL로 라이브 카운트다운 표시

💬 채팅 오버레이

방송 채팅을 화면에 표시해요. 자동

프로필에 방송 플랫폼 + 채널을 등록하면, 채팅 위젯이 그 플랫폼(치지직·유튜브·SOOP·트위치) 채팅을 실시간으로 표시해요.

동시송출 중이라면 통합 채팅으로 여러 플랫폼 채팅을 한 창에 합쳐서 볼 수 있어요. 대시보드 → 위젯 → 채팅 오버레이 → 동시송출 통합 채팅에 채널을 넣으면 URL이 자동으로 만들어집니다(최대 4개). 각 줄에 어느 플랫폼에서 온 메시지인지 배지가 붙어요.

💡 플랫폼별로 채팅창을 따로 띄우고 싶다면 기존처럼 ?mode=chat&platform=플랫폼&channel=채널로 위젯을 여러 개 넣으면 됩니다.

🛍️ 스토어 & 💰 정산

굿즈/디지털 상품 판매와 후원금 정산이에요.

스토어

대시보드 → 스토어에서 상품(이름·가격·재고) 등록 → 후원 페이지에서 시청자가 구매. 주문 내역은 대시보드에서 확인해요.

정산

대시보드 → 정산에서 정산 가능 금액 확인 후 요청. 플랫폼 수수료 3%가 차감돼요. 정산 대상은 유네이션 자체 후원 + 스토어 매출이에요.

⚠️ 현재는 테스트(모의) 결제 모드라 실제 청구·정산은 실 PG 연동 후 적용돼요.

전체 기능 사용 가이드