문서: 제한 시간·힌트는 문제 경과 시간(전체 일시정지만 제외)으로, 클립은 재생 위치로 정지 — 클립 단계 +3초 처리 명시. 시험 도구를 위치 기준 정지·클릭 내 소리 허용으로 고쳐 재실행한 결과 반영

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-18 19:33:53 +09:00
parent 0a55c9d6e7
commit 7ae34c49c1
3 changed files with 49 additions and 24 deletions

View File

@@ -34,19 +34,26 @@
- 접속이 끊긴 사람은 기다리지 않는다(다시 들어오면 다음 문제부터) - 접속이 끊긴 사람은 기다리지 않는다(다시 들어오면 다음 문제부터)
- **소리 확인**: 재생 직후 0.3초 안에 `isMuted() == false` 이고 `PLAYING` 인지 확인한다. 아니거나 `onAutoplayBlocked` 이벤트가 오면 `blocked` 보고 → 아래 버퍼링과 똑같이 **모두 일시정지**, 그 사람 화면에 크게 `눌러서 소리 켜기` 버튼 → 누르면 다시 준비 → 모두 같은 위치에서 재개 - **소리 확인**: 재생 직후 0.3초 안에 `isMuted() == false` 이고 `PLAYING` 인지 확인한다. 아니거나 `onAutoplayBlocked` 이벤트가 오면 `blocked` 보고 → 아래 버퍼링과 똑같이 **모두 일시정지**, 그 사람 화면에 크게 `눌러서 소리 켜기` 버튼 → 누르면 다시 준비 → 모두 같은 위치에서 재개
- **재생 중 버퍼링**: 클라이언트가 0.5초 넘게 버퍼링하면 `stall` 보고 → 서버가 **모두 일시정지** → 그 사람이 다시 준비되면 새 `play{startAt, atSec}`로 모두 같은 위치에서 재개. 시간 상한으로 자동 진행하지 않고, 30초 넘게 멈춰 있으면 준비 단계와 같은 방장 버튼만 보인다 - **재생 중 버퍼링**: 클라이언트가 0.5초 넘게 버퍼링하면 `stall` 보고 → 서버가 **모두 일시정지** → 그 사람이 다시 준비되면 새 `play{startAt, atSec}`로 모두 같은 위치에서 재개. 시간 상한으로 자동 진행하지 않고, 30초 넘게 멈춰 있으면 준비 단계와 같은 방장 버튼만 보인다
- **일시정지 중 시간 처리**: 문제 제한 시간, 힌트 자동 공개 시간, 짧은 클립 정지 시각은 모두 **실제로 재생된 시간** 기준으로 센다 → 멈춘 동안은 줄지 않는다. 화면 타이머도 멈추고 `잠시 멈춤 — 철수님 버퍼링 중` 표시. 채팅과 정답 입력은 계속 받는다(모두 같은 위치까지 들은 상태라 공평) - **시간 두 종류로 나눠 센다**
- **클립 정지(1초~1분)**: 시계가 아니라 **재생 위치** 기준(아래 "재생 길이")
- **문제 제한 시간·힌트 자동 공개 시간**: 문제 시작(첫 `play`)부터 흐른 시간에서 **모두 멈춰 있던 시간(버퍼링·소리 차단·준비 대기로 인한 전체 일시정지)만 뺀 값**. 클립이 정상적으로 끝난 뒤에도 이 시간은 **계속 흐른다** → 1초 클립이 끝나도 15초 힌트, 60초 제한 시간에 정상 도달
- 전체 일시정지 중에는 화면 타이머도 멈추고 `잠시 멈춤 — 철수님 버퍼링 중` 표시. 채팅과 정답 입력은 계속 받는다(모두 같은 위치까지 들은 상태라 공평)
- **오차 보정**: 1초마다 `getCurrentTime()`과 기대 위치를 비교해 0.3초 넘게 어긋나면 그 위치로 이동 - **오차 보정**: 1초마다 `getCurrentTime()`과 기대 위치를 비교해 0.3초 넘게 어긋나면 그 위치로 이동
- **재생 길이(1초~1분)**: 시계로 멈추지 않고 **재생 위치**를 보고 멈춘다(`getCurrentTime() >= 시작 + 길이` 를 화면 갱신마다 검사, 오차 약 0.02초). 서버는 모든 클라이언트가 클립을 끝냈다고 보고하거나 예상 시각 + 3초가 지나면 다음 단계로 - **재생 길이(1초~1분)**: 시계로 멈추지 않고 **재생 위치**를 보고 멈춘다(`getCurrentTime() >= 시작 + 길이` 를 화면 갱신마다 + 10ms마다 검사). 실제 브라우저 시험에서 멈춘 위치 오차 −0.002~+0.010초(아래 표)
- 각 클라이언트는 클립을 끝내면 `clipEnd` 보고. 서버는 전원 보고가 오거나 **예상 끝 시각 + 3초**가 지나면 클립 단계를 끝낸다 — 보고가 안 온 클라이언트가 있어도 그 화면에 정지 명령을 한 번 더 보내고, **문제 자체는 끝내지 않는다**(정답 입력과 남은 제한 시간은 그대로 진행)
- 이 3초 때문에 생기는 차이는 제한 시간 계산에 영향 없음(제한 시간은 위 규칙대로 문제 시작부터 셈)
- **정답 노출 줄이기**: 플레이어는 화면 밖에 숨기고 제목 표시 없음. 영상 ID는 준비 단계에서만 보내고 방 상태에는 넣지 않는다. (개발자도구로 보는 것까지는 막을 수 없음 — 사용자가 감수하기로 함) - **정답 노출 줄이기**: 플레이어는 화면 밖에 숨기고 제목 표시 없음. 영상 ID는 준비 단계에서만 보내고 방 상태에는 넣지 않는다. (개발자도구로 보는 것까지는 막을 수 없음 — 사용자가 감수하기로 함)
- **퍼가기 금지 영상**: 노래 DB 매칭 때 oEmbed로 퍼가기 가능 여부를 확인해 안 되는 영상은 쓰지 않는다(07·08). 재생 중 오류 코드 101/150이 오면 그 곡은 건너뛰고 관리자 "재생 불가"로 표시 - **퍼가기 금지 영상**: 노래 DB 매칭 때 oEmbed로 퍼가기 가능 여부를 확인해 안 되는 영상은 쓰지 않는다(07·08). 재생 중 오류 코드 101/150이 오면 그 곡은 건너뛰고 관리자 "재생 불가"로 표시
- **실제 브라우저 시험 (2026-10-18, `tools/prototypes/iframe-sync/run.ts`)**: 시스템 Chrome, 자동재생 정책 `document-user-activation-required`, 곡 `VO88htcm09E`(광, Topic) 60초 지점 - **실제 브라우저 시험 (2026-10-18, `tools/prototypes/iframe-sync/run.ts`)**: 시스템 Chrome, 자동재생 정책 `document-user-activation-required`, 곡 `VO88htcm09E`(광, Topic) 60초 지점
| 항목 | 결과 (4회 반복) | | 항목 | 결과 |
|---|---| |---|---|
| 음소거 준비 시간 | 0.30~0.48초 (12회 중 11회). **1회는 23초 동안 준비 실패** → 다시 불러오기·대기 규칙이 꼭 필요함을 확인 | | 음소거 준비 시간 | 처음 시험 15회 중 14회 0.30~0.48초, **1회는 23초 동안 준비 실패** → 다시 불러오기·대기 규칙이 꼭 필요함을 확인. 고친 도구로 8회 반복(24회)은 모두 0.26~0.52초 |
| 3명 동시 시작 후 위치 차이 | 2초 뒤 8~29ms → 10초 뒤 25~47ms (보정 기준 0.3초보다 훨씬 작음) | | 입장 클릭으로 소리 허용 | 클릭 안에서 곡을 소리 켠 채 불러 재생 → 4회 모두 재생 성공·음소거 아님. (처음엔 빈 플레이어에 재생을 걸어 오류 2가 났음 → 클릭 안에서 곡을 직접 불러오는 방식으로 고침) |
| 1초 클립(시계 기준 정지) | 실제 0.93~1.00초 → 그래서 위의 "재생 위치 기준 정지"로 바꿈 | | 3명 동시 시작 후 위치 차이 | 2초 뒤 8~29ms → 10초 뒤 20~48ms (보정 기준 0.3초보다 훨씬 작음) |
| 클릭 없이 음소거 해제 | 이 환경에서는 막히지 않았음. 하지만 사파리·휴대폰은 더 엄격해서 입장 클릭과 소리 확인 절차를 그대로 둔다 | | 1초 클립, 시계 기준 정지(처음 방식) | 실제 0.93~1.00초 → 위치 기준으로 바꿈 |
| 광고 | 자동 시험에서는 광고가 나오지 않아 확인 못 함 | | 1초 클립, **위치 기준 정지(지금 방식)** | 멈춘 위치 오차 −0.002~+0.010초 (4회 × 3명 + 클릭 없는 경우 4회) |
| 클릭 없이 음소거 해제 | 이 환경(헤드리스 크롬)에서는 막히지 않았음. 사파리·휴대폰은 더 엄격하므로 입장 클릭·소리 확인 절차를 그대로 둔다 |
| 광고 | 자동 시험에서는 광고가 나오지 않아 **미검증** |
- **남은 검증 (5단계에서 사람이 직접)**: 프리미엄이 아닌 계정의 실제 PC 크롬·엣지, 아이폰 사파리, 안드로이드 크롬에서 광고가 붙는 곡, 입장 클릭 없이 들어온 경우, 1초 클립, 3명 이상 동시 시작을 확인하고 결과를 이 문서에 적는다 - **남은 검증 (5단계에서 사람이 직접)**: 프리미엄이 아닌 계정의 실제 PC 크롬·엣지, 아이폰 사파리, 안드로이드 크롬에서 광고가 붙는 곡, 입장 클릭 없이 들어온 경우, 1초 클립, 3명 이상 동시 시작을 확인하고 결과를 이 문서에 적는다
- 서버 음원 캐시(A안)는 만들지 않는다 → yt-dlp·ffmpeg·음원 캐시 디스크 상한 항목은 하이라이트 분석용 일회성 처리 외에는 없음 - 서버 음원 캐시(A안)는 만들지 않는다 → yt-dlp·ffmpeg·음원 캐시 디스크 상한 항목은 하이라이트 분석용 일회성 처리 외에는 없음

