Gift Rank（선물 카운터）

Gift Rank는 실시간 선물 투표 진행 위젯으로, 선물 크라우드펀딩 목표 추적, 선물 챌린지, 다중 선물 진행 비교 등 "시청자가 선물 진행 상황을 직관적으로 확인"할 수 있는 인터랙션에 적합합니다.

레이아웃

Gift Rank의 인터페이스는 다음 2개 영역으로 구성됩니다:

왼쪽은 미리보기 영역으로, 설정 변경 사항이 즉시 미리보기에 반영됩니다.

오른쪽은 설정 영역으로, 타이머 설정, 표시 설정, 선물 관리의 세 가지 섹션이 있습니다.

설정 항목	용도	변경 시기	참고 사항
`끄기`	카운트다운 없음	시간 제한이 필요 없는 경우 (기본값)	-
`10min`	고정 10분 카운트다운	중단거리 인터랙션	-
`30min`	고정 30분 카운트다운	장시간 인터랙션	-
`사용자 지정`	초 단위 직접 입력	비표준 시간이 필요한 경우	최소 `10`초

카운트다운과 조작의 관계

카운트다운은 카운터가 '실행 중' 상태일 때만 감소합니다. 일시정지 또는 초기화 시 카운트다운도 일시정지되거나 초기값으로 돌아갑니다.

카운트다운이 0이 되면 카운터가 자동으로 종료되며 더 이상 누적되지 않습니다.

어떤 선물의 카운트가 해당 목표값에 도달했을 때 카운터가 자동으로 실행할 동작을 설정합니다.

옵션	의미
`카운트 중지`	목표 달성 후 해당 선물의 카운트 누적 중지
`계속 카운트`	목표 달성 후 누적을 계속하며, 카운트는 목표를 초과할 수 있음
`카운터 재설정`	목표 달성 후 카운터 재설정
`목표 증가`	목표 달성 후 자동으로 목표값을 올려 챌린지 연장
`목표 2배 증가`	목표 달성 후 자동으로 목표값을 2배로
`숨기기`	목표 달성 후 위젯에서 해당 선물 숨기기

실행 중에는 수정할 수 없습니다

카운터가 실행 중인 상태에서는 이 설정을 수정할 수 없습니다. 조정하려면 먼저 초기화 하세요.

설정 항목	용도	변경 시기	참고 사항
`진행 표시`	진행 바의 텍스트 형식 선택	-	세 가지 모드：`값+퍼센트`（예：50/100（50%））、`값만`（예：50/100）、`퍼센트만`（예：50%）
`선물 이름 표시`	위젯에 각 선물의 사용자 지정 이름 표시	선물이 많아 시청자가 구분해야 할 때	끄면 컴팩트 레이아웃으로 전환되어 공간이 절약됩니다
`선물 가치 표시`	위젯에 선물의 다이아몬드 가치 표시	-	-
`기여 랭킹 표시`	위젯 하단에 총 진행 상황과 기여 상위 3명의 아바타 표시	시청자 경쟁을 유도하고 싶을 때	-

설정 항목	용도	변경 시기	참고 사항
`선물 아이콘`	클릭하여 해당 행의 선물 변경	-	카운트 데이터가 있는 선물 변경 시 확인 필요
`선물 이름`	선물의 사용자 지정 표시 이름 설정（`선물 이름 표시` 활성화 시에만 표시）	-	포커스를 잃으면 자동 저장
`현재 / 목표`	이 선물의 현재 누적값과 목표값 표시	-	클릭하여 수동 조정 가능（아래 참조）
`표시 / 숨김`	이 선물을 위젯에 표시할지 제어	일시적으로 위젯에 표시하지 않으려 할 때	숨겨도 카운트는 계속 누적됩니다
`삭제`	이 선물 행 삭제	-	삭제 전 확인 대화상자가 나타납니다
`드래그 정렬`	왼쪽 `::` 핸들을 드래그하여 위젯 내 표시 순서 조정	-	동시에 하나의 드래그 조작만 가능
`선물 추가`	새 선물 행 추가	-	최대 `8`개 선물, 동일한 선물 중복 선택 불가

최대 8개 선물

각 카운터에 최대 8개의 선물을 설정할 수 있습니다. 더 많은 선물을 추적하려면 여러 프리셋으로 나누어 사용하세요.

방송 도구에서의 조작

Copy URL로 선물 카운터 링크를 복사하여 방송 도구에 로드하세요.

모든 설정 변경（선물 추가/삭제, 순서 변경, 목표값 수정 등）은 실시간으로 위젯에 동기화되며, 링크를 다시 복사할 필요가 없습니다.