463 lines
23 KiB
JavaScript
463 lines
23 KiB
JavaScript
/**
|
||
* 节拍行者（rhythm）无头试玩测试 —— docs/design/13-playtest-criteria.md §4 + §7。
|
||
*
|
||
* 方法：mock 浏览器/WebAudio 最小接口（window/document/navigator/localStorage/
|
||
* fetch/AudioContext），加载**真实** engine（audio.js/settings.js/haptics.js）
|
||
* 与 game.js；手势直接注入 game.onGesture（任务书允许的更稳路径）；虚拟时钟
|
||
* 驱动 setTimeout/setInterval/performance.now/ctx.currentTime，voice 链由引擎
|
||
* 真实 SoundTouch 结束定时器推进，零真实等待。
|
||
*
|
||
* 运行（仓库根）：tools/node/bin/node web/rhythm/test/playtest.mjs
|
||
*/
|
||
import { readFileSync, existsSync } from 'node:fs';
|
||
|
||
// ================= 虚拟时钟 =================
|
||
let nowMs = 0;
|
||
let timerSeq = 1;
|
||
const timers = new Map(); // id -> { t, fn, iv }
|
||
|
||
globalThis.setTimeout = (fn, ms = 0, ...args) => {
|
||
const id = timerSeq++;
|
||
timers.set(id, { t: nowMs + Math.max(0, ms), fn: () => fn(...args), iv: 0 });
|
||
return id;
|
||
};
|
||
globalThis.setInterval = (fn, ms = 1) => {
|
||
const id = timerSeq++;
|
||
timers.set(id, { t: nowMs + ms, fn, iv: ms });
|
||
return id;
|
||
};
|
||
globalThis.clearTimeout = (id) => timers.delete(id);
|
||
globalThis.clearInterval = (id) => timers.delete(id);
|
||
Object.defineProperty(globalThis, 'performance', { value: { now: () => nowMs }, configurable: true });
|
||
|
||
async function flush() {
|
||
for (let i = 0; i < 4; i++) await new Promise((r) => setImmediate(r));
|
||
}
|
||
/** 推进虚拟时钟 ms 毫秒，沿途触发到期的 timeout/interval 并冲刷微任务。 */
|
||
async function advance(ms) {
|
||
const target = nowMs + ms;
|
||
for (;;) {
|
||
await flush();
|
||
let nid = -1; let nt = Infinity;
|
||
for (const [id, t] of timers) if (t.t < nt) { nt = t.t; nid = id; }
|
||
if (nid < 0 || nt > target) break;
|
||
const timer = timers.get(nid);
|
||
nowMs = nt;
|
||
if (timer.iv) timer.t = nt + timer.iv; else timers.delete(nid);
|
||
timer.fn();
|
||
}
|
||
nowMs = target;
|
||
await flush();
|
||
}
|
||
const nowSec = () => nowMs / 1000;
|
||
async function runUntil(tSec) { await advance(Math.max(0, tSec * 1000 - nowMs)); }
|
||
async function waitFor(cond, label, maxMs = 40000) {
|
||
let t = 0;
|
||
while (!cond()) {
|
||
if (t >= maxMs) throw new Error('waitFor 超时: ' + label);
|
||
await advance(100); t += 100;
|
||
}
|
||
}
|
||
|
||
// ================= 浏览器环境 mock =================
|
||
const store = new Map();
|
||
globalThis.localStorage = {
|
||
getItem: (k) => (store.has(k) ? store.get(k) : null),
|
||
setItem: (k, v) => store.set(k, String(v)),
|
||
removeItem: (k) => store.delete(k),
|
||
clear: () => store.clear(),
|
||
};
|
||
|
||
const vibLog = []; // navigator.vibrate 调用记录（震型数组）
|
||
Object.defineProperty(globalThis, 'navigator', {
|
||
value: { vibrate: (p) => { vibLog.push(p); return true; } },
|
||
configurable: true,
|
||
});
|
||
|
||
const mkEl = () => ({
|
||
id: '', className: '', textContent: '', src: '', alt: '', offsetWidth: 0,
|
||
style: { setProperty() {} },
|
||
appendChild() {}, remove() {}, addEventListener() {},
|
||
});
|
||
globalThis.document = {
|
||
createElement: mkEl, getElementById: () => null, body: mkEl(),
|
||
};
|
||
globalThis.window = {
|
||
addEventListener() {}, location: { href: '' }, AudioContext: null, // 下方填充
|
||
};
|
||
|
||
// ================= Web Audio mock =================
|
||
const VOICE_DUR = 1.2; // 假 voice 时长（秒），短时长让虚拟时钟跑得快
|
||
const BGM_DUR = 64;
|
||
const SFX_DUR = 0.3;
|
||
const durFor = (url) => (url.includes('/voice/') ? VOICE_DUR : url.includes('/bgm/') ? BGM_DUR : SFX_DUR);
|
||
|
||
const srcLog = []; // BufferSource.start 记录 { url, when, offset }
|
||
class MockParam {
|
||
constructor(v = 0) { this.value = v; }
|
||
cancelScheduledValues() {}
|
||
setValueAtTime(v) { this.value = v; }
|
||
linearRampToValueAtTime(v) { this.value = v; }
|
||
}
|
||
class MockAudioContext {
|
||
constructor() { this.state = 'suspended'; this.destination = {}; this.sampleRate = 44100; }
|
||
get currentTime() { return nowSec(); }
|
||
async resume() { this.state = 'running'; }
|
||
createGain() { return { gain: new MockParam(1), connect() {}, disconnect() {} }; }
|
||
createDynamicsCompressor() {
|
||
return { threshold: new MockParam(), ratio: new MockParam(), attack: new MockParam(), release: new MockParam(), connect() {} };
|
||
}
|
||
createBufferSource() {
|
||
return {
|
||
buffer: null, loop: false, onended: null,
|
||
connect() {}, disconnect() {},
|
||
start(when = 0, offset = 0) { srcLog.push({ url: this.buffer?.__url ?? null, when, offset, at: nowMs }); },
|
||
stop() {},
|
||
};
|
||
}
|
||
createScriptProcessor() { return { connect() {}, disconnect() {}, onaudioprocess: null }; }
|
||
async decodeAudioData(raw) { return { duration: durFor(raw.__url || ''), __url: raw.__url }; }
|
||
}
|
||
window.AudioContext = MockAudioContext;
|
||
|
||
// ================= fetch mock（资产存在性由末尾 fs 校验单独保证） =================
|
||
const fetchLog = [];
|
||
const blocked = []; // 子串命中即 404（看门狗测试用）
|
||
globalThis.fetch = async (url, _opts) => {
|
||
fetchLog.push(url);
|
||
if (typeof url === 'string' && url.startsWith('/api/')) return { ok: true, json: async () => ({}) };
|
||
if (blocked.some((b) => String(url).includes(b))) return { ok: false, status: 404 };
|
||
return { ok: true, arrayBuffer: async () => ({ __url: url }) };
|
||
};
|
||
|
||
// ================= 断言框架 =================
|
||
let passed = 0; let failed = 0;
|
||
function assert(cond, msg) {
|
||
if (cond) { passed++; console.log(' ✓', msg); } else { failed++; console.error(' ✗ 失败:', msg); }
|
||
}
|
||
const uncaught = [];
|
||
process.on('uncaughtException', (e) => { uncaught.push(e); process.exitCode = 1; origConsoleError('UNCAUGHT', e); });
|
||
process.on('unhandledRejection', (e) => { uncaught.push(e); process.exitCode = 1; origConsoleError('UNHANDLED', e); });
|
||
const origConsoleError = console.error.bind(console);
|
||
let consoleErrors = 0;
|
||
console.error = (...a) => { consoleErrors++; origConsoleError(...a); };
|
||
|
||
// ================= 加载真实引擎与游戏 =================
|
||
const { WebAudioEngine } = await import('../../engine/audio.js');
|
||
const { settings } = await import('../../engine/settings.js');
|
||
const { RhythmGame } = await import('../game.js');
|
||
|
||
const PROGRESS_KEY = 'soundgame.rhythm.progress';
|
||
let audio = null; let game = null; let playLog = []; let gestures = 0;
|
||
|
||
async function newWorld(progress = null) {
|
||
store.clear();
|
||
if (progress) store.set(PROGRESS_KEY, JSON.stringify(progress));
|
||
settings.set({ voice: 'female', speed: 1.0, bgm: 1.0 });
|
||
nowMs = 0; timers.clear(); vibLog.length = 0; srcLog.length = 0; fetchLog.length = 0; blocked.length = 0;
|
||
audio = new WebAudioEngine('audio/');
|
||
playLog = [];
|
||
const origPlay = audio.play.bind(audio);
|
||
audio.play = (id, opts = {}) => { playLog.push({ id, t: nowMs }); return origPlay(id, opts); };
|
||
await audio.unlock();
|
||
game = new RhythmGame(audio, mkEl());
|
||
if (process.env.DEBUG) {
|
||
for (const m of ['_beginTutorial', '_tutLead', '_tutEvaluate', '_startSong', '_finish', '_enterSelect', '_openMenu', '_closeMenu']) {
|
||
const orig = game[m].bind(game);
|
||
game[m] = (...a) => { console.log(` [trace ${nowMs}ms] ${m} tutIdx=${game._tutIdx} fails=${game._tutFails} phase=${game.phase}`); return orig(...a); };
|
||
}
|
||
}
|
||
gestures = 0;
|
||
return game;
|
||
}
|
||
function G(g) { gestures++; game.onGesture(g); }
|
||
// voice 链断言用 playLog（play 调用顺序即播报顺序；fetchLog 会被 prewarm 预取污染）
|
||
const voicePlays = () => playLog.filter((p) => p.id.startsWith('voice/')).map((p) => p.id);
|
||
const lastVoice = () => { const v = voicePlays(); return v[v.length - 1] || ''; };
|
||
const voicePlayed = (id) => voicePlays().includes(id);
|
||
|
||
// 按 cue 期望时刻注入 Perfect 应答；tap 模拟真实回调延迟 +0.30s（补偿判定路径）
|
||
async function answerCue(cue) {
|
||
await runUntil(cue.expected + (cue.gesture === 'tap' ? 0.30 : 0));
|
||
G(cue.gesture);
|
||
await flush();
|
||
}
|
||
|
||
// ================= 场景 A：首局关键路径（教学→曲目一 S→解锁→结算 BGM→重开→下一首） =================
|
||
console.log('\n[场景 A] 首局：教学 T1-T3 → 曲目一全 Perfect → S 级解锁 → 结算');
|
||
await newWorld();
|
||
assert(game.phase === 'idle', '初始 phase idle');
|
||
game.start();
|
||
await flush();
|
||
assert(game.phase === 'intro', 'start 后进 intro');
|
||
assert(voicePlayed('voice/welcome'), 'welcome 旁白开始播放');
|
||
|
||
// —— 旁白跳过①：intro 阶段 voice 播放中单击 = skipVoice（链推进到 tut_1，不重头）——
|
||
assert(!!audio._voice, 'welcome 播放中（voice token 存在）');
|
||
G('tap'); // 单击跳过 welcome
|
||
await flush();
|
||
assert(lastVoice() === 'voice/tut_1', '单击跳过 welcome → 链推进到 tut_1');
|
||
|
||
// —— 教学 T1-T3：按 cues.expected 做手势（tap 注入在 expected+0.30 仍应判对）——
|
||
for (let step = 0; step < 3; step++) {
|
||
await waitFor(() => game._tutIdx === step && game.phase === 'tut'
|
||
&& game._cues.length > 0 && game._tutAttempts.length === 0, `T${step + 1} 领奏排程`);
|
||
assert(game._tutIdx === step, `教学步进 T${step + 1}（_tutIdx=${step}）`);
|
||
const leadNoteCount = srcLog.filter((s) => s.url && s.url.includes('/sfx/inst_')).length;
|
||
for (const cue of game._cues) await answerCue(cue);
|
||
assert(game._tutAttempts.every((a) => a.correct && Math.abs(a.dt) <= 0.25), `T${step + 1} 应答全部正确且在 Good 窗口内`);
|
||
assert(srcLog.filter((s) => s.url && s.url.includes('/sfx/inst_')).length > leadNoteCount, `T${step + 1} 领奏音符已排程播放`);
|
||
await runUntil(game._phaseEnd + 0.2); // 触发 _tutEvaluate
|
||
await flush();
|
||
}
|
||
assert(game._progress.tutorialDone === true, 'tutorialDone === true');
|
||
assert(JSON.parse(store.get(PROGRESS_KEY)).tutorialDone === true, 'localStorage 进度已持久化 tutorialDone');
|
||
assert(voicePlayed('voice/tut_done'), 'tut_done 播报');
|
||
|
||
// —— 曲目一 main：全部 Perfect ——
|
||
await waitFor(() => game.phase === 'main' && game._cues.length > 0, '曲目一 main 开始');
|
||
assert(game._song.id === 'song1' && game._songIdx === 0, '教学后进入曲目一');
|
||
assert(srcLog.some((s) => s.url && s.url.includes('/bgm/track90')), '曲目一 BGM track90 按网格启动');
|
||
const firstTapCue = game._cues.find((c) => c.gesture === 'tap');
|
||
for (const cue of game._cues) await answerCue(cue);
|
||
assert(firstTapCue.result === 'perfect', 'tap 补偿：expected+0.30s 注入的 tap 仍判 Perfect（回调时刻 -0.30s 判定）');
|
||
assert(game._stats.perfect === game._cues.length, `曲目一 31 个音符全部 Perfect（perfect=${game._stats.perfect}）`);
|
||
assert(game._stats.miss === 0 && game._stats.combo === game._cues.length, '无 Miss 且连击不断');
|
||
|
||
await waitFor(() => game.phase === 'end', '曲目一结算');
|
||
assert(game._grade() === 's', '全 Perfect 评级 S');
|
||
assert(game._progress.grades.song1 === 's', 'grades.song1 === "s"');
|
||
assert(game._progress.unlocked === 2, 'unlocked === 2（B 以上解锁下一首）');
|
||
await flush();
|
||
assert(voicePlayed('voice/grade_s'), 'grade_s 播报（结算语音链首句）');
|
||
|
||
// —— 旁白跳过②：结算语音链播放中单击 = 跳下一句，不是"再来一遍" ——
|
||
await waitFor(() => !!audio._voice, '结算语音链开始');
|
||
const phaseBeforeSkip = game.phase;
|
||
G('tap');
|
||
await flush();
|
||
assert(game.phase === 'end' && phaseBeforeSkip === 'end', '结算播报中单击 = 跳句（phase 保持 end，未误触重开）');
|
||
|
||
// —— 结算 BGM：语音链播完后淡入 bgm/menu（10 文档 §5）——
|
||
await waitFor(() => audio._bgm && audio._bgm.id === 'bgm/menu', '结算语音链播完后 menu pad 淡入');
|
||
assert(voicePlayed('voice/unlock_song2'), 'unlock_song2 播报（语音链后段）');
|
||
assert(true, '结算语音链播完后 bgm/menu 播放（引擎层）');
|
||
|
||
// —— 结算单击 = 同曲再来一遍；menu pad 应被 stopBgm(400) 停掉 ——
|
||
G('tap');
|
||
await flush();
|
||
assert(game.phase === 'main' && game._songIdx === 0, '结算单击 = 同曲再来一遍');
|
||
assert(audio._bgmWanted === null && audio._bgm === null, '选定曲目后 menu pad 停止（stopBgm(400)）');
|
||
assert(srcLog.filter((s) => s.url && s.url.includes('/bgm/track90')).length >= 2, '曲目一 BGM 重新按网格启动');
|
||
|
||
// —— 钩子快进结算 → 右滑 = 下一首（song2 已解锁） ——
|
||
game._finish(game._runId);
|
||
await flush();
|
||
assert(game.phase === 'end', '钩子：曲目一二次结算');
|
||
G('right');
|
||
await flush();
|
||
assert(game.phase === 'main' && game._song.id === 'song2', '结算右滑 = 下一首（song2 进入 main）');
|
||
assert(srcLog.some((s) => s.url && s.url.includes('/bgm/track105')), 'song2 BGM track105 启动');
|
||
|
||
// —— 菜单暂停恢复：下滑呼出（无临近 down 音符）→ 关菜单后时刻平移 + BGM 断点续播 ——
|
||
await waitFor(() => game._cues.length > 0 && game._bgmT0 > 0, 'song2 排程就绪');
|
||
await runUntil(game._bgmT0 + 1.5); // BGM 已起、首个 cue 尚远（首个 cue ≈ bgmT0+5.6s）
|
||
const expBefore = game._cues.map((c) => c.expected);
|
||
const bgmT0Before = game._bgmT0;
|
||
const phaseEndBefore = game._phaseEnd;
|
||
const menuOpenAt = nowMs;
|
||
G('down');
|
||
await flush();
|
||
assert(game.phase === 'menu', '下滑折中：无临近 down 音符时下滑 = 呼出菜单');
|
||
assert(!playLog.some((p) => p.id === 'bgm/menu' && p.t >= menuOpenAt), '暂停菜单保持静默（不叠 menu pad，10 文档 §5）');
|
||
assert(voicePlayed('voice/menu_main'), '菜单语音 menu_main 播报');
|
||
await advance(3000); // 菜单停留 3s
|
||
G('down'); // 关菜单
|
||
await flush();
|
||
const pauseDur = (nowMs + 100 - menuOpenAt) / 1000; // resumeAt = 关菜单时刻 +0.1
|
||
assert(game.phase === 'main', '关菜单恢复 main');
|
||
const shift = game._bgmT0 - bgmT0Before;
|
||
assert(Math.abs(shift - pauseDur) < 1e-6, `_bgmT0 平移量 = 暂停时长（${shift.toFixed(3)}s ≈ ${pauseDur.toFixed(3)}s）`);
|
||
assert(game._cues.every((c, i) => Math.abs(c.expected - expBefore[i] - shift) < 1e-6), '全部 cue.expected 同步平移');
|
||
assert(Math.abs(game._phaseEnd - phaseEndBefore - shift) < 1e-6, '_phaseEnd 同步平移');
|
||
const lastTrack105 = srcLog.filter((s) => s.url && s.url.includes('/bgm/track105')).pop();
|
||
assert(lastTrack105 && lastTrack105.offset > 0, `BGM 断点续播（offset=${lastTrack105 && lastTrack105.offset.toFixed(2)}s > 0）`);
|
||
|
||
// —— Miss：窗口内做错手势 → 无乐器音 + error 震动 + combo 清零 ——
|
||
const missCue = game._cues.find((c) => !c.judged && c.gesture === 'tap');
|
||
await runUntil(missCue.expected + 0.1);
|
||
const instPlaysBefore = playLog.filter((p) => p.id.startsWith('sfx/inst_')).length;
|
||
const vibBefore = vibLog.length;
|
||
game._stats.combo = 5; // 制造非零 combo，验证清零
|
||
G('left'); // 错手势（该 cue 期望 tap，附近无 left cue）
|
||
await flush();
|
||
assert(missCue.result === 'miss', '窗口内错手势判 Miss');
|
||
assert(playLog.filter((p) => p.id.startsWith('sfx/inst_')).length === instPlaysBefore, 'Miss 不播乐器音（错过=没出声）');
|
||
assert(vibLog.slice(vibBefore).some((p) => Array.isArray(p) && p[0] === 60), 'Miss 触发 error 震动');
|
||
assert(game._stats.combo === 0, 'Miss 后 combo 清零');
|
||
|
||
// —— 下滑折中②：临近 down 应答音符时下滑 = 演奏判定，不开菜单 ——
|
||
for (const cue of game._cues) { // 把 down cue 之前的未判定音符应答掉
|
||
if (cue.judged || cue.gesture === 'down') continue;
|
||
await answerCue(cue);
|
||
if (game._cues.some((c) => c.gesture === 'down' && !c.judged && c.expected - nowSec() < 4)) break;
|
||
}
|
||
const downCue = game._cues.find((c) => !c.judged && c.gesture === 'down');
|
||
assert(!!downCue, '找到 song2 的 down 应答音符');
|
||
await runUntil(downCue.expected);
|
||
G('down');
|
||
await flush();
|
||
assert(downCue.result === 'perfect', '临近 down 音符时下滑 = 演奏判定（Perfect）');
|
||
assert(game.phase === 'main', '演奏判定后不开菜单（phase 保持 main）');
|
||
assert(playLog.some((p) => p.id === 'sfx/inst_tom_lo'), 'down 命中播放 inst_tom_lo');
|
||
|
||
// —— 结算末位：song3 结算页右滑 → 播 restart，不播 song_locked（round3-4 裁定①回归） ——
|
||
game._startSong(game._runId, 2);
|
||
game._finish(game._runId);
|
||
await flush();
|
||
assert(game.phase === 'end' && game._songIdx === 2, '钩子：song3 结算页');
|
||
const playMark = playLog.length;
|
||
G('right');
|
||
await flush();
|
||
const newVoices = playLog.slice(playMark).map((p) => p.id);
|
||
assert(newVoices.includes('voice/restart'), '末位曲目右滑 → 播 voice/restart');
|
||
assert(!newVoices.includes('voice/song_locked'), '末位曲目右滑 → 不播 song_locked');
|
||
|
||
assert(gestures <= 200, `手势预算内（${gestures} ≤ 200）`);
|
||
|
||
// ================= 场景 B：二周目选曲界面（menu pad + 选曲播报跳过 + 负偏移保护） =================
|
||
console.log('\n[场景 B] 二周目：选曲界面 menu pad / 播报跳过 / 锁定曲 / 暂停负偏移保护');
|
||
await newWorld({ tutorialDone: true, unlocked: 1, grades: {}, bestCombo: 0 });
|
||
game.start();
|
||
await flush();
|
||
assert(lastVoice() === 'voice/welcome_back', '二周目播 welcome_back（缩减开场）');
|
||
await waitFor(() => game.phase === 'select', '进入选曲界面');
|
||
assert(audio._bgm && audio._bgm.id === 'bgm/menu', '选曲界面播放 bgm/menu（10 文档 §5）');
|
||
|
||
await waitFor(() => !!audio._voice, 'select_hint 播报中');
|
||
G('tap'); // 跳过 select_hint → song1_name
|
||
await flush();
|
||
assert(game.phase === 'select' && lastVoice() === 'voice/song1_name', '选曲播报单击 = 跳下一句（phase 保持 select）');
|
||
G('right'); // 切到 song2（未解锁）
|
||
await flush();
|
||
assert(game._songIdx === 1 && lastVoice() === 'voice/song_locked', '右滑切到未解锁曲目 → song_locked');
|
||
G('tap'); // 跳过 song_locked
|
||
await flush();
|
||
assert(game.phase === 'select', 'song_locked 可跳过且不离开选曲');
|
||
G('left'); // 切回 song1
|
||
await flush();
|
||
assert(game._songIdx === 0, '左滑切回 song1');
|
||
await waitFor(() => !audio._voice, '选曲播报播完');
|
||
G('tap'); // 无语音时单击 = 确认选曲
|
||
await flush();
|
||
assert(game.phase === 'main' && game._song.id === 'song1', '无语音时单击 = 选定曲目进 main');
|
||
assert(audio._bgmWanted === null && audio._bgm === null, '进曲目后 menu pad 停止');
|
||
|
||
// 负偏移保护：BGM 起点（now+1.0）前开菜单，恢复时 offset 不得为负（真实环境负 offset 会抛异常）
|
||
await waitFor(() => game._cues.length > 0 && game._bgmT0 > 0, 'song1 排程就绪');
|
||
G('down');
|
||
await flush();
|
||
assert(game.phase === 'menu', 'BGM 起点前开菜单');
|
||
await advance(1500);
|
||
G('down');
|
||
await flush();
|
||
const restarted = srcLog.filter((s) => s.url && s.url.includes('/bgm/track90')).pop();
|
||
assert(game.phase === 'main' && restarted && restarted.offset >= 0, `断点续播 offset 非负（${restarted && restarted.offset}）——负偏移保护生效`);
|
||
|
||
// ================= 场景 C：教学失败 2 次 → retry_skip 跳过该步 =================
|
||
console.log('\n[场景 C] 教学失败重教 → 2 次失败跳过该步 → 下滑跳教学');
|
||
await newWorld();
|
||
game.start();
|
||
await flush();
|
||
G('tap'); // 跳 welcome
|
||
await waitFor(() => game.phase === 'tut' && game._cues.length > 0, 'T1 领奏');
|
||
// 失败①：做错手势
|
||
await runUntil(game._cues[0].expected + 0.3);
|
||
G('left'); // T1 期望 tap
|
||
await runUntil(game._phaseEnd + 0.2);
|
||
await flush();
|
||
assert(game._tutFails === 1 && lastVoice() === 'voice/retry_gesture', '失败 1 次 → retry_gesture 纠正重教');
|
||
await waitFor(() => game._tutAttempts.length === 0 && game._cues.length > 0 && game.phase === 'tut', 'T1 重新领奏');
|
||
// 失败②：完全不出手
|
||
await runUntil(game._phaseEnd + 0.2);
|
||
await flush();
|
||
assert(game._tutFails === 2, '同一步失败 2 次');
|
||
assert(voicePlayed('voice/retry_skip'), '播 retry_skip，跳过该步不卡死');
|
||
await waitFor(() => game._tutIdx === 1 && game.phase === 'tut' && game._cues.length > 0, '进入 T2');
|
||
assert(true, '流程推进到 T2');
|
||
// 下滑 = 跳过整个教学
|
||
G('down');
|
||
await flush();
|
||
assert(voicePlayed('voice/tut_skip'), '下滑跳教学播 tut_skip');
|
||
await waitFor(() => game.phase === 'main', '跳教学后进入曲目一');
|
||
assert(game._progress.tutorialDone === true, '跳教学同样持久化 tutorialDone');
|
||
|
||
// ================= 场景 D：语音资产缺失 → 看门狗推进，不卡死不崩 =================
|
||
console.log('\n[场景 D] 看门狗：屏蔽 welcome 资产');
|
||
await newWorld();
|
||
blocked.push('/welcome.');
|
||
const errBefore = consoleErrors;
|
||
game.start();
|
||
await flush();
|
||
await waitFor(() => game.phase === 'tut' && game._cues.length > 0, 'welcome 缺失时看门狗 8s 推进到 T1 领奏');
|
||
assert(consoleErrors > errBefore, '缺失资产仅 console.error');
|
||
assert(game.phase === 'tut', 'welcome 缺失不卡死（看门狗触发进教学）');
|
||
|
||
// ================= 场景 E：全局通用断言（§7 摘取引擎可测项） =================
|
||
console.log('\n[场景 E] 全局：解锁前静默 / 设置边界');
|
||
{
|
||
const locked = new WebAudioEngine('audio/');
|
||
const fetchMark = fetchLog.length;
|
||
locked.play('voice/tut_1');
|
||
await flush();
|
||
assert(fetchLog.length === fetchMark, '音频解锁前 play 静默跳过（§7.1）');
|
||
}
|
||
await newWorld();
|
||
settings.set({ voice: 'male' });
|
||
audio.play('voice/rules');
|
||
await flush();
|
||
assert(fetchLog.some((u) => String(u).includes('/voice/male/rules.')), 'settings.voice=male 后按男性目录解析（§7.3）');
|
||
settings.set({ speed: 1.7 });
|
||
audio.play('voice/rules');
|
||
await flush();
|
||
assert(audio._voice && audio._voice.st.tempo === 1.7, 'settings.speed=1.7 时下一句 tempo=1.7（SoundTouch 不变调）');
|
||
settings.set({ voice: 'female', speed: 1.0 });
|
||
const bgmFetchMark = fetchLog.length;
|
||
settings.set({ bgm: 0 });
|
||
audio.play('bgm/menu');
|
||
await flush();
|
||
assert(!fetchLog.slice(bgmFetchMark).some((u) => String(u).includes('/bgm/menu')), 'bgm=0 时 BGM 不加载（§7.3）');
|
||
assert(audio._bgm === null && audio._bgmWanted && audio._bgmWanted.id === 'bgm/menu', 'bgm=0 只记"想播"意图');
|
||
settings.set({ bgm: 1.0 });
|
||
await flush();
|
||
assert(audio._bgm && audio._bgm.id === 'bgm/menu', 'bgm 调回非 0 自动补播最后状态 BGM');
|
||
|
||
// ================= 资产引用校验（fs：ogg+m4a 双格式零缺失） =================
|
||
console.log('\n[资产校验] game.js 引用的 id 对照 audio/ 目录');
|
||
{
|
||
const src = readFileSync(new URL('../game.js', import.meta.url), 'utf8');
|
||
const ids = new Set();
|
||
for (const m of src.matchAll(/['"`]((?:voice|sfx|bgm)\/[a-z0-9_]+)['"`]/g)) ids.add(m[1]);
|
||
if (src.includes('voice/grade_${grade}')) for (const g of ['s', 'a', 'b', 'c']) ids.add(`voice/grade_${g}`);
|
||
const missing = [];
|
||
const has = (p) => existsSync(new URL(p, import.meta.url));
|
||
for (const id of ids) {
|
||
const [layer, name] = id.split('/');
|
||
if (layer === 'voice') {
|
||
const dual = ['male', 'female'].every((g) => has(`../audio/voice/${g}/${name}.ogg`) && has(`../audio/voice/${g}/${name}.m4a`));
|
||
const flat = has(`../audio/voice/${name}.ogg`) && has(`../audio/voice/${name}.m4a`);
|
||
if (!dual && !flat) missing.push(id + '（voice 需双性别或平铺 ogg+m4a）');
|
||
} else if (!has(`../audio/${layer}/${name}.ogg`) || !has(`../audio/${layer}/${name}.m4a`)) {
|
||
missing.push(id + '（缺 ogg 或 m4a）');
|
||
}
|
||
}
|
||
console.log(` 共引用 ${ids.size} 个资产 id`);
|
||
assert(missing.length === 0, `资产零缺失${missing.length ? '——缺失: ' + missing.join(', ') : ''}`);
|
||
}
|
||
|
||
// ================= 汇总 =================
|
||
console.log('\n========== 汇总 ==========');
|
||
assert(uncaught.length === 0, `全程无未捕获异常（§7.2）${uncaught.length ? '——' + uncaught.map(String).join('; ') : ''}`);
|
||
console.log(`通过 ${passed} 项，失败 ${failed} 项`);
|
||
process.exit(failed > 0 ? 1 : 0);
|