游戏引擎 / 系统课时
接通胜利失败结算及重开流程
接通胜利失败结算及重开流程
通关门触发与玩家死亡可能紧挨着发生。若两套逻辑各自弹窗,容易出现胜负页面重叠、按钮重复响应,以及重开后角色仍被暂停的问题。这里用一个结算控制器锁定结果,接通 UI Toolkit 页面、场景重载和返回菜单。
学习目标
- 让通关和死亡事件只产生一次、且互斥的结算。
- 显示胜利或失败页面及本局用时,接通重开与返回菜单按钮。
- 验证事件退订、重复触发和
Time.timeScale恢复。
准备结算 UI 和可加载场景
以下操作适用于 Unity 6(6000.x)的运行时 UI Toolkit。
- 通过
Window > UI Toolkit > UI Builder创建ResultScreen.uxml;在关卡中创建ResultUI游戏对象,添加UIDocument,指定Panel Settings和Source Asset。 - 在 UI Builder 中创建下表中的元素。
result-overlay是覆盖游戏画面的全屏容器,内部包含两种结果视图及共用按钮。将按钮文本分别设为“重新开始”和“返回菜单”。 - 在
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。
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 显示:
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 接线问题与任务条件判断问题分开定位。