Files
music_quiz/docs/05-game-flow.md

100 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 05. 게임 진행
## 큰 흐름
```
대기실 ─(방장 시작)→ 출제 목록 뽑기 → [문제 준비 → 문제 진행 → 정답 공개] × N → 결과
```
### 1) 출제 목록 뽑기
- 방 설정(모드·장르·연도·난이도·가수)에 맞는 곡을 DB에서 고른다. 유튜브 주소가 확인된 곡만(가사 모드는 가사가 있는 곡만)
- 같은 게임 안에서 중복 없음, 같은 방에서 최근 3게임에 나온 곡은 뒤로 미룬다
- 같은 가수가 연달아 나오지 않게 섞는다(가수노래 맞추기 모드 제외)
- 문제 수 "무제한"이면 조건에 맞는 곡을 모두 출제. 이어풀기·불러오기면 이미 나온 곡은 빼고 뽑는다
- 조건에 맞는 곡이 문제 수보다 적으면 시작 전에 "조건에 맞는 곡이 N곡뿐이에요"라고 알려주고 그대로 시작/설정 변경 선택
### 2) 문제 준비
- 서버가 `prepare{videoId, startSec}` 전송 → 각자 숨긴 유튜브 플레이어에 음소거로 불러 시작 위치까지 버퍼링 후 `audioReady` 보고 (12 문서 Q1)
- **전원 준비되어야** `play{startAt}`로 모두 같은 순간 시작(시간이 지났다고 자동으로 시작하지 않음). 늦는 사람은 자동 다시 불러오기, 30초 넘으면 방장이 그 사람만 이번 문제에서 뺄 수 있음
- 재생 중 누군가 버퍼링하거나 소리가 막히면 모두 일시정지 후 같은 위치에서 재개. 멈춘 동안 제한 시간·힌트 시간은 줄지 않음 (12 문서 Q1)
- 화면: "3번째 문제" 카드 + 3·2·1 카운트
### 3) 문제 진행
| 모드 | 화면 | 끝나는 조건 |
|---|---|---|
| 듣고맞추기 | LP가 돌아가고 재생 막대(남은 시간), 앨범아트·제목은 가림 | 정답 / 스킵 통과 / 제한 시간 |
| 가수노래 맞추기 | 위와 같음 + 상단에 "선택한 가수" 표시 | 정답 / 스킵 / 제한 시간 |
| 가사보고 맞추기 | 음악 없이 가사 카드(제목 단어는 ○로 가림), 남은 시간 막대 | 정답 / 스킵 / 보고맞출시간 |
- **듣고맞출시간**이 1초~1분이면 그만큼만 재생하고 멈춘다. 재생이 끝나도 문제는 계속(채팅으로 계속 맞힐 수 있음). `다시듣기`(Ctrl+R) 투표가 다시듣기인원 이상이면 **모두 같이** 같은 구간을 처음부터 다시 듣는다(횟수 제한 없음, 제한 시간은 다시 센다 — 12 문서 Q4)
- **끝까지**면 곡이 끝날 때까지 재생, 곡이 끝나면 문제 종료
- 문제 하나의 최대 시간(제한 시간): 짧은 클립 모드 기본 60초, 끝까지 모드는 곡 길이, 관리자 설정에서 변경
### 4) 정답 공개 (5초)
- 무대에 앨범아트 + `노래제목 - 가수` + 연도·장르·난이도 별 표시, 정답자 이름과 걸린 시간
- 듣고맞추기면 음악은 그대로 이어서 5초 더(하이라이트 구간이면 그 뒤로)
- 채팅에 5줄 정답 블록(06-chat.md)
- 점수판 애니메이션(순위 바뀌면 자리 이동)
### 5) 결과
- 순위, 점수, 맞힌 곡 수, 가장 빨리 맞힌 곡
- 이번 게임 곡 목록(유튜브 링크 `https://youtu.be/ID` 포함) — 몰랐던 노래 다시 듣기
- `이어풀기`(나온 곡 빼고 점수 이어서 바로 시작), `다시 하기`(같은 설정으로 대기실 복귀), `퀴즈 저장`, `나가기` (12 문서 Q8)
## 정답 판정
### 정규화 (서버·클라이언트 공용, `packages/shared/answer.ts`)
1. 유니코드 NFKC(전각→반각), 영문 소문자
2. 괄호 안 내용 분리: `사랑을 했다(LOVE SCENARIO)` → 정답 후보 `사랑을 했다`, `LOVE SCENARIO`, `사랑을 했다 LOVE SCENARIO`
3. `feat.`, `(Prod. …)`, `[… OST]`, `(원곡: …)` 같은 꼬리 제거한 후보도 추가
4. 관리자가 넣은 별칭 추가(예: `좋은 날` ↔ `Good Day`, `IU` ↔ `아이유`)
5. 정답인식 설정에 따라 비교 전에 제거
- **띄어쓰기** 끔 → 공백 무시 (`사건의지평선` = `사건의 지평선`)
- **숫자** 끔 → 숫자 무시, 켬 → 숫자까지 정확히 (`24시간이 모자라`)
- **특수문자** 끔 → `!?.,'"()-~·…♡` 등 무시 (`Bubble Pop!` = `bubble pop`)
- 기본값은 셋 다 켬 = 엄격 (12 문서 Q2)
6. **빈 비교 키 방지** — 숫자·특수문자를 지우면 정답이 사라지는 곡이 실제로 있다(`0+0`, `160`, `365`, `3! 4!`, `11:11`, `24시간이 모자라`의 `24` 등)
- 정답 후보마다 비교 키를 만들 때, 지운 뒤 **키가 비거나 한글·영문이 하나도 남지 않으면** 그 후보는 숫자를 보존하고, 그래도 비면 특수문자까지 보존한 키를 쓴다 (`0+0` → 숫자 보존 `00` → 그래도 모호하면 원문 `0+0`)
- 채팅 쪽도 같은 규칙을 후보별로 똑같이 적용해서 비교한다(후보가 숫자를 보존했으면 채팅도 숫자를 보존)
- **빈 문자열끼리는 절대 일치로 보지 않는다**: 채팅 키나 후보 키 중 하나라도 비면 그 비교는 오답
- 최소 길이: 후보 원문이 2글자 이상인데 키가 1글자만 남는 경우도 숫자·특수문자 보존 키로 비교
- 단위 테스트에 sta_songs.json의 숫자·기호 제목(`0+0`, `160`, `365`, `365일`, `3! 4!`, `3!4!`, `11:11`, `2 L0VE`, `A`, `Y`)을 고정 사례로 넣는다
### 정답방식별 판정
| 방식 | 정답 조건 |
|---|---|
| 제목만 | 채팅(정규화) = 제목 후보 중 하나 |
| 가수만 | 채팅 = 가수 후보 중 하나. 여러 명이 부른 곡(`허각 / 정은지`)은 그중 한 명만 맞혀도 정답 |
| 제목+가수 | 한 줄에 둘 다, **순서 상관없이**. `광 sg워너비`, `sg워너비 광`, `sg워너비-광`, `광/sg워너비` 모두 정답. 판정: 채팅을 정규화한 뒤 `제목+가수` 또는 `가수+제목` 형태로 정확히 나뉘는지 검사(사이 구분자 `- / , 공백` 허용) |
- 대소문자 무시, 앞뒤 공백 무시
- 정답이 아닌 채팅은 그냥 채팅으로 보인다
- 오타 허용(유사도 판정)은 하지 않는다 — 유즈맵처럼 정확히 쳐야 맞음. 단, 관리자 별칭으로 흔한 표기 차이를 흡수
## 점수
- 먼저 맞힌 1명만 +1점 (유즈맵 방식, Q5 확정)
- 동점이면 맞힌 문제의 평균 정답 시간이 짧은 사람이 위
## 힌트
- **자동 공개**: 방 설정 "힌트공개" 시간(15/30/45/60초)이 지나면 공개
- **직접선택**: 힌트 투표(Ctrl+I / 힌트 버튼)가 "힌트인원" 이상이면 즉시 공개. 화면 아래 스킵 인원 옆에 `힌트 0/3` 표시
- 직접선택이 아닐 때 Ctrl+I: "없음"이면 "힌트가 꺼져 있어요", 시간 공개면 "힌트는 N초 뒤에 공개돼요" 안내 (12 문서 Q3)
- 힌트 내용(단계별)
1. 초성: `ㄱ (ㄱ) - ㅅㄱㅇㄴㅂ` (정답방식에 해당하는 부분만, 띄어쓰기 유지)
2. (가사 모드) 가사 2줄 더 공개
- 힌트가 공개된 뒤 맞혀도 점수는 같음(옵션으로 0.5점 검토)
## 스킵
- Ctrl+K 또는 `스킵` 버튼 = 내 스킵 표 토글
- 기준: 없음(스킵 불가) / 1명 / 2명 / 1/3 / 1/2 / 2/3 / 전체 — **현재 접속 중인 참가자 수 기준, 올림**
- 예) 7명, 1/3 → 3명 이상 누르면 스킵
- 진행 중 나간 사람은 표와 분모에서 빠짐
- 화면에 `스킵 2/3` 같이 현재 표 수 표시, 누른 사람 이름 옆에 ⏭
- 통과하면 정답 공개(정답자 없음) 후 다음 문제
## 중간 입장 · 퇴장
- 게임 중에도 입장 가능(0점으로 바로 참가), 다음 문제부터 음원 재생
- 나갔다 60초 안에 돌아오면 점수 유지
- 방장이 나가면 가장 먼저 들어온 접속자가 방장
## 방장 권한
- 설정 변경(대기실에서만), 시작, 강퇴, 방장 넘기기, 게임 중 `일시정지`/`게임 끝내기`