2.6 KiB
2.6 KiB
Scene Acceptance
本文档记录第一关场景骨架的验收流程。每次改动场景、摄像机、关卡数据、输入或渲染层后，至少执行构建检查；涉及跑图手感时再执行手动跑图检查。
验收范围
- 场景入口：
WhiteboxScene - 关卡数据：
CreateWhiteboxLevel() - 世界尺寸：
3200 x 720 - 玩家出生点：
(160, 380) - 关卡边界：
0 -> 3200 - 视口：
1280 x 720 - Battle zones：
zone_01_intro、zone_02_platform、zone_03_exit - 资源槽位：
game/assets/stage/stage_01/
构建检查
Windows
& 'C:\Program Files\xmake\xmake.exe' f -c -p windows -a x64 -m release -y
& 'C:\Program Files\xmake\xmake.exe' -b Frostbite2DGame
短启动检查：
$exe = Join-Path (Get-Location) 'build\windows\x64\release\Frostbite2DGame.exe'
$p = Start-Process -FilePath $exe -WorkingDirectory (Get-Location) -PassThru -WindowStyle Hidden
Start-Sleep -Seconds 3
if (!$p.HasExited) { Stop-Process -Id $p.Id -Force }
Switch
& 'C:\Program Files\xmake\xmake.exe' f -c -p switch -a aarch64 -m release --toolchain=cross --sdk='C:\devkitPro\devkitA64' --bin='C:\devkitPro\devkitA64\bin' --cross='aarch64-none-elf-' -y
& 'C:\Program Files\xmake\xmake.exe' -b Frostbite2DGameSwitch
产物：
build\switch\aarch64\release\switch_game\NSUnknownGame.nro
手动跑图检查
操作映射见 controls.md。
- 启动 Windows 版
Frostbite2DGame.exe。 - 从出生点向右移动，确认摄像机横向跟随且不露出世界外黑边。
- 依次进入 3 个 battle zone，确认 camera bounds 平滑切换，没有硬切瞬移。
- 通过 debug 清场或离开区域解除锁定，确认摄像机恢复全关卡跟随。
- 使用 debug 分项开关检查：
- 碰撞矩形和场景网格。
- 玩家包围盒。
- battle zone 触发框和 camera bounds。
- 敌人出生点。
- 从起点移动到终点附近，确认所有平台、props、前景遮挡和背景层没有闪烁或黑屏。
当前验收结果
日期：2026-06-09
- Windows release 构建：通过。
- Windows 3 秒短启动：通过。
- Switch
Frostbite2DGameSwitch构建：通过。 - Switch RomFS：已包含 character、shader 和
stage_01资源槽位。 - 手动跑图：未在本轮执行，等待后续素材/战斗区域进一步接入时复测。
后续补充
- 增加输入状态 debug 显示后，把输入检查纳入本流程。
- 增加
EnemyActor后，把 battle zone 自动清场纳入本流程。 - 增加 hitbox/hurtbox 后，把战斗 debug 绘制纳入本流程。