游戏引擎 / 系统课时

验证存档恢复与关卡通关

验证存档恢复与关卡通关

用一条固定路线从新游戏走到胜利结算,逐步核对战斗奖励、拾取状态、任务进度与存档内容。完成后应能重复执行同一用例,并在重载、重复触发和胜负竞争时指出具体失败环节。

学习目标

  • 建立含初始值、保存检查点和读档预期值的端到端验收用例。
  • 使用 Unity 6 运行时日志识别重复奖励、恢复遗漏和结算重复显示。
  • 对场景重载与触发边界给出可复现的通过标准。

固定测试场景与检查点

先使用测试存档槽,不要覆盖正式玩家存档。在测试关卡中只放一名必杀敌人、一处一次性宝箱和一扇任务门,确认主菜单与关卡均已加入 File > Build Profiles > Platforms > Scene List。下表是可复测的验收样例配置,不是 Unity 自带数值;项目中应配置对应测试对象和奖励。

检查项目 新游戏 保存时与读档后
玩家生命值 100 受击一次后为 70
金币 0 击杀敌人奖励 20,最终为 20
钥匙 0 宝箱领取 1 把,最终为 1
任务目标 击杀 0/1、拾取 0/1 两项均为 1/1
场景物体 敌人存活、宝箱未领取、门锁定 敌人死亡、宝箱已领取、门解锁
胜利结算 未出现 保存与读档后仍未出现

给敌人和宝箱配置不会因运行时实例化而变化的稳定 ID,例如测试数据 enemy-qa01 和 chest-qa01。保存位置建议采用同一检查点,读档后角色与该位置的距离偏差不超过 0.1 米;如果项目设计会贴地修正,先记录并固定这一容差。

跑通保存与加载完整链路

按以下顺序操作,每次从同一份初始测试环境开始。不要通过 Inspector 临时修改已运行对象来跳过真实的战斗或拾取逻辑。

  1. 备份并清理测试存档槽,选择“新游戏”,确认生命值为 100、金币和钥匙为 0、任务进度均为 0/1。
  2. 让敌人命中玩家一次,核对生命值变为 70;击败敌人后检查金币恰好加 20,击杀目标变为 1/1。
  3. 打开宝箱拾取钥匙,检查钥匙数量为 1、拾取目标变为 1/1、任务门解锁。此时未进入出口,胜利面板不能提前出现。
  4. 在固定位置执行游戏内“保存”,等待成功反馈后退出独立构建的程序,重新启动并选择“继续游戏”。单纯停止编辑器 Play Mode 不算完成跨进程验证。
  5. 等待场景加载和存档对象恢复全部完成,再解除玩家输入限制。逐项对照上表,并检查敌人没有复活、宝箱没有重新可领、角色位置偏差不超过 0.1 米。
  6. 再次走过死亡敌人和宝箱所在位置,重新接近任务门;金币必须仍是 20、钥匙仍是 1、两个任务目标仍为 1/1。
  7. 进入出口区域,检查胜利结算恰好显示一次;在专用验收场景中重复触发出口,第二次不得创建新面板或再次发放通关奖励。

存档恢复与通关验收的完整时序

加入一次性事件探针

将以下完整组件保存为 Assets/Scripts/QA/AcceptanceProbe.cs,挂到启动场景的一个空物体上。把项目实际的“新游戏开始、奖励已入账、全部读档恢复完毕、胜利面板已显示”回调分别接到同名含义的公开方法。它不依赖任何假设的项目业务类,但需要根据当前项目接线;只记录了场景加载不代表已经恢复存档。

csharp
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;

public sealed class AcceptanceProbe : MonoBehaviour
{
    private static AcceptanceProbe instance;
    private readonly HashSet<string> rewardIds = new HashSet<string>();
    private int victoryCount;

    private void Awake()
    {
        if (instance != null && instance != this)
        {
            Destroy(gameObject);
            return;
        }
        instance = this;
        DontDestroyOnLoad(gameObject);
        Debug.Log($"[QA] Data folder: {Application.persistentDataPath}");
    }

