Files
music_quiz/docs/04-room-settings.md

9.7 KiB

04. 방 설정

방장만 바꿀 수 있고, 대기실에서만 바뀐다. 바꾸면 즉시 모두에게 반영되고 준비 상태는 풀린다(joke-app 방식). 설정 아래에 **"조건에 맞는 곡 N곡"**을 실시간으로 보여준다.

한눈에

항목 선택지 기본값
모드 듣고맞추기 / 가수노래 맞추기 / 가사보고 맞추기 듣고맞추기
└ 듣고맞출시간 (듣고맞추기·가수노래) 1초, 3초, 5초, 10초, 30초, 1분, 끝까지 끝까지
└ 재생위치 (듣고맞추기·가수노래) 처음부터, 하이라이트부분부터 처음부터 (Q6)
└ 가수 선택 (가수노래) 검색해서 여러 명 추가, 누르면 빠짐 없음(1명 이상 필수)
└ 보고맞출시간 (가사보고) 30초, 60초, 90초, 120초, 150초, 무제한 무제한
장르 (복수) 아래 목록 전체
연도 범위 슬라이더 + 시작/끝 선택 상자 전체(가장 오래된 곡 ~ 올해)
난이도 별 10개, 왼쪽부터 채움 — N단계 곡만 3 (Q7)
정답방식 제목만 / 가수만 / 제목+가수(순서 무관) 제목만
정답인식 띄어쓰기 · 숫자 · 특수문자 각각 켜기/끄기 띄어쓰기 끔, 숫자·특수문자 켬 (Q2)
힌트공개 없음, 15초, 30초, 45초, 60초, 직접선택 없음
└ 힌트인원(이상) (직접선택일 때) 1명, 2명, 1/3명, 1/2명, 2/3명, 전체 1/3명 (Q3)
스킵인원(이상) 없음, 1명, 2명, 1/3명, 1/2명, 2/3명, 전체 1/3명
다시듣기인원(이상) (듣기 모드) 없음, 1명, 2명, 1/3명, 1/2명, 2/3명, 전체 1/3명 (Q4)
다음 문제까지 5초, 10초, 15초, 30초 5초
다음문제인원(이상) 없음, 1명, 2명, 1/3명, 1/2명, 2/3명, 전체 1/3명
문제 수 10, 20, 30, 50, 100, 무제한(조건에 맞는 곡 수) 30 (Q8)
방 공개 (제안) 공개 / 비공개(코드·링크로만) / 비밀번호 공개

모드

듣고맞추기

  • 노래를 듣고 맞힌다. 기본 모드
  • 듣고맞출시간: 재생 길이. "끝까지"는 곡이 끝날 때까지
  • 재생위치: 처음부터 / 하이라이트부분부터 (하이라이트 구하는 법은 08 문서)

가수노래 맞추기

  • 고른 가수들의 노래만 출제. 듣는 방식은 듣고맞추기와 같음(듣고맞출시간·재생위치 함께 보임)
  • 가수 선택 UI: 검색창에 이름 입력 → 아래로 후보(이름, 곡 수, 주 장르) → 누르면 위쪽 "선택한 가수" 줄에 칩으로 추가 → 칩을 다시 누르면 빠짐
  • 별칭 검색 지원(IU → 아이유, SG Wannabe → SG워너비), 초성 검색(ㅂㅂ → 빅뱅)
  • 그룹과 솔로 연결(태연 선택 시 "소녀시대 곡도 포함" 체크는 추후)
  • 이 모드에서도 장르·연도·난이도 필터는 그대로 적용(원하면 "전체"로)

가사보고 맞추기

  • 음악 없이 가사 일부를 보고 맞힌다
  • 보고맞출시간: 문제당 제한 시간. "무제한"이면 정답·스킵까지
  • 가사 4줄 → 시간이 갈수록 2줄씩 추가, 제목 단어는 ○로 가림

