| # | 영역 | 필드 | 타입 | 옵션 값 / 제약사항 | 입력 예시 |
|---|
| 1 | 듀얼 영상 | 영상 컴포지션 | embed × 2(좌/우, readonly) | 유튜브 iframe·SOOP embed 등 플랫폼별 공식 임베드를 나란히 배치(임베드형 확정). 각자 방송 중인 플랫폼을 시스템이 자동 인식해 배치, 레이아웃은 좌우 분할 고정(추후 PIP 등 옵션 확장 가능). 치지직은 공식 임베드 미지원이라 대상에서 제외되며, 한쪽이 치지직 전용이면 배틀 신청 자체가 막힘(BTL-08/WM-11) — 배틀 허브에서 신청 단계 차단 | 좌: SOOP, 우: YouTube |
| 2 | 승부 게이지 | 진영별 비율 | readonly(자동 계산) — 2색 progress bar | 옵션. donations 테이블에서 battle_sessions.started_at~ended_at 구간의 진영별 합산 금액으로 실시간 계산, 0~100% 정규화. 사용 설정한 경우에만 노출, 별도 OBS URL로 제공 | 나 62% / 상대 38% |
| 3 | 진행 콘솔 | 남은 시간 | countdown(readonly) | 신청 시 설정한 5~60분 값 기준, 초 단위 갱신 | "24:12" |
| 3 | 진행 콘솔 | 조기 종료 | button | 클릭 시 확인 모달 → 세션 즉시 종료(status: active→ended). 조기 종료 정책(편측 요청만으로 가능한지 상호 동의가 필요한지)은 미결정 — 우선 편측 가능으로 가정 | "⏹ 조기 종료" 클릭 |
| 4 | 듀얼 영상 URL | 오버레이 URL | readonly + 복사/열기 | 배틀 세션 고유 URL — 세션 종료 시 자동으로 대기 화면 전환, 필수(끌 수 없음) | https://…/battle/dual |
| 5 | 승부 게이지 URL | 사용 여부 | toggle | 기본 OFF, 크리에이터가 개별 등록·on/off(위젯 라이브러리와 동일 패턴). 상대방과 무관하게 각자 독립 설정 | ON(예시 화면) |
| 5 | 승부 게이지 URL | 오버레이 URL | readonly + 복사/열기 | OFF 상태에서는 이 URL의 오버레이가 빈 화면으로 렌더링 | https://…/battle/gauge |
| — | 배틀 종료 연출 | 종료 화면 | 텍스트 + 효과(readonly, 세션 종료 시 자동 표시) | 승부 게이지 사용 시 최종 비율 기준 승자 표시(예: 컨페티 효과), 미사용 시 단순 "배틀 종료" 메시지만 노출 | "크리에이터A 승리! 🎉" |