# 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초 안에 돌아오면 점수 유지 - 방장이 나가면 가장 먼저 들어온 접속자가 방장 ## 방장 권한 - 설정 변경(대기실에서만), 시작, 강퇴, 방장 넘기기, 게임 중 `일시정지`/`게임 끝내기`