이지선다 (조회수가 더 높은 곡 고르기)

  • 이지선다 퀴즈(관리자 → 퀴즈 → 파일로 만들기에서 이지선다로 만든 퀴즈, 조회수는 서버가 토픽 + MV로 불러옴)로만 한다. 일반 퀴즈·직접 선택은 고를 수 없다
  • 제한 시간: 10·15·20·30(기본)·45·60·90초. 진행 방식: 매번 새 두 곡 / 이긴 곡이 남기(연속). 재생위치: 처음부터 / 하이라이트부터
  • 문제 수: 10~100 또는 전부(매번 새 두 곡 = 곡 수÷2, 연속 = 곡 수-1). 다음 문제까지·다음문제인원은 그대로, 정답방식·힌트·스킵·다시듣기는 없다
  • 규칙은 12 문서 "이지선다"

장르 (여러 개 선택)

멜론 장르 분류와 노라보세 분류를 합쳐 정리. 곡 하나가 여러 장르를 가질 수 있다.

묶음 장르 멜론 코드
전체 전체 —
지역 K-POP 한국대중음악 GN0100~0800
J-POP GN1900
POP GN0900 해외POP
장르 발라드 GN0100
댄스 GN0200
랩/힙합 GN0300
R&B/소울 GN0400
록/메탈 GN0600
인디 GN0500
포크/블루스 GN0800
일렉트로닉 (세부 장르 일렉트로니카)
성인가요/트로트 GN0700
재즈 GN1700
클래식/뉴에이지 GN1600, GN1800
테마 영화/드라마 GN1500 OST(국내외 영화·드라마)
애니/게임 GN1506 애니메이션/게임 (+ 게임 BGM)
동요/만화 GN2200 어린이 + 만화 주제가
걸그룹 가수 정보(그룹·여성)로 자동 분류
보이그룹 가수 정보(그룹·남성)로 자동 분류
  • 관리자 페이지 "장르"에서 추가·이름 변경·숨김 가능(예: 뮤지컬, CCM, 국악은 곡이 쌓이면 추가)
  • 고르는 규칙: 같은 묶음 안에서는 "또는", 다른 묶음끼리는 "그리고"
    • 예) [K-POP] + [발라드, 댄스] → 국내 곡 중 발라드 또는 댄스
    • 예) [발라드] 만 → 국내외 발라드 전부
    • "전체"를 누르면 나머지 선택이 풀림 (Q9)

연도

  • 참고 이미지 1.png 방식: 막대 위 두 손잡이(시작은 아래 말풍선, 끝은 위 말풍선) + 아래에 "OOOO년부터", "OOOO년까지" 선택 상자 2개
  • 손잡이를 끌거나 상자에서 고르면 서로 맞춰서 움직임
  • 빠른 선택 칩: 80년대, 90년대, 2000년대, 2010년대, 2020년대 (누르면 범위가 그 10년으로)
  • 범위: DB에서 가장 오래된 곡 연도 ~ 올해
  • 연도는 발매일 기준(리메이크는 리메이크 발매 연도). sta_songs.json은 803곡 중 528곡이 연도가 없고, 적힌 연도도 맵 제작자가 넣은 값이라(2026년으로 적힌 곡만 26곡) 전부 멜론 발매일로 다시 맞춘다

난이도 (별 10개)

참고 이미지 2.png 방식: 빈 별 10개를 왼쪽부터 채우고, 오른쪽에 단계 이름과 설명.

