1. 위젯 이미지
2. 위젯설명 (기능 소개)
참여자 순위표 위젯은 방송 중 시청자들이 보낸 실시간 후원 및 매출 데이터를 집계하여, 가장 많이 기여한 상위 랭커들의 순위(리더보드)를 실시간으로 방송 화면에 송출하는 마케팅 오버레이 도구입니다. 정렬 기준(금일/전체 누적) 및 노출 인원수를 유연하게 조정할 수 있으며, 1~3위 랭커 전용 메달 색상 강조, 기여도 점수 연동 및 리모컨식 초기화 기능 등을 제공해 후원 경쟁과 방송 참여 활성화를 효과적으로 유도합니다.
3. 세팅 방법 (설치부터 주요 체크항목)
### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `참여자 순위` 카드에서 **복사 아이콘(📋)**을 클릭하여 순위표 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 순위표 위젯 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 랭킹 데이터 수집 및 정렬 기준 설정
* **조회 기간 제어 (모드 변경)**:
* **금일 랭킹(Daily)**: 오늘 하루 동안 들어온 후원/매출만 계산하여 순위를 갱신합니다. (특정 이벤트 시작일 기준으로 세팅 가능)
* **전체 랭킹(All)**: 현재까지 누적된 모든 데이터베이스 후원 기록을 합산하여 랭킹을 산출합니다.
* **기여도 점수 합산 방식**:
* 단순 후원금 외에 방송 활동 미션 기여도 점수를 랭킹 산정에 가산할 수 있습니다.
* **랭킹 갱신 주기(Interval)**: 실시간 데이터 반영 시간(단위: ms)을 조절합니다. (기본: 10초)
---
### 3. 리더보드 디자인 커스터마이징
* **최고 순위자(1~3위) 색상 강조**:
* 골드(🥇), 실버(🥈), 브론즈(🥉) 메달 컬러를 방송국 분위기에 맞춰 원하는 하이라이트 색상으로 개별 커스텀할 수 있습니다.
* **가독성 디테일 제어**:
* 랭킹 표시 제한 수(예: TOP 5, TOP 10), 글꼴 크기, 행 높이, 투명도 배경색(`row_bg`), 테두리 외곽선 컬러를 방송 스크린에 잘 보이도록 조절하여 가독성을 높입니다.
---
### 4. 핵심 관리 기능 (기여도 초기화 이용 방법)
* **[기여도 데이터 초기화] 기능**:
* 특집 방송, 새로운 엑셀 방송 세션, 주간/월간 랭킹 이벤트가 새로 시작될 때 설정 페이지의 **[기여도 초기화]** 버튼을 누르면 DB에 누적된 기여도 점수 데이터가 원클릭으로 0점으로 깨끗이 지워지며 랭킹이 새롭게 시작됩니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **순위표에 랭커가 한 명도 나오지 않을 때**:
* 대시보드 `후원자 순위` 카드의 상단 스위치가 **[ON]**으로 활성화되어 있는지 가장 먼저 점검해 주세요.
* 데이터 소스에 활성화된 주문/후원 거래 데이터가 있는지 확인합니다.
2. **설정을 바꿨는데 화면에 바로 안 바뀔 때**:
* 랭킹 반영 주기(예: 10초)가 지나면 실시간으로 변경된 스타일이 반영됩니다. 즉각 확인하고 싶다면 OBS 브라우저 소스를 새로고침해 주세요.
* **위젯 링크 복사**: 대시보드의 `참여자 순위` 카드에서 **복사 아이콘(📋)**을 클릭하여 순위표 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 순위표 위젯 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 랭킹 데이터 수집 및 정렬 기준 설정
* **조회 기간 제어 (모드 변경)**:
* **금일 랭킹(Daily)**: 오늘 하루 동안 들어온 후원/매출만 계산하여 순위를 갱신합니다. (특정 이벤트 시작일 기준으로 세팅 가능)
* **전체 랭킹(All)**: 현재까지 누적된 모든 데이터베이스 후원 기록을 합산하여 랭킹을 산출합니다.
* **기여도 점수 합산 방식**:
* 단순 후원금 외에 방송 활동 미션 기여도 점수를 랭킹 산정에 가산할 수 있습니다.
* **랭킹 갱신 주기(Interval)**: 실시간 데이터 반영 시간(단위: ms)을 조절합니다. (기본: 10초)
---
### 3. 리더보드 디자인 커스터마이징
* **최고 순위자(1~3위) 색상 강조**:
* 골드(🥇), 실버(🥈), 브론즈(🥉) 메달 컬러를 방송국 분위기에 맞춰 원하는 하이라이트 색상으로 개별 커스텀할 수 있습니다.
* **가독성 디테일 제어**:
* 랭킹 표시 제한 수(예: TOP 5, TOP 10), 글꼴 크기, 행 높이, 투명도 배경색(`row_bg`), 테두리 외곽선 컬러를 방송 스크린에 잘 보이도록 조절하여 가독성을 높입니다.
---
### 4. 핵심 관리 기능 (기여도 초기화 이용 방법)
* **[기여도 데이터 초기화] 기능**:
* 특집 방송, 새로운 엑셀 방송 세션, 주간/월간 랭킹 이벤트가 새로 시작될 때 설정 페이지의 **[기여도 초기화]** 버튼을 누르면 DB에 누적된 기여도 점수 데이터가 원클릭으로 0점으로 깨끗이 지워지며 랭킹이 새롭게 시작됩니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **순위표에 랭커가 한 명도 나오지 않을 때**:
* 대시보드 `후원자 순위` 카드의 상단 스위치가 **[ON]**으로 활성화되어 있는지 가장 먼저 점검해 주세요.
* 데이터 소스에 활성화된 주문/후원 거래 데이터가 있는지 확인합니다.
2. **설정을 바꿨는데 화면에 바로 안 바뀔 때**:
* 랭킹 반영 주기(예: 10초)가 지나면 실시간으로 변경된 스타일이 반영됩니다. 즉각 확인하고 싶다면 OBS 브라우저 소스를 새로고침해 주세요.