4.1 KiB
4.1 KiB
Scene Acceptance
本文档记录第一关场景骨架的验收流程。每次改动场景、摄像机、关卡数据、输入或渲染层后，至少执行构建检查；涉及跑图手感时再执行手动跑图检查。
验收范围
- 场景入口：
WhiteboxScene - 关卡数据：
game/assets/map/stage_01.map - 关卡 fallback：
CreateWhiteboxLevel()内置 C++ 白盒数据 - 世界尺寸：
6400 x 720 - 玩家出生点：
(160, 496) - 关卡边界：
0 -> 6400 - 视口：
1280 x 720 - Battle zones：
zone_01_entrance、zone_02_lower_cavern、zone_03_main_hall、zone_04_high_garden、zone_05_exit - 资源槽位：
game/assets/stage/stage_01/ - 地图资源：
game/assets/map/stage_01.map - Tile 数据：
stage_01.map中的tileset/tile_rect - 全局资源槽位：
game/assets/ASSETS.md - UI overlay：
GameUiOverlay，有字体时使用TextSprite，无字体时使用 fallback 色条。 - 音频 cue：
stage_01、player_jump、player_attack、battle_zone_enter。
构建检查
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 }
资源路径检查：
Test-Path build\windows\x64\release\assets\map\stage_01.map
Test-Path build\windows\x64\release\assets\ASSETS.md
Test-Path build\windows\x64\release\assets\fonts
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
RomFS 地图检查：
Test-Path build\switch\aarch64\release\switch_game\romfs\assets\map\stage_01.map
Test-Path build\switch\aarch64\release\switch_game\romfs\assets\ASSETS.md
Test-Path build\switch\aarch64\release\switch_game\romfs\assets\fonts
手动跑图检查
操作映射见 controls.md。
- 启动 Windows 版
Frostbite2DGame.exe。 - 从出生点向右移动，确认摄像机横向跟随且不露出世界外黑边。
- 依次进入 5 个 battle zone，确认 camera bounds 平滑切换，没有硬切瞬移。
- 通过 debug 清场或离开区域解除锁定，确认摄像机恢复全关卡跟随。
- 使用 debug 分项开关检查：
- 碰撞矩形和场景网格。
- 玩家包围盒。
- battle zone 触发框和 camera bounds。
- 敌人出生点。
- 从起点移动到终点附近，确认所有平台、props、前景遮挡和背景层没有闪烁或黑屏。
- 确认 UI overlay 可见；若没有字体资源，应显示左上角色条 fallback。
- 切换 F1/F3/F4/F5/F6 后重启，确认 debug 开关能通过
SaveSystem记住。
当前验收结果
日期：2026-06-09
- Windows release 构建：通过。
- Windows 3 秒短启动：通过。
- Switch
Frostbite2DGameSwitch构建：通过。 - Switch RomFS：已包含 character、shader、
stage_01资源槽位和assets/map/stage_01.map。 - 地图加载：
stage_01.map已作为第一关主数据源；C++ 白盒数据仅作为 fallback。 - 地图视觉：
stage_01.map已扩展为6400 x 720的 Mossy Cavern 大地图，当前主要通过rect_sprite_src裁切场景图集表达。 - 引擎能力接入：
Animation/NPK/PNG 角色资源优先级、UIScene/TextSpriteUI、Sound/Musiccue、SaveSystemdebug 存档已接入。 - 手动跑图：未在本轮执行，等待后续素材/战斗区域进一步接入时复测。
后续补充
- 增加输入状态 debug 显示后，把输入检查纳入本流程。
- 增加
EnemyActor后，把 battle zone 自动清场纳入本流程。 - 增加 hitbox/hurtbox 后，把战斗 debug 绘制纳入本流程。