단계 이름 설명
1 누구나 아는 대표곡 장르를 전혀 안 듣는 사람도 후렴을 따라 부를 수 있는 곡
2 길거리 단골 노래 방송, 매장, 길거리에서 워낙 자주 나와서 귀에 익은 곡
3 한 번쯤 들어본 히트곡 차트 상위권에 올라서 제목은 몰라도 대부분 들어본 곡
4 가끔 들어도 아는 곡 장르를 자주 안 들어도 차트에서 한 번쯤 접해본 곡
5 장르 팬 필수곡 크게 뜨진 않았지만 장르 팬이라면 다 아는 곡
6 뒤늦게 알려진 곡 입소문이나 역주행으로 뒤늦게 조금 알려진 곡
7 고인물이 아끼는 숨은 명곡 차트 성적은 없지만 고인물들 사이에서 명곡으로 꼽히는 곡
8 찾아 들어야 아는 곡 어디서도 들을 일이 없어서 직접 찾아 들은 사람만 아는 곡
9 골수 리스너 인증곡 고인물 중에서도 극소수만 들어본 곡
10 인간 샤잠만 가능 들어본 사람 자체가 거의 없는 곡
  • 별 색: 13 겨자 / 46 주황 / 78 빨강 / 910 보라 (03 문서)
  • 마우스를 올리면 그 단계 이름·설명 미리보기, 누르면 확정
  • 선택 의미(확정): 별 N개 = N단계 곡만 출제. 한 곡이 장르·연도 기준에 따라 여러 단계를 가질 수 있어서 같은 곡이 다른 단계 방에도 나올 수 있다 (12 문서 Q7)

정답방식 · 정답인식

  • 정답방식: 제목만 / 가수만 / 제목+가수 — 제목+가수는 순서 상관없이 한 줄에 둘 다 (05 문서 판정 규칙)
  • 정답인식: 버튼 3개, 누를 때마다 켜짐/꺼짐
    • 켜짐 = 그 요소까지 정확히 쳐야 정답, 꺼짐 = 무시하고 비교 (확정: Q2), 기본은 띄어쓰기 끔·숫자 켬·특수문자 켬 (2026-11-04)
    • 대소문자는 항상 무시

힌트공개

  • 15~60초: 문제 시작 후 그 시간이 지나면 초성 힌트 자동 공개. 없음 = 힌트 없음
  • 직접선택: 자동 공개 없이 힌트 투표(Ctrl+I)가 힌트인원 이상이면 공개 (12 문서 Q3)

다시듣기인원(이상)

  • 듣기 모드에서 다시듣기 투표(Ctrl+R)가 이 인원 이상이면 모두 같이 같은 구간을 처음부터 다시 듣는다. 없음 = 다시듣기 불가 (12 문서 Q4)

다음 문제까지 · 다음문제인원(이상)

  • 정답 공개(맞힘·스킵·시간 초과 모두) 뒤 다음 문제로 넘어가기까지 기다리는 시간. 그동안 노래는 이어서 나온다. 마지막 문제도 같은 시간 뒤 결과 화면
  • 정답 공개 중 ⏭ 다음 문제(Ctrl+K) 표가 다음문제인원 이상이면 바로 넘어간다. 기준은 방에 접속 중인 사람 수(다음 문제는 모두가 같이 하므로), 올림. 없음 = 버튼 꺼짐
  • 정답 공개 화면에 다음 문제까지 N초(마지막 문제는 결과까지 N초), 방 목록 카드 요약에 공개 N초

스킵인원(이상)

  • 글자 오른쪽 위에 동그라미 속 느낌표 아이콘 ⓘ(!) — 마우스를 올리면 말풍선: "이번문제 스킵을 위해 스킵을 눌러야하는 인원 설정"
  • 기준 인원은 현재 접속 참가자 수 기준 올림 (05 문서)

설정 저장

  • 방 설정은 방이 살아있는 동안 유지, 다시 하기도 같은 설정
  • 이어풀기: 같은 설정 + 이번 퀴즈에서 나온 곡 제외 + 점수 이어서. 퀴즈 저장/불러오기로 나중에 이어서 할 수 있음 (12 문서 Q8)
  • 개인 "최근 설정 불러오기"(로그인 사용자): 방 만들 때 내가 마지막에 쓴 설정으로 시작
  • 관리자는 사이트 기본 설정(새 방의 기본값)과 잠금(특정 항목 고정)을 바꿀 수 있음