31 KiB
31 KiB
12. 확정 사항 (2026-10-18 사용자 답변)
11-questions.md 질문에 대한 사용자 답변과, 답변을 구현으로 옮길 때의 해석을 적는다. 다른 문서와 다르면 이 문서가 우선이다. 답이 없던 항목(Q9, Q11~Q19)은 추천안(★)으로 진행한다.
한눈에
| # | 결정 | 영향 문서 |
|---|---|---|
| Q1 | B안: 숨긴 유튜브 플레이어(IFrame) 로 재생. 대신 모두 같은 순간에 듣고, 버퍼링으로 한 명이 못 듣는 일이 없게 한다 | 08 |
| Q2 | 정답인식 켜짐 = 그 요소까지 정확히 쳐야 정답. 기본값: 띄어쓰기·숫자·특수문자 모두 켬 | 04, 05 |
| Q3 | 힌트공개에 직접선택 추가(60초 뒤). 직접선택이면 힌트인원 설정이 생기고 투표로 공개 | 04, 05 |
| Q4 | 다시듣기 투표(모두 같이 다시 듣기), 단축키 Ctrl+R, 설정에 다시듣기인원 | 04, 05, 06 |
| Q5 | 먼저 맞힌 1명만 +1 | 05 |
| Q6 | 재생위치 기본값: 처음부터 | 04 |
| Q7 | 별 N개 = N단계 곡만. 한 곡이 장르·연도에 따라 여러 단계를 가질 수 있음 | 04, 07 |
| Q8 | 문제 수 추가. 최대는 무제한(조건에 맞는 곡 수). 끝나면 이어풀기, 퀴즈 저장·불러오기 | 04, 05 |
| Q9 | 알아서 → 추천안(같은 묶음 "또는", 다른 묶음 "그리고") | 04 |
| Q10 | 기본 정답방식은 제목만, 방 설정이 제목+가수면 그대로 | 04 |
| 채팅 | 도배 방지 기본 꺼짐(관리자가 켬). 채팅은 무조건 실시간. 정답 줄과 5줄 블록 사이에 다른 말이 끼지 않게 | 06 |
| 쿠키 | 유튜브 뮤직 검색은 사용자가 준 ytm_cookie.txt 사용 (music_bot_v2 쿠키와 분리) |
08, 09 |
| .9 용량 | 부족하면 필요 없거나 오래된 캐시 파일 삭제(작업 중인 것 제외) | 09 |
Q1. 재생: 숨긴 IFrame + 동기화
사용자 요구: "클라이언트가 부담하는 대신 다른 사람들과 실시간 동기화, 버퍼링 때문에 한 명이 노래를 못 듣는 경우가 없게"
- 원칙: 참가자 전원이 들을 수 있을 때만 재생이 진행된다. 시간이 지났다고 누구를 빼고 자동으로 시작하거나, 뒤늦게 중간부터 합류시키지 않는다
- 시계 맞추기: 접속 직후와 30초마다 ping 5회로 서버 시각 차이(
offset)를 잰다(왕복 시간 가장 짧은 값 사용) - 소리 허용(입장 시 1회): 브라우저는 사용자가 누르기 전에는 소리 있는 재생을 막을 수 있다. 그래서 방에 들어올 때
참가 (소리 켜기)버튼을 누르게 하고, 그 클릭 안에서 플레이어 재생·음소거 해제를 한 번 해 둔다 - 준비 단계(문제마다): 서버가
prepare{videoId, startSec}를 보냄 → 클라이언트는 숨긴 플레이어에 곡을 음소거로 불러 실제 재생 상태(PLAYING)가 되면(광고가 있으면 광고가 끝난 뒤) 멈추고startSec로 되돌린 뒤audioReady보고- 전원 준비되면 서버가
play{startAt}(서버 시각, 지금+800ms)을 보냄 → 모두 같은 순간에 음소거 풀고 재생 - 안 되는 사람이 있으면 그 사람 화면은 8초·16초에 곡을 자동으로 다시 불러온다. 다른 사람 화면에는
철수님 음원 준비 중…표시 - 어느 한 명이라도 영상 오류(100 삭제·101/150 퍼가기 금지)가 나면 그 곡을 모두에게서 다른 곡으로 바꾼다(문제 번호는 그대로, 그 곡은 관리자 "재생 불가"로 표시)
- 30초가 지나도 준비가 안 되면 방장에게
철수님 빼고 이번 문제 진행버튼이 보인다. 누르면 그 사람은 이번 문제만 제외(정답 입력·점수 없음, 화면에 "음원을 불러오지 못했어요" + 다시 시도 버튼). 자동으로 빼지는 않는다 - 접속이 끊긴 사람은 기다리지 않는다(다시 들어오면 다음 문제부터)
- 전원 준비되면 서버가
- 소리 확인: 재생 직후 0.3초 안에
isMuted() == false이고PLAYING인지 확인한다. 아니거나onAutoplayBlocked이벤트가 오면blocked보고 → 아래 버퍼링과 똑같이 모두 일시정지, 그 사람 화면에 크게눌러서 소리 켜기버튼 → 누르면 다시 준비 → 모두 같은 위치에서 재개 - 재생 중 버퍼링: 클라이언트가 0.5초 넘게 버퍼링하면
stall보고 → 서버가 모두 일시정지 → 그 사람이 다시 준비되면 새play{startAt, atSec}로 모두 같은 위치에서 재개. 시간 상한으로 자동 진행하지 않고, 30초 넘게 멈춰 있으면 준비 단계와 같은 방장 버튼만 보인다 - 시간 두 종류로 나눠 센다
- 클립 정지(1초~1분): 시계가 아니라 재생 위치 기준(아래 "재생 길이")
- 문제 제한 시간·힌트 자동 공개 시간: 문제 시작(첫
play)부터 흐른 시간에서 모두 멈춰 있던 시간(버퍼링·소리 차단·준비 대기로 인한 전체 일시정지)만 뺀 값. 클립이 정상적으로 끝난 뒤에도 이 시간은 계속 흐른다 → 1초 클립이 끝나도 15초 힌트, 60초 제한 시간에 정상 도달 - 전체 일시정지 중에는 화면 타이머도 멈추고
잠시 멈춤 — 철수님 버퍼링 중표시. 채팅과 정답 입력은 계속 받는다(모두 같은 위치까지 들은 상태라 공평)
- 오차 보정: 1초마다
getCurrentTime()과 기대 위치를 비교해 0.3초 넘게 어긋나면 그 위치로 이동 - 재생 길이(1초~1분): 시계로 멈추지 않고 재생 위치를 보고 멈춘다(
getCurrentTime() >= 시작 + 길이를 화면 갱신마다 + 10ms마다 검사). 실제 브라우저 시험에서 멈춘 위치 오차 −0.002~+0.010초(아래 표)- 각 클라이언트는 클립을 끝내면
clipEnd보고. 서버는 전원 보고가 오거나 예상 끝 시각 + 3초가 지나면 클립 단계를 끝낸다 — 보고가 안 온 클라이언트가 있어도 그 화면에 정지 명령을 한 번 더 보내고, 문제 자체는 끝내지 않는다(정답 입력과 남은 제한 시간은 그대로 진행) - 이 3초 때문에 생기는 차이는 제한 시간 계산에 영향 없음(제한 시간은 위 규칙대로 문제 시작부터 셈)
- 각 클라이언트는 클립을 끝내면
- 정답 노출 줄이기: 플레이어는 화면 밖에 숨기고 제목 표시 없음. 영상 ID는 준비 단계에서만 보내고 방 상태에는 넣지 않는다. (개발자도구로 보는 것까지는 막을 수 없음 — 사용자가 감수하기로 함)
- 퍼가기 금지 영상: 노래 DB 매칭 때 oEmbed로 퍼가기 가능 여부를 확인해 안 되는 영상은 쓰지 않는다(07·08). 재생 중 오류 코드 101/150이 오면 그 곡은 건너뛰고 관리자 "재생 불가"로 표시
- 실제 브라우저 시험 (2026-10-18,
tools/prototypes/iframe-sync/run.ts): 시스템 Chrome, 자동재생 정책document-user-activation-required, 곡VO88htcm09E(광, Topic) 60초 지점항목 결과 음소거 준비 시간 처음 시험 15회 중 14회 0.30 0.48초, 1회는 23초 동안 준비 실패 → 다시 불러오기·대기 규칙이 꼭 필요함을 확인. 고친 도구로 8회 반복(24회)은 모두 0.260.52초입장 클릭으로 소리 허용 클릭 안에서 곡을 소리 켠 채 불러 재생 → 4회 모두 재생 성공·음소거 아님. (처음엔 빈 플레이어에 재생을 걸어 오류 2가 났음 → 클릭 안에서 곡을 직접 불러오는 방식으로 고침) 3명 동시 시작 후 위치 차이 2초 뒤 8 29ms → 10초 뒤 2048ms (보정 기준 0.3초보다 훨씬 작음)1초 클립, 시계 기준 정지(처음 방식) 실제 0.93~1.00초 → 위치 기준으로 바꿈 1초 클립, 위치 기준 정지(지금 방식) 멈춘 위치 오차 −0.002~+0.010초 (4회 × 3명 + 클릭 없는 경우 4회) 클릭 없이 음소거 해제 이 환경(헤드리스 크롬)에서는 막히지 않았음. 사파리·휴대폰은 더 엄격하므로 입장 클릭·소리 확인 절차를 그대로 둔다 광고 자동 시험에서는 광고가 나오지 않아 미검증 - 남은 검증 (5단계에서 사람이 직접): 프리미엄이 아닌 계정의 실제 PC 크롬·엣지, 아이폰 사파리, 안드로이드 크롬에서 광고가 붙는 곡, 입장 클릭 없이 들어온 경우, 1초 클립, 3명 이상 동시 시작을 확인하고 결과를 이 문서에 적는다
- 서버 음원 캐시(A안)는 만들지 않는다 → yt-dlp·ffmpeg·음원 캐시 디스크 상한 항목은 하이라이트 분석용 일회성 처리 외에는 없음
Q2. 정답인식 기본값
- 켜짐 = 그 요소까지 똑같이 쳐야 정답, 꺼짐 = 무시하고 비교
- 새 방 기본값: 띄어쓰기 켬, 숫자 켬, 특수문자 켬(가장 엄격). 대소문자는 항상 무시
- 엄격 모드라도 관리자 별칭으로 흔한 표기 차이(
광/광 (狂), 괄호 속 영어 제목 등)는 흡수한다 — 정답 후보 만들기 규칙(05)은 그대로
Q3. 힌트
- 힌트공개 선택지: 없음 / 15초 / 30초 / 45초 / 60초 / 직접선택
- 직접선택일 때만 방 설정에 힌트인원(이상) 이 보인다. 선택지는 스킵인원과 같음(1명, 2명, 1/3, 1/2, 2/3, 전체), 기본 1/3
- 게임 화면 아래 투표 줄:
스킵 1/3옆에힌트 0/3을 같이 표시(직접선택일 때만) - 힌트 버튼·Ctrl+I 동작
- 직접선택: 내 힌트 표 토글, 기준을 넘으면 모두에게 공개
- 없음: 누르면 "이 방은 힌트가 꺼져 있어요" 안내(버튼은 흐리게)
- 15~60초: 누르면 "힌트는 N초 뒤에 공개돼요"(남은 초), 공개된 뒤면 "이미 공개된 힌트예요"
Q4. 다시듣기 투표
- 듣기 모드(듣고맞추기·가수노래)에서 문제 진행 중 다시듣기 표를 모아 기준을 넘으면 모두 같이 같은 구간을 처음부터 다시 듣는다(동기화 방식 그대로)
- 단축키 Ctrl+R(게임 화면에서는 새로고침 대신 다시듣기,
preventDefault), 버튼다시듣기 (Ctrl+R) - 방 설정 다시듣기인원(이상): 없음 / 1명 / 2명 / 1/3 / 1/2 / 2/3 / 전체, 기본 1/3
- 다시 들으면 표는 초기화되고, 또 모으면 또 들을 수 있다(문제당 횟수 제한 없음)
- 짧은 클립(1초~1분)이면 문제 제한 시간을 다시 들은 시각부터 다시 센다. "끝까지"면 다시 들은 시각 + 곡 길이까지
- 투표 줄 표시:
스킵 1/3 · 힌트 0/3 · 다시듣기 2/3 - 가사보고 모드에서는 다시듣기 없음(버튼 숨김)
Q7. 난이도 N단계만 + 단계 중복
- 별 N개 = 정확히 N단계 곡만 출제
- 한 곡이 여러 단계를 가질 수 있다. 예) 어떤 발라드가 전체 기준으로는 5단계지만 발라드 안에서는 2단계, 90년대 곡 안에서는 3단계
- 저장:
song_levels(song_id, scope, level)—scope는all(전체),genre:<장르ID>,decade:<1990>처럼 기준을 적는다 - 출제 판정: 방에서 고른 장르·연도에 해당하는 기준(
all+ 고른 장르들 + 고른 연도 범위가 걸치는 10년 단위) 중 어느 하나라도 단계가 N이면 출제 후보- 그래서 같은 곡이 3단계 방에도, 5단계 방에도 나올 수 있다(사용자 설명대로 "단계가 중복되는 노래")
- 관리자 노래 편집에서 기준별 단계를 보고 고칠 수 있게 한다. 자동 계산은
all먼저, 곡이 충분히 쌓인 장르·연대부터 기준별로 계산 - (해석이 다르면 알려 주세요 — 예: "단계를 범위로 저장" 등)
Q8. 문제 수 · 이어풀기 · 저장/불러오기
- 문제 수 선택지: 10 / 20 / 30 / 50 / 100 / 무제한(N곡) — N은 지금 조건에 맞는 곡 수를 실시간 표시. 기본 30
- 무제한 = 조건에 맞는 곡을 다 낼 때까지(또는 방장이 끝낼 때까지)
- 이어풀기(결과 화면 버튼, 방장): 같은 설정으로 바로 이어서 시작, 이번 퀴즈에서 나온 곡은 모두 빼고 출제. 점수는 이어서 쌓인다. (
다시 하기는 점수 0부터, 나온 곡 제외 없음)- 남은 곡이 없으면 "조건에 맞는 곡을 모두 풀었어요"
- 저장: 방장이 대기실·결과 화면(또는 게임 중 일시정지)에서
퀴즈 저장→ 이름을 붙여 방장 계정에 저장. 저장 내용: 방 설정, 지금까지 나온 곡 목록, 참가자별 점수(계정 기준), 진행 문제 수- 디스코드 로그인 사용자만 저장 가능(게스트는 안내), 계정당 최대 20개, 오래된 것부터 지우지는 않고 직접 삭제
- 불러오기: 대기실에서 방장이
퀴즈 불러오기→ 목록에서 선택 → 설정·나온 곡 목록·점수가 복원되고, 시작하면 나온 곡을 빼고 이어서 출제. 그 방에 다시 들어온 참가자는 저장된 점수를 이어받는다
Q10. 가수노래 맞추기 정답방식
- 새 방 기본은 "제목만". 방장이 정답방식을 "제목+가수"로 해 두면 가수노래 모드에서도 그대로 제목+가수
채팅 (사용자 추가 요구)
- 도배 방지 기본 꺼짐. 관리자 사이트 설정에
채팅 도배 방지켜기/끄기와 수치(초당 횟수, 순간 횟수)를 둔다 - 무조건 실시간: 서버는 채팅을 받는 즉시 정답 판정과 중계를 한 번에 처리한다(대기열·묶음 전송·지연 없음). 묶어서 보내는 건 "입력 중" 표시뿐
- 정답 블록이 끊기지 않게
- 정답이면 서버는
chat을 따로 보내지 않고 정답 줄 + 공백 5줄 블록을 한 덩어리 메시지(answer) 로 보낸다 → 그 사이에 다른 메시지가 들어갈 자리가 없음 - 모든 채팅·정답 메시지에 방 단위 순번(
seq)을 붙이고, 화면은 순번대로 그린다 - 내가 보낸 말은 바로 화면에 보이되(지연 0) 확정 전에는 항상 맨 아래 "보내는 중" 자리에 둔다. 서버 확인이 오면 순번 자리에 들어간다 → 정답이 내 말보다 먼저 서버에 도착했으면 내 말은 블록 아래로 간다
- 결과: 공백 블록 바로 위 줄이 항상 정답 줄
- 정답이면 서버는
유튜브 뮤직 쿠키
- 사용자가 준
ytm_cookie.txt를 호스트 비밀 위치/home/claude/.config/music_quiz/ytm_cookie.txt(권한 600)에 보관. 리포에는 넣지 않는다 - 쓰는 곳: 노래 수집기의 YT Music 노래 검색(music_bot_v2 방식
SAPISIDHASH), 관리자 "곡 추가" 자동 채우기, 연령제한 음원 받기. 컨테이너에는 폴더째 쓰기 가능으로 연결(YT_COOKIE_PATH) - (2026-10-29) 서버가 브라우저처럼 10분마다 쿠키 세션 값을 갱신해 파일에 쓴다(08 §1 쿠키 갱신). 쿠키는 시크릿 창 전용 세션으로 받는다. OAuth는 yt-dlp가 지원하지 않아 쓰지 않음
- music_bot_v2 쿠키와는 분리해서 쓴다 → 차단돼도 봇에는 영향 없음
- 쿠키 만료(로그인 필요 응답) 감지 시 관리자 → 수집 맨 위에 표시(디스코드 알림은 하지 않음, 사용자 결정 2026-10-29)
.9 용량
- 이미 있는 것:
docker-disk-guard.sh(남은 공간 50GB 미만이면 도커 빌드 캐시·이름 없는 이미지 삭제),disk85-alert.sh(85% 이상 알림) - 추가:
disk-low-cleanup.sh— 남은 공간이 50GB 미만일 때 다시 받으면 되는 캐시만 지운다- 지움: pip·uv·npm·bun·node-gyp 설치 캐시(도커 빌드 캐시는 기존
docker-disk-guard.sh가 같은 기준으로 처리) - 안 지움:
~/.tmp(파일이 오래됐다고 작업이 끝났다는 보장이 없음), 모델(huggingface 등), 브라우저(playwright), 프로젝트 폴더, DB·백업, 실행 중인 설치 작업이 있으면 그 캐시
- 지움: pip·uv·npm·bun·node-gyp 설치 캐시(도커 빌드 캐시는 기존
- Q1이 B안이라 음원 캐시가 없어 이 프로젝트가 쓰는 디스크는 DB 정도(수백 MB)
4단계 확인 (2026-10-18, 사용자: "추천대로 진행")
- 방은 서버 메모리에만 둔다. 서버를 다시 켜면(업데이트) 방이 사라지고, 그 방에 있던 화면에는 "서버가 업데이트되면서 방이 닫혔어요" 안내가 나온다(새로고침해도 같은 안내, 탭별
sessionStorage) - 4단계에 간단한 대기실 채팅을 넣는다: 한 줄 로그, 입장·퇴장·방장 바뀜 시스템 줄, 내 말 먼저 표시, 새로 들어온 사람에게 최근 100줄. 정답 판정·"입력 중"은 6단계
- "조건에 맞는 곡"은 원곡이 확정된 곡만 센다. 원곡 확인 중인 곡 수를 따로 보여 준다. 후보 영상만 있는 곡으로 미리 하기는 하지 않는다(팬 영상 섞임). 수집기가 따로 돌기 때문에 대기실 곡 수는 1분마다 다시 센다
- 게스트도 방을 만들 수 있다. 퀴즈 저장은 디스코드 계정만(5단계)
- 비밀번호 방은 열린 방 목록에 🔒로 보이고 들어갈 때 비밀번호를 묻는다. 비밀번호를 정하기 전에는 잠기지 않는다고 방장에게 안내
- 방 공개 기본값은 공개. 비공개 방은 목록에 안 나오고 코드·링크로만 들어온다
5~7단계 확인 (2026-10-18, 사용자: "나머지 전부 진행", 문서 추천안대로)
- 마지막 사람이 나가면 방을 바로 닫는다(사용자 요청). 끊김은 60초 자리 유지, 만들고 아무도 안 들어간 방은 5분
- 게임 시작은 방장이 언제든(준비는 표시만). 곡이 문제 수보다 적으면 "N곡뿐이에요" 확인 뒤 시작
- 정답은 첫 재생(3·2·1이 끝난 뒤)부터 인정. 카운트다운 중에 친 말은 그냥 채팅
- 게임 중에 들어온 사람·다시 연결한 사람은 다음 문제부터 정답 인정(지금 문제는 채팅만). 그 문제의 참가자 명단은 문제를 준비할 때 정함
- 문제 제한 시간: 짧은 클립은 사이트 설정
문제 하나의 제한 시간(기본 60초)과 클립 길이+5초 중 긴 쪽, "끝까지"는 곡이 끝나면 문제도 끝, 가사 모드는 보고맞출시간(무제한이면 맞히거나 스킵할 때까지) - 정답 공개 5초 동안 음악은 이어서 나온다(각자 화면에서, 동기화 없이)
- 재생위치 "하이라이트부터": 관리자 지정·heatmap 값이 없으면 곡 길이의 30% 지점. 끝나기 5초 전보다 뒤면 처음부터
- 소리 허용 클릭: 대기실의
참가 (소리 켜기)또는 게임 화면 덮개 버튼. 클릭 안에서 소리 0으로 짧은 곡을 한 번 틀었다 멈춘다 - 가사 카드: 두 번 이상 나오는 줄(후렴)을 뺀 첫 덩어리의 가운데 4줄, 제목 단어는 ○, 힌트가 나오면 2줄 더
- 초성 힌트: 한글은 초성, 영문 단어는 첫 글자 +
_(예:L___ W___ A__), 정답방식이 제목+가수면제목 - 가수둘 다 - 점수판 순위: 점수 → 평균 정답 시간. 같으면 같은 순위
- 퀴즈 저장: 결과 화면(또는 방장이 일시정지한 동안), 저장하면 설정·나온 곡·점수(계정별). 불러오면 방 이름·공개 설정은 지금 방 것을 유지
- 남은 사람 검증(사람 손으로): 광고가 붙는 곡, 아이폰 사파리, 안드로이드 크롬, 클릭 없이 들어온 경우 — Q1 "남은 검증" 그대로
다음 문제까지 (2026-10-18, 사용자: "바로 다음문제 버튼도 스킵처럼 인원설정, 나머지는 추천대로")
- 방 설정
다음 문제까지5/10/15/30초(기본 5초)가 서버 고정 5초를 대신한다. 맞힘·스킵·시간 초과·마지막 문제 모두 같은 시간 - 정답 공개 동안 노래는 계속 나온다(5~7단계 6번 그대로, 길이만 방 설정)
다음문제인원(이상)(기본 1/3명): 정답 공개 중⏭ 다음 문제(Ctrl+K) 표가 이 인원 이상이면 바로 넘어감. 방장 전용이 아니라 스킵처럼 투표, 기준은 방에 접속 중인 사람 수- 관리자 사이트의 새 방 기본값·잠금, 퀴즈 저장·불러오기에 같이 들어간다(예전 저장본은 기본값 5초·1/3명)
새로고침 이어하기·업데이트 알림·곡 제목 특수문자 (2026-10-19, 사용자: 질문은 알아서 결정)
- 퀴즈 중 새로고침(같은 계정이 60초 안에 돌아옴)은 그 문제부터 그대로 이어서 한다. 5~7단계 4번의 "다시 연결한 사람은 다음 문제부터"를 이렇게 바꾼다. 처음 들어온 사람은 그대로 다음 문제부터
- 노래가 나오는 중이면 서버가
catchup(영상, 서버 기준 시작 시각·위치)을 보내고, 새 화면은 소리를 끈 채 같은 위치에 맞춰 둔다. 브라우저는 클릭 전 소리를 막으므로참가 (소리 켜기)를 누르는 순간 다른 사람과 같은 위치에서 소리가 난다. 다른 사람은 멈추지 않는다 - 준비(prepare) 중이면 새 화면에 prepare를 다시 보내고 방은 그 사람의 준비를 기다린다(예전에는 이때 문제가 멈춘 채 안 넘어갈 수 있었음)
- 방장이 끊기면 15초 동안 방장을 유지한다. 그 안에 돌아오면 그대로, 아니면 접속 중인 다음 사람에게 넘어간다(5초마다 확인). 스스로 나가기는 지금처럼 바로 넘어감
- 서버 업데이트(재시작) 때는 지금처럼 방이 닫힌다(방은 메모리에만 있음)
- 노래가 나오는 중이면 서버가
- 업데이트 알림은 joke-app과 같다: 웹 빌드 id(
<meta name="mq-build">)가 서버와 다르면 위쪽에 "업데이트 내용이 있습니다 · 지금 새로고침하기 · ✕". 퀴즈 중에도 바로 띄우고 저절로 새로고침하지 않는다 - 곡 제목·가수의 HTML 특수문자(
',&)는 수집할 때 풀어서 저장한다. 이미 저장된 곡은cli.ts fix-text로 한 번 고치고, 고친 곡은 원곡 찾기를 다시 하며, 깨진 키 때문에 생긴 중복은 오래된 곡으로 합친다
소리 크기 맞추기 (2026-10-19, 사용자: "재생할 때 볼륨을 자동으로, 노멀라이즈 느낌으로")
- 곡마다 볼륨을 자동으로 바꾼다. 곡 크기는 서버가 오디오를 받아 재는 대신 유튜브가 잰 값(영상 페이지
audioConfig, LUFS)을 쓴다. 오디오 다운로드가 없어서 봇 차단 위험이 거의 없고 유튜브 자신의 줄이기와 같은 기준이다 - 기준은 -18 LUFS(곡의 약 96%가 같은 크기). 전체 소리는 보통 곡 기준 약 4dB(볼륨 0.63배) 작아진다. 끄는 옵션은 두지 않는다(항상 켬)
- 곡 안 구간별(처음부터/하이라이트부터) 보정은 하지 않는다. 유튜브 값은 곡 전체 평균 하나뿐이다
- 자세한 내용은 08 문서 3-1
제작된 퀴즈 (2026-10-22, 사용자 답변 19 + 추가 확인 13)
- 퀴즈는 관리자만 만든다(관리자 → 퀴즈). 목록 → 퀴즈 추가(이름) → 플레이리스트 가져오기 / 직접 하나씩 추가 → 곡 목록 화면
- 곡 목록: 제목·가수 검색(서버 노래 DB 먼저, 없으면 유튜브 뮤직 노래 검색) 또는 유튜브 주소 붙여넣기로 추가, 끌어서·▲▼·번호로 순서 바꾸기, 제목·가수 고치기, 영상 바꾸기, 복수정답. 서버 DB 곡과 연결된 곡의 복수정답은 저장할 때 DB 별칭(
song_aliases, sourcequiz)에도 넣는다(검토 없음) - 저장은 손으로만: 저장 버튼·Ctrl+S. 안 저장했으면 탭 제목
● 저장 안 됨과 위쪽 표시, 사이트 안 이동은 [저장하고 나가기/저장하지 않고 나가기/취소], 창 닫기는 브라우저 기본 경고(브라우저가 버튼을 못 바꾸게 함) - 퀴즈 설정: 이름, 설명, 공개방식, 문제 순서(순서대로/무작위), 재생위치 기본(처음부터/하이라이트부터), 듣고맞출시간, 정답방식·정답인식·힌트·스킵·다시듣기·다음 문제까지·다음문제인원. 방에서 퀴즈를 고르면 이 값이 방 설정으로 들어가고(사이트가 잠근 항목 제외) 방장이 바꿀 수 있다
- 공개방식: 비공개 = 만든 사람 계정으로 방을 만들 때만, 일부공개 = 만든 사람과 관리자, 전체공개 = 모두. 방의 퀴즈 목록에서 비공개·일부공개가 맨 위에 표시와 함께 나온다
- 듣고맞추기에서만 쓴다. 문제 수는 퀴즈의 곡 전부
- 곡마다 "처음"·"하이라이트" 위치를 직접 정한다(영상+소리+큰 재생바, 끌기·지금 위치로·여기서 듣기·±1초). 자동(기본 켜짐) = 처음 0초, 하이라이트는 서버 DB 값(그 영상일 때만, 없으면 곡 길이 30%). 표시를 옮기면 자동이 꺼진다. 연령제한 영상은 서버가 받아 둔 음원으로 듣는다
- 퀴즈당 곡 수·계정당 퀴즈 수 제한은 관리자 → 사이트에서 정하고 기본은 무제한(0)
- 게임 중 "퀴즈 저장·불러오기"(진행 상황 저장)는 이름이 헷갈려서 "진행 저장·불러오기"로 바꿨다
- 플레이리스트 가져오기: 유튜브·유튜브 뮤직·스포티파이 주소를 .6 Lavalink(
LAVALINK_URL·LAVALINK_PW)로 읽는다(스포티파이 키로는 플레이리스트를 못 읽음). 서버 DB에 있는 곡은 그 곡, 유튜브는 그 영상(제목의 Official MV 등 정리), 스포티파이는 유튜브 뮤직에서 원곡 찾기와 같은 기준으로 찾고 애매하면 "확인 필요". 결과에서 고른 곡만 뒤에 추가하거나 목록을 바꾼다 - 검토 대기(관리자 → 검토 대기): 전체공개로 저장하면 서버 DB에 없는 곡과 DB와 영상·제목·가수·직접 정한 하이라이트가 다른 곡이 올라간다. 다른 값은 항목마다 "DB 유지 / 퀴즈 값"을 고르고, 없는 곡은 연도·장르·난이도를 채워 추가한다(퀴즈 곡이 그 DB 곡과 연결됨). 복수정답은 DB 별칭에 들어가고, 한 번 정한 값(항목+값)은 다시 묻지 않는다
- 플레이 통계: 문제마다 힌트(시간/투표), 정답이 아닌 입력 수와 사람 수, 다시듣기 수, 제작된 퀴즈·곡을 함께 저장(DB에 없는 퀴즈 곡도 퀴즈 통계에 들어감). 관리자 통계는 곡별·퀴즈별 탭. 난이도 제안은 힌트도 본다(80% 넘게 8초 안에 힌트 30% 미만 → 쉽게, 30% 이하 또는 50% 이하+힌트 60% 이상 → 어렵게)이고 검토 대기 → 난이도 조정에 근거와 함께 나온다. "반영 안 함"은 5번 더 나온 뒤 다시 계산
이지선다 (2026-10-22~23, 사용자 답변)
- 조회수가 더 높은 곡을 고르는 모드. 곡 목록과 조회수는 사용자가 파일(.xlsx·.csv: 영상 링크·제목·가수·조회수, 조회수는 1,234,567·123만·1.2억도 읽음)로 올린다. 서버가 조회수를 모으지 않는다. 조회수 없는 줄은 빠진다
- 이지선다 퀴즈(
custom_quizzes.kind = 'duel',custom_quiz_items.views)는 이지선다에서만, 일반 퀴즈는 듣고맞추기에서만 쓴다. 파일로 만들기에서 조회수 열이 있으면 이지선다로 골라진다 - 문제마다 곡 2개를 무작위로 A/B 카드(썸네일·제목·가수)에 놓는다. 진행 방식은 방에서 고른다: 매번 새 두 곡 / 연속(조회수가 더 높은 곡이 조회수를 보인 채 A로 남고 새 곡이 B로 들어옴, 같으면 A가 남음). 틀려도 탈락 없이 곡이 떨어질 때까지 계속
- 카드를 누르면 그 곡이 자기 화면에서만 재생되고(모두 같은 순간에 듣지 않음), 누른 카드가 그 사람의 선택이다. 다른 카드를 누르면 그 곡으로 바뀌고, 다시 누르면 멈춘 곳부터 이어서 나온다(카드마다 숨은 플레이어 하나). 재생 중인 카드를 또 누르면 멈춘다. 선택은 제한 시간 전까지 몇 번이든 바꿀 수 있고, 고른 사람의 프로필이 카드 밑에 바로 보인다
- 제한 시간 기본 30초(방 설정). 시간이 끝나면 두 곡의 조회수를 공개하고 높은 쪽을 고른 사람이 1점. 역배: 맞힌 사람이 딱 1명이고 반대쪽에 2명 이상이면 2점(4:1에서 혼자 맞히면 2점, 1:1·3:2는 1점). 안 고른 사람은 0점(감점 없음), 조회수가 같으면 둘 다 정답
- 결과 화면은 점수·맞힌 문제·역배 성공 수, 곡 목록에 두 곡과 조회수와 받은 점수
원곡 찾기 자동 확정 기준 (2026-10-22)
- 제목 일치 + 가수 일치(라틴 악센트 무시 JAŸ-Z=JAY-Z,
및·with·feat 구분, 앞 The 무시, 확정곡 2곡 이상에서 확인된 한글/영문 이름 짝 태연=TAEYEON) + 길이 차이 15초 이내 + 커버·노래방·라이브·다른 버전 아님. "Radio Edit/Original Version"은 같은 녹음으로 본다 - 쌓인 후보는
cli.ts reconfirm-youtube로 저장된 검색 결과를 다시 비교했다(2,313곡 중 282곡 확정). 관리자 원곡 찾기 목록은 채널 이름 대신 실제 가수와 확정 안 된 이유를 보여 준다
원곡 찾기 자동 확정 기준 2차 (2026-10-29, 사용자 확인)
- 제목 + 가수가 맞으면 곡 길이가 달라도 확정(다른 녹음·멜론 길이 오류). 결과(검색 줄 제목이든 실제 영상 제목이든)가 MV·가사 영상·inst.·라이브·커버면 길이와 관계없이 확정하지 않는다. 노래 제목에 있는 표시는 그 표시만 그 개수만큼 예외(
Live Wire는 live 하나만 허용,(Inst.)·(Cover)·두 번째 Live는 보류,Remix Version=remix 하나). 길이가 15초 넘게 다를 때는 노래 제목에 없는 믹스/에디트/버전/연도((Sleep Mix),(2021))가 붙었거나, 제목이 Intro·Outro처럼 흔하거나, 멜론은 보통 길이(90초 이상)인데 영상이 90초 미만이거나 7분 넘으면서 2배 넘게 길면(인트로·짧은 버전·메가믹스) 보류. 실제 영상 제목(oEmbed)도 같은 기준으로 한 번 더 본다. 리마스터는 같은 녹음. 공식 Topic이 아닌 일반 유튜브 영상은 길이 무시 안 함 - "한글 English" 표기 나눠 비교:
북극성 Polaris,헤이즈 Heize,더 클래식 The Classic(괄호 없이 띄어쓰기로 붙은 것). 제목을 나눠 맞춘 것은 가수도 맞을 때만 인정(다른 가수의작은 촛불 Little Flame과 길이가 같다고 확정하지 않음). 뒤 영어가 몇 번째 곡을 뜻하면(Part 2,I,Vol.1) 나누지 않고,/·+로 여러 곡을 이은 메들리도 나누지 않음 - 한글/영문 가수 이름은 발음으로 비교(
collector/sound.ts): 자음 뼈대가 같고,Park Jung Hyun처럼 로마자 한국 이름이면 모음 계열(아/에/오/이)도 같아야 함. 성이 뒤로 간 이름(Bo Kyung Kim), 알파벳 읽기(DJ DOC=디제이디오씨,S.E.S.=에스이에스) 포함. 발음으로만 맞은 곡은 제목이 같고 길이 차이 8초 이내일 때만 확정 - 다른 문자 이름으로 다시 검색: 결과에 그 가수의 곡이 하나도 없으면, 저장된 검색 결과에서 발음이 같은 다른 문자 이름(
DJ DOC)을 찾아이름 제목으로 한 번 더 검색(매일 원곡 찾기에 포함). 이 검색 결과는 그 가수 곡일 때만 확정. 이미 쌓인 후보는cli.ts research-youtube(검색 방법별 한 번씩,yt_research_<source>) - 운영 적용:
reconfirm-youtube가 후보·못 찾음 곡까지 다시 비교