游戏引擎 / 系统课时

接通胜利失败结算及重开流程

接通胜利失败结算及重开流程

通关门触发与玩家死亡可能紧挨着发生。若两套逻辑各自弹窗,容易出现胜负页面重叠、按钮重复响应,以及重开后角色仍被暂停的问题。这里用一个结算控制器锁定结果,接通 UI Toolkit 页面、场景重载和返回菜单。

学习目标

  • 让通关和死亡事件只产生一次、且互斥的结算。
  • 显示胜利或失败页面及本局用时,接通重开与返回菜单按钮。
  • 验证事件退订、重复触发和 Time.timeScale 恢复。

准备结算 UI 和可加载场景

以下操作适用于 Unity 6(6000.x)的运行时 UI Toolkit。

  1. 通过 Window > UI Toolkit > UI Builder 创建 ResultScreen.uxml;在关卡中创建 ResultUI 游戏对象,添加 UIDocument,指定 Panel Settings 和 Source Asset。
  2. 在 UI Builder 中创建下表中的元素。result-overlay 是覆盖游戏画面的全屏容器,内部包含两种结果视图及共用按钮。将按钮文本分别设为“重新开始”和“返回菜单”。
  3. 在 File > Build Profiles > Scene List 中启用当前关卡场景及名为 MainMenu 的菜单场景。下文按场景名称加载,名称必须唯一;若项目使用其他菜单场景名,修改组件的 Menu Scene Name。
元素 Name 类型 用途
result-overlay VisualElement 结算遮罩,开始时隐藏
win-view / lose-view VisualElement 两个互斥的结果视图
result-summary Label 显示本局用时与结果
restart-button / menu-button Button 重开与返回菜单

把 win-view、lose-view、result-summary 和两个按钮都放在 result-overlay 内。遮罩推荐覆盖视口宽高各 100%,背景使用半透明深蓝灰,并让 UIDocument 的显示顺序高于普通 HUD,避免结算时仍误点背后的交互控件。

胜负事件进入互斥结算状态并连接两个场景跳转操作

实现互斥结果与按钮回调

创建 LevelResultController.cs,把下面代码完整放入文件,并挂到带有 UIDocument 的 ResultUI 上。LevelOutcome 是本示例的轻量事件入口;已有任务系统或生命组件只需在达成条件时调用它,不要直接操作 UI。

csharp
using System;
using UnityEngine;
using UnityEngine.SceneManagement;
using UnityEngine.UIElements;

public static class LevelOutcome
{
    public static event Action Victory;
    public static event Action Defeat;

    public static void ReportVictory() => Victory?.Invoke();
    public static void ReportDefeat() => Defeat?.Invoke();
}

[RequireComponent(typeof(UIDocument))]
public sealed class LevelResultController : MonoBehaviour
{
    [SerializeField] private string menuSceneName = "MainMenu";

    private enum Result { Playing, Victory, Defeat }
    private Result result = Result.Playing;
    private VisualElement overlay, winView, loseView;
    private Label summary;
    private Button restartButton, menuButton;
    private float startedAt;
    private bool loading;

    private void Awake()
    {
        startedAt = Time.unscaledTime;
    }

    private void OnEnable()
    {
        var root = GetComponent<UIDocument>().rootVisualElement;
        overlay = root.Q<VisualElement>("result-overlay");
        winView = root.Q<VisualElement>("win-view");
        loseView = root.Q<VisualElement>("lose-view");
        summary = root.Q<Label>("result-summary");
        restartButton = root.Q<Button>("restart-button");
        menuButton = root.Q<Button>("menu-button");

        // 名称对不上时停止订阅,避免运行中才出现空引用。
        if (overlay == null || winView == null || loseView == null ||
            summary == null || restartButton == null || menuButton == null)
        {
            Debug.LogError("ResultScreen 缺少指定 Name 的 UI 元素");
            enabled = false;
            return;
        }

        overlay.style.display = DisplayStyle.None;
        restartButton.clicked += Restart;
        menuButton.clicked += ReturnToMenu;
        LevelOutcome.Victory += OnVictory;
        LevelOutcome.Defeat += OnDefeat;
    }

