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

7.6 KiB
Raw Permalink Blame History

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초 안에 돌아오면 점수 유지
  • 방장이 나가면 가장 먼저 들어온 접속자가 방장

방장 권한

  • 설정 변경(대기실에서만), 시작, 강퇴, 방장 넘기기, 게임 중 일시정지/게임 끝내기