View File

@@ -31,7 +31,13 @@ const waitState = (want, ms) => new Promise(res => {
}, 20); }, 20);
}); });
// gesture unlock: called from the join button click handler // gesture unlock: called from the join button click handler
document.getElementById('join').onclick = () => { ev('gesture'); window.__gesture = true; }; // Unlock inside the click: play the cued video unmuted once, then pause (docs/12 Q1 "소리 허용").
document.getElementById('join').onclick = () => {
ev('gesture');
// load+play unmuted inside the user gesture (window.__unlock = {id, start} set by the page/app)
player.unMute(); player.loadVideoById({ videoId: window.__unlock.id, startSeconds: window.__unlock.start });
waitState(YT.PlayerState.PLAYING, 5000).then(ok => { ev('unlock', { ok, muted: player.isMuted() }); player.pauseVideo(); });
};
window.probe = { window.probe = {
log, apiReady: () => apiReady, log, apiReady: () => apiReady,
// Prepare: muted load at startSec, wait until really playing, then pause -> ready // Prepare: muted load at startSec, wait until really playing, then pause -> ready
@@ -45,21 +51,28 @@ window.probe = {
player.seekTo(startSec, true); player.seekTo(startSec, true);
return { ok, ms: Math.round(performance.now() - t0), dur: player.getDuration(), at: player.getCurrentTime() }; return { ok, ms: Math.round(performance.now() - t0), dur: player.getDuration(), at: player.getCurrentTime() };
}, },
// Play unmuted at wall-clock epoch ms `at`, stop after clipMs (0 = keep playing) setUnlock(id, start) { window.__unlock = { id, start }; },
play(at, clipMs) { // Play unmuted at wall-clock epoch ms `at`. clipSec > 0: stop by PLAYBACK POSITION
// (getCurrentTime() >= startSec + clipSec), checked every animation frame + 10ms timer.
play(at, startSec, clipSec) {
return new Promise(res => { return new Promise(res => {
setTimeout(async () => { setTimeout(async () => {
const startWall = Date.now();
player.unMute(); player.playVideo(); player.unMute(); player.playVideo();
const playing = await waitState(YT.PlayerState.PLAYING, 5000); const playing = await waitState(YT.PlayerState.PLAYING, 5000);
const firstPlayingWall = Date.now(); const lateMs = Date.now() - at;
const muted = player.isMuted(); const muted = player.isMuted();
if (!clipMs) return res({ playing, muted, lateMs: firstPlayingWall - at }); if (!clipSec) return res({ playing, muted, lateMs });
setTimeout(() => { const end = startSec + clipSec;
const pos = player.getCurrentTime(); let done = false;
player.pauseVideo(); const check = () => {
res({ playing, muted, lateMs: firstPlayingWall - at, startWall, stopPos: pos }); if (done) return;
}, at + clipMs - Date.now()); if (player.getCurrentTime() >= end) {
done = true; clearInterval(iv); player.pauseVideo();
setTimeout(() => res({ playing, muted, lateMs, stopPos: player.getCurrentTime(), errSec: player.getCurrentTime() - end }), 300);
} else requestAnimationFrame(check);
};
const iv = setInterval(check, 10);
requestAnimationFrame(check);
}, Math.max(0, at - Date.now())); }, Math.max(0, at - Date.now()));
}); });
}, },

View File

@@ -1,7 +1,8 @@
// Real-browser probe of the hidden YouTube IFrame playback design (docs/12-decisions.md Q1). // Real-browser probe of the hidden YouTube IFrame playback design (docs/12-decisions.md Q1).
// Usage: bun tools/prototypes/iframe-sync/run.ts (needs playwright-core + /usr/bin/google-chrome) // Usage: bun tools/prototypes/iframe-sync/run.ts (needs playwright-core + /usr/bin/google-chrome)
// Checks: autoplay policy with/without a user gesture, prepare (muted preload) time, // Checks: autoplay policy with/without a user gesture, prepare (muted preload) time,
// synchronized unmuted start across 3 clients, 1-second clip accuracy, drift over 10s. // synchronized unmuted start across 3 clients, 1-second clip stopped by playback position
// (errSec = stop position - (start + 1s)), drift over 10s.
import { chromium } from "playwright-core"; import { chromium } from "playwright-core";
const html = await Bun.file(new URL("./player.html", import.meta.url)).text(); const html = await Bun.file(new URL("./player.html", import.meta.url)).text();
@@ -19,7 +20,11 @@ async function client(gesture: boolean) {
const page = await ctx.newPage(); const page = await ctx.newPage();
await page.goto(url); await page.goto(url);
await page.evaluate(() => (window as any).probe.apiReady()); await page.evaluate(() => (window as any).probe.apiReady());
if (gesture) await page.click("#join"); if (gesture) {
await page.evaluate(([v, s]) => (window as any).probe.setUnlock(v, s), [VIDEO, START] as const);
await page.click("#join");
await page.waitForFunction(() => (window as any).probe.log.some((e: any) => e.k === "unlock"), null, { timeout: 15000 });
}
return page; return page;
} }
const p = (page: any, fn: string, ...a: any[]) => page.evaluate(([fn, a]: any) => (window as any).probe[fn](...a), [fn, a]); const p = (page: any, fn: string, ...a: any[]) => page.evaluate(([fn, a]: any) => (window as any).probe[fn](...a), [fn, a]);
@@ -30,7 +35,7 @@ const out: Record<string, unknown> = {};
{ {
const page = await client(false); const page = await client(false);
out.noGesture_prepare = await p(page, "prepare", VIDEO, START); out.noGesture_prepare = await p(page, "prepare", VIDEO, START);
out.noGesture_play = await p(page, "play", Date.now() + 300, 1500); out.noGesture_play = await p(page, "play", Date.now() + 300, START, 1);
out.noGesture_events = (await page.evaluate(() => (window as any).probe.log)).filter((e: any) => e.k !== "state"); out.noGesture_events = (await page.evaluate(() => (window as any).probe.log)).filter((e: any) => e.k !== "state");
await page.context().close(); await page.context().close();
} }
@@ -40,11 +45,11 @@ const out: Record<string, unknown> = {};
const pages = await Promise.all([client(true), client(true), client(true)]); const pages = await Promise.all([client(true), client(true), client(true)]);
out.prepare = await Promise.all(pages.map(pg => p(pg, "prepare", VIDEO, START))); out.prepare = await Promise.all(pages.map(pg => p(pg, "prepare", VIDEO, START)));
const at = Date.now() + 800; const at = Date.now() + 800;
out.clip1s = await Promise.all(pages.map(pg => p(pg, "play", at, 1000))); out.clip1s = await Promise.all(pages.map(pg => p(pg, "play", at, START, 1)));
// drift: re-prepare then play 10s continuously, sample positions at the same wall instants // drift: re-prepare then play 10s continuously, sample positions at the same wall instants
await Promise.all(pages.map(pg => p(pg, "prepare", VIDEO, START))); await Promise.all(pages.map(pg => p(pg, "prepare", VIDEO, START)));
const at2 = Date.now() + 800; const at2 = Date.now() + 800;
out.longStart = await Promise.all(pages.map(pg => p(pg, "play", at2, 0))); out.longStart = await Promise.all(pages.map(pg => p(pg, "play", at2, START, 0)));
const samples: number[][] = []; const samples: number[][] = [];
for (let i = 0; i < 5; i++) { for (let i = 0; i < 5; i++) {
await Bun.sleep(2000); await Bun.sleep(2000);