    private void OnDisable()
    {
        // 场景销毁或组件停用时解除静态事件和按钮回调。
        LevelOutcome.Victory -= OnVictory;
        LevelOutcome.Defeat -= OnDefeat;
        if (restartButton != null) restartButton.clicked -= Restart;
        if (menuButton != null) menuButton.clicked -= ReturnToMenu;
    }

    private void OnVictory() => Finish(Result.Victory);
    private void OnDefeat() => Finish(Result.Defeat);

    private void Finish(Result next)
    {
        // 同一局只允许首次有效结果改变状态。
        if (result != Result.Playing || loading) return;
        result = next;

        winView.style.display = next == Result.Victory
            ? DisplayStyle.Flex : DisplayStyle.None;
        loseView.style.display = next == Result.Defeat
            ? DisplayStyle.Flex : DisplayStyle.None;
        float seconds = Time.unscaledTime - startedAt;
        summary.text = $"{(next == Result.Victory ? "通关" : "失败")},用时 {seconds:F1} 秒";
        overlay.style.display = DisplayStyle.Flex;
        Time.timeScale = 0f;
        Debug.Log($"LevelResult: {next}");
    }

    private void Restart() => Load(SceneManager.GetActiveScene().name);
    private void ReturnToMenu() => Load(menuSceneName);

    private void Load(string sceneName)
    {
        if (loading || result == Result.Playing) return;
        loading = true;
        // 场景跳转前恢复时间,避免下一局继承暂停。
        Time.timeScale = 1f;
        SceneManager.LoadSceneAsync(sceneName, LoadSceneMode.Single);
    }

    [ContextMenu("测试:胜利")]
    private void TestVictory() => LevelOutcome.ReportVictory();

    [ContextMenu("测试:失败")]
    private void TestDefeat() => LevelOutcome.ReportDefeat();
}

预期结果:在 Play 模式下,从组件右上角菜单选择“测试:胜利”,Console 显示:

text
LevelResult: Victory

同时只显示 win-view,result-summary 显示“通关,用时 X.X 秒”,游戏时间停止但结算按钮仍能点击。重开后再次执行“测试:失败”,则显示 lose-view,Console 对应输出 LevelResult: Defeat。其中 X.X 为实测用时,不是固定值。

把任务完成与玩家死亡接到同一个入口

在关卡真正确认目标全部达成时,例如 GoalZone 核实任务进度后,调用 LevelOutcome.ReportVictory();在玩家 Health 首次从正值降至 0 时,调用 LevelOutcome.ReportDefeat()。这两句应放进各自已有的成功分支,而非每帧调用。对完成条件的判断应先于事件发送,不能仅凭玩家进入出口触发器就直接宣告胜利。

控制器采用 Playing → Victory / Defeat 的单次状态转换:第一条到达的有效事件确定结果,之后的同类或相反事件都被忽略。若设计要求“同帧死亡优先于通关”,须在任务与战斗的上游逻辑统一仲裁,再发送唯一结果事件,不能依赖两个 C# 回调碰巧的先后顺序。

本示例把 Time.timeScale 设为 0 来冻结按缩放时间推进的玩法逻辑;它不会自动禁止使用未缩放时间的更新、输入处理或音频播放。已有敌人攻击、操作映射和暂停菜单应在结算状态下停止接收玩法指令,避免画面冻结但逻辑继续变动。

按验收场景排查重开失败

操作 应看到的结果
连续调用两次 ReportVictory() 只记录一次胜利,不重复打开界面
先胜利再发送失败事件 仍显示胜利页,不被失败覆盖
首先发送失败事件 只显示失败页与本局用时
结算后点击“重新开始”两次 只启动一次关卡重载;新关卡可正常移动
结算后点击“返回菜单” 加载 MainMenu,菜单响应输入

若按钮点击后出现无法加载场景的错误,先检查 Build Profiles 中两个场景是否启用、Menu Scene Name 是否完全匹配。若重开后画面能动但角色不能输入,检查是否存在 DontDestroyOnLoad 的暂停管理器:上面的代码会恢复 Time.timeScale,但无法替项目中自定义的 isPaused、输入禁用标志或输入上下文自动复位;这些持久状态也要在场景切换前清理。

在 Inspector 的 LevelResultController 组件上用测试菜单先跑通胜利、重开、失败、返回菜单四条路径,再连接真实触发器。这样可以把 UI 接线问题与任务条件判断问题分开定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

接通胜利失败结算及重开流程

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

登录哪都通