User Guide

### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `주문알림` 카드에서 **복사 아이콘(📋)**을 클릭하여 알림 화면 전용 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
  1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
  2. 복사한 주문알림 위젯 URL을 붙여넣습니다.
  3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.

---

### 2. 위젯 스타일 템플릿 선택 및 연출 효과 (핵심)
설정 페이지의 **[위젯 스타일 템플릿]** 메뉴에서 방송 분위기에 가장 잘 어울리는 리액션 연출 방식을 선택합니다.

* **기존 방식 (일반 - `default`)**:
  * 표준적이고 깔끔한 형태의 기본 메시지 팝업창입니다. 정보를 차분하고 심플하게 전달할 때 적합합니다.
* **텍스트 강조 & 카운트업 (`sparkle`)**:
  * 후원 메시지와 핵심 텍스트를 화면 가득 크게 돋보이도록 연출합니다.
  * 후원 포인트나 주문 금액 수치가 **0원부터 실시간으로 올라가는 다이내믹 숫자 카운트업(Count-Up) 애니메이션 효과**가 적용되어 후원의 생동감을 더합니다.
* **이미지 배경 & 카운트업 (`sparkle_img`)**:
  * 획득한 포인트 카드나 구매한 시그니처 상품 이미지를 알림창의 주 메인 비주얼로 강조합니다.
  * 마찬가지로 **숫자 카운트업 특수 효과**가 동작하여 판매된 상품과 매출 상승을 축제 분위기로 화려하게 부각시킵니다.

---

### 3. 알림 발생 조건 및 레이아웃 제어
* **알림 트리거 선택**:
  * **포인트 획득 알림 / 주문 알림**: 시청자가 상품을 구매하여 매출이 발생하거나 포인트를 획득할 때 알림이 터집니다. (자주 사용하지 않는 신규 회원 알림 등은 비활성화 가능)
* **지속 시간 제어**: 알림이 화면에 부드럽게 나타났다가 유지되는 시간(1000ms = 1초)을 설정합니다. (기본: 5초)

---

### 4. 다른 위젯 자동 숨김 제어 (스마트 연출)
* **알림 발생 시 자동 숨김 위젯 설정**:
  * 주문 알림이 송출되는 동안 화면에 켜져 있는 다른 슬라이더나 BGM 등 번잡한 위젯들을 일시적으로 **자동 숨김(Hide)** 시킬 수 있습니다. 알림이 끝나면 원래대로 자연스럽게 복구됩니다.

---

### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **주문이 들어왔는데 알림이 나타나지 않을 때**: 대시보드 `주문알림` 카드의 상단 스위치가 **[ON]**으로 정상 켜져 있는지 확인해 주세요.
2. **숫자 카운트업 연출 속도를 갱신하고 싶을 때**: 설정 저장 후 OBS 브라우저 소스를 마우스 우클릭하여 **[새로고침]**을 실행해 캐시를 갱신합니다.