Files
music_quiz/docs/08-youtube-playback.md

7.7 KiB
Raw Blame History

08. 유튜브 Topic 주소 찾기 · 재생 · 하이라이트

1. 유튜브 Topic 음원 주소 찾기

"Topic" 채널(가수명 - Topic)에 올라오는 영상은 음원사가 유튜브에 직접 제공하는 공식 음원(Art Track)이다. 뮤직비디오와 달리 인트로·대사·광고성 장면이 없어서 퀴즈용으로 가장 깔끔하다.

사용하는 것

  • music_bot_v2 (git.tkrmagid.kr/tkrmagid/music_bot_v2)의 유튜브 뮤직 검색 코드 bot/src/utils/api/YoutubeMusic.ts
    • music.youtube.com/youtubei/v1/search를 WEB_REMIX 클라이언트로 호출, 쿠키 + SAPISIDHASH로 인증, 커버/MR/노래방 결과를 뒤로 미는 JUNK_RE 필터 포함
  • Lavalink (192.168.10.6:2333, v4.2.2, youtube-plugin 1.18.2 + LavaSrc 4.8.3)
    • 후보 검색 보조(ytsearch:), 재생 가능 여부·길이 확인(/v4/loadtracks?identifier=https://youtu.be/ID)

직접 확인한 사실 (2026-10-18)

시험 결과
Lavalink ytmsearch:아이유 Love wins all HTTP 200, empty (music_bot_v2 코드 주석대로 ytmsearch는 비어서 못 씀)
로그인 없이 YT Music 검색 API 아티스트/재생목록만 나오고 "노래" 탭이 아예 없음 → 쿠키 인증이 필요
일반 유튜브 검색 SG워너비 광(狂) 1위 광 (狂) / 채널 SG Wannabe - Topic ✔
일반 유튜브 검색 이문세 깊은 밤을 날아서 아티스트 공식 채널의 Art Track(제목이 곡명 그대로) ✔
일반 유튜브 검색 아이유 Love wins all 상위 6개에 Topic 없음(MV·라이브만) → YT Music 노래 검색이 꼭 필요한 경우
yt-dlp https://youtu.be/VO88htcm09E (광) 채널 SG Wannabe - Topic, 설명 Provided to YouTube by Genie Music, 길이 237초, 가장 많이 다시 본 구간 75.8초(후렴)
yt-dlp JleoAppaxi0 (Love wins all MV) 가장 많이 다시 본 구간 161.5초
ytm_cookie.txt로 YT Music 노래 검색 아이유 Love wins all HTTP 200, 로그인 상태, 노래 결과 1위 Wu5FY8J6P8Q Love wins all (4:32) ✔
oEmbed 퍼가기 확인 Wu5FY8J6P8Q, VO88htcm09E, GXNHaLIhyMY 모두 200(퍼가기 허용) ✔

매칭 순서 (tools/collector/youtube-match.ts)

  1. YT Music 노래 검색(music_bot_v2 방식, 사용자가 준 ytm_cookie.txt 쿠키 인증 — 봇 쿠키와 분리) "{가수} {제목}" → 노래 결과의 videoId
    • music.youtube.com/watch?v=ID 주소를 www.youtube.com/watch?v=ID로 바꾸고 최종 저장은 https://youtu.be/ID
  2. 못 찾으면 일반 유튜브 검색 "{가수} {제목}", "{가수} - Topic {제목}" → 채널명이 - Topic으로 끝나는 결과 우선
  3. 그래도 없으면 Lavalink ytsearch: 결과 중 author가 - Topic으로 끝나는 것
  4. 후보 점수 매기기
    • 채널 - Topic +50, 영상 설명에 Provided to YouTube by +30, 공식 아티스트 채널 +15
    • 제목 일치(정규화 후) +30, 가수 일치 +20
    • 길이가 멜론 곡 길이와 ±5초 +20, ±15초 초과 −30
    • MV, Live, 커버, cover, MR, inst, 노래방, 1시간, 가사, lyrics, sped up, remix(원곡이 리믹스가 아닐 때) −40
  5. 최고 점수 ≥ 80 → 자동 확정(matched), 50~79 → candidate(관리자 확인 대기), 그 아래 → none
  6. 확정된 주소는 Lavalink loadtracks로 한 번 더 재생 가능 확인(지역 제한·삭제 영상 걸러냄) + oEmbed로 퍼가기 허용 확인(IFrame 재생이라 필수), 주 1회 재확인

요청 속도

  • 곡당 검색 1~3회, 2초 간격, 하루 최대 3,000곡. 차단 신호(HTTP 429, 봇 확인 페이지) 보이면 자동 중단 후 다음 날 재개

2. 재생 방식

확정: B안(숨긴 IFrame 플레이어) + 서버 기준 동기화. 자세한 동기화 규칙은 12-decisions.md Q1. 아래 A안은 검토 기록으로만 남긴다.

A안: 서버 음원 캐시 + 구간 스트리밍 (추천)

  • 서버가 yt-dlp로 해당 곡 음원만 받아(opus/m4a, 곡당 3~5MB) 디스크 캐시에 두고, 문제마다 필요한 구간만 ffmpeg로 잘라 일회용 주소(/api/audio/{토큰})로 보낸다
  • 장점
    • 정답이 새지 않음: 브라우저에 유튜브 ID나 제목이 전혀 안 감(유튜브 플레이어를 쓰면 개발자도구로 영상 ID가 보여서 검색 한 번이면 정답)
    • 광고 없음: 공식 음원은 수익화 영상이라 유튜브 플레이어로 틀면 문제 도중 광고가 나올 수 있음
    • 정확한 길이: 1초/3초도 정확히 그 길이만 재생, 하이라이트 시작점도 정확
    • 모두 같은 순간에 시작(서버 기준 시각에 맞춰 재생)
  • 단점: 서버가 음원을 받는 시간(곡당 2~5초, 다음 곡을 미리 받아서 감춤), 디스크 사용(캐시 상한 5GB ≈ 1,200곡, 오래 안 쓴 것부터 삭제), 유튜브 차단 대응 필요(music_bot_v2의 쿠키·poToken 갱신 방식 재사용)

B안: 유튜브 플레이어(IFrame)를 화면 뒤에 숨겨서 재생 — 채택

  • 장점: 서버 부담 없음, 음원 캐시 디스크 불필요
  • 약점과 대응
    • 영상 ID 노출 → 준비 단계에만 전송, 방 상태에 미포함(완전 차단은 불가, 사용자 감수)
    • 광고 → 준비 단계에서 음소거로 먼저 재생해 광고를 흘려보내고, 실제 곡이 재생되기 시작한 뒤에야 audioReady
    • 소리 차단(자동재생 정책) → 입장 때 참가 (소리 켜기) 클릭으로 허용받고, 재생 직후 음소거 해제·재생 상태를 확인, onAutoplayBlocked나 확인 실패면 모두 멈추고 그 사람에게 눌러서 소리 켜기
    • 버퍼링·준비 실패 → 전원 준비 전에는 시작하지 않음, 재생 중 버퍼링이면 모두 일시정지 후 같은 위치에서 재개(시간 상한으로 자동 진행 안 함, 30초 넘으면 방장이 그 사람만 이번 문제 제외 가능)
    • 1초 모드 오차 → 시계가 아니라 재생 위치를 보고 정지, 1초마다 위치 보정
    • 실제 브라우저 시험 결과와 남은 수동 검증 목록은 12-decisions.md Q1
    • 퍼가기 금지 영상 → 매칭 때 oEmbed(https://www.youtube.com/oembed?url=https://youtu.be/ID)가 401이면 제외, 재생 오류 101/150이면 건너뛰고 "재생 불가" 표시

3. 재생 위치 "처음부터 / 하이라이트부터"

하이라이트 = 그 곡에서 가장 유명한 부분(대개 후렴). 곡마다 highlight_ms를 저장한다.

구하는 순서

  1. 유튜브 "가장 많이 다시 본 구간" — 조회수가 충분한 영상은 yt-dlp가 재생 구간별 인기도(heatmap)를 준다. 가장 높은 구간 시작점을 쓴다(MV와 Topic 영상 길이가 같으면 MV 쪽 heatmap도 활용)
  2. 음원 분석 — (관리자가 일괄 실행할 때만) 음원을 잠깐 받아 반복 구간(후렴) 찾기(크로마 자기유사도 방식, Python librosa, 곡당 1~2초, 메모리 300MB 이하)
  3. 관리자 지정 — 관리자 노래 편집 화면에서 미리듣기 중 "지금 위치를 하이라이트로" 버튼
  4. 셋 다 없으면 곡 길이의 30% 지점(대부분 첫 후렴 근처)
  • 우선순위: 관리자 지정 > heatmap > 음원 분석 > 30% 규칙
  • "듣고맞출시간"이 하이라이트 이후 남은 길이보다 길면 남은 곳까지만

4. 가사 (가사보고 맞추기)

  • 멜론 곡 상세 페이지의 가사를 수집해 DB에 저장(가사 없는 곡은 이 모드에서 제외)
  • 출제할 때 보여줄 부분: 후렴 아닌 1절 가운데 4줄 → 시간이 지나거나 힌트를 쓰면 2줄씩 추가
  • 가사 안에 제목 단어가 있으면 ○○로 가림 (예: "사건의 지평선" → "○○○ ○○○")
  • 영어 가사만 있는 곡은 그대로, 일본어 곡은 원문(번역 없음)