    private void OnEnable()
    {
        if (instance == this)
            SceneManager.sceneLoaded += OnSceneLoaded;
    }

    private void OnDisable()
    {
        SceneManager.sceneLoaded -= OnSceneLoaded;
    }

    private void OnSceneLoaded(Scene scene, LoadSceneMode mode)
    {
        Debug.Log($"[QA] Scene loaded: {scene.name}");
    }

    public void NewGame()
    {
        rewardIds.Clear();
        victoryCount = 0;
        Debug.Log("[QA] New game");
    }

    public void RewardGranted(string stableId, int coins)
    {
        // 仅在奖励真正入账后调用,按稳定 ID 检查重复发奖。
        if (!rewardIds.Add(stableId))
            Debug.LogError($"[QA] Duplicate reward: {stableId}");
        else
            Debug.Log($"[QA] Reward: {stableId} +{coins}");
    }

    public void RestoreCompleted(
        int hp, int coins, int keys, int objectives,
        bool enemyDead, bool chestUsed, bool gateOpen)
    {
        // 等所有对象完成恢复,再检查约定的保存断点。
        bool pass = hp == 70 && coins == 20 && keys == 1
            && objectives == 2 && enemyDead && chestUsed && gateOpen;
        if (pass)
            Debug.Log("[QA] Restore PASS");
        else
            Debug.LogError($"[QA] Restore FAIL: HP={hp}, coins={coins}, keys={keys}, objectives={objectives}, enemyDead={enemyDead}, chestUsed={chestUsed}, gateOpen={gateOpen}");
    }

    public void VictoryShown()
    {
        // 只在结算面板确实被显示时上报,不在触发区入口上报。
        victoryCount++;
        if (victoryCount == 1)
            Debug.Log("[QA] Victory shown once");
        else
            Debug.LogError($"[QA] Duplicate victory: {victoryCount}");
    }
}

预期输出(完整接线后在 Unity Console 中筛选 [QA];这是首次运行和重启后两段日志的关键行摘录,场景名与数据目录可能不同):

text
[QA] New game
[QA] Reward: enemy-qa01 +20
[QA] Restore PASS
[QA] Victory shown once

RewardGranted 必须放在奖励提交成功之后,不能放在攻击命中或尝试拾取时。探针的去重集合只覆盖同一进程;跨进程重复发奖应通过读档后金币恰好为 20、对象已消耗,以及再次尝试交互后数值不变来发现。

用边界用例定位问题

失败现象 优先检查 修复后的验证
读档金币变为 40 或任务次数增加 恢复对象时是否重播死亡、拾取奖励事件 恢复保存状态而非再次执行奖励逻辑;重载后仍为 20
敌人复活或宝箱可重复领取 场景实例是否用稳定 ID 匹配保存记录、恢复是否晚于交互启用 输入开放前状态已正确还原
胜利面板出现两次 出口是否存在多个 Collider 回调、结算是否缺少一次性状态锁 连续进入两次仍只创建一次
生命值为 0 时仍显示胜利 死亡与出口事件同帧竞争 本验收规则设为死亡优先,胜利触发被拒绝
编辑器通过、独立程序读档失败 构建配置的场景列表、保存位置和退出时机 完整重启独立程序后数值一致

另做一次反向测试:只完成击杀目标而不拾取钥匙,尝试进入出口,必须被任务门阻挡;如果关卡用无形触发区,应确认未满足目标时不会结算。修复一项后,从“新游戏”重新跑整条链,不能只从刚失败的中间步骤开始。

记录放行结果

为每次执行记录构建版本、测试存档槽、开始条件、实际数值、Console 错误和结果截图。建议连续运行 3 次,要求每次都满足:保存前后数值一致、位置偏差不超过 0.1 米、重复发奖 0 次、重复结算 0 次、主流程阻断错误 0 个。

若检查点不一致,应保留读档前后的状态记录以及 Application.persistentDataPath 指示的目录线索;只有项目确实把存档写在该目录时,才在那里查找实际文件。以上所有检查通过,才能将“战斗—拾取—任务—存档—恢复—通关”标记为验收通过。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证存档恢复与关卡通关

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通