游戏引擎 / 系统课时
清理事件订阅和场景引用
清理事件订阅和场景引用
本课把玩家生命值、任务消息和 HUD 的事件连接整理为可重复进入关卡的生命周期:启用时订阅,停用时取消,重载场景后重新寻找当前实例。完成后可用实际日志证明一次受击只更新一次 UI,旧场景引用不会继续参与回调。
学习目标
- 找出实例事件、静态事件和跨场景对象引用的所有者。
- 用
OnEnable、OnDisable和SceneManager.sceneLoaded成对管理订阅。 - 通过禁用组件、场景重载和反复进入 Play Mode 验证没有重复通知。
盘点事件与对象所有权
先在 IDE 全局搜索 +=、-=、event、static event、DontDestroyOnLoad 和 sceneLoaded。逐项记录谁发布、谁订阅、谁负责解除;同一个回调若只出现 += 而找不到 -=,优先检查。以下 PlayerHealth 和 MissionEvents 是本课示例自定义类型,并非 Unity 内建事件。
| 事件 | 事件拥有者 | 接收者 | 必须清理的时机 |
|---|---|---|---|
PlayerHealth.HealthChanged |
当前场景的玩家组件 | HUD | HUD 停用或玩家实例更换 |
SceneManager.sceneLoaded |
Unity 静态场景管理器 | HUD 绑定器 | HUD 停用 |
MissionEvents.ProgressChanged |
自定义静态任务事件类 | 任务面板 | 任务面板停用 |
检查 Hierarchy 中是否在每次重开关卡后多出一个 HUD、敌人管理器或任务面板。尤其注意 DontDestroyOnLoad 保留的根对象:它可能继续保存已卸载场景的 MonoBehaviour 引用。Unity 对已销毁对象的 == null 判断不等于托管事件委托已自动解除。
在启停生命周期同步重绑
OnEnable 对应 OnDisable;先从旧玩家的事件移除回调,再连接新玩家。Unity 6 的 SceneManager.sceneLoaded 会在新场景对象的 OnEnable 之后、Start 之前触发,可用于恢复跨场景引用。

在 Assets/Scripts 新建 PlayerHealth.cs,挂到名为 Player 的激活对象。两个 Inspector 测试菜单仅供本课验收;重载方法要求场景已经加入 Build Profile 的 Scene List。
using System;
using UnityEngine;
using UnityEngine.SceneManagement;
public sealed class PlayerHealth : MonoBehaviour
{
public event Action<int> HealthChanged;
public int CurrentHealth { get; private set; } = 100;
public void TakeDamage(int amount)
{
if (amount <= 0 || CurrentHealth == 0) return;
// 血量确实变化后才通知,避免无效刷新。
CurrentHealth = Mathf.Max(0, CurrentHealth - amount);
HealthChanged?.Invoke(CurrentHealth);
}
[ContextMenu("Test Damage 10")]
private void TestDamage10() => TakeDamage(10);
[ContextMenu("Reload Scene")]
private void ReloadScene()
{
// 测试用:只重载当前活动场景。
SceneManager.LoadScene(SceneManager.GetActiveScene().name);
}
}再建 HealthHudBinder.cs,挂到另一个激活对象 HUD。示例用 Console 代替实际 UI 文本组件,不依赖 UI Toolkit 或 TextMeshPro;接入现有 HUD 时把 Refresh 内的日志改为更新生命值显示。
using UnityEngine;
using UnityEngine.SceneManagement;
public sealed class HealthHudBinder : MonoBehaviour
{
private PlayerHealth boundPlayer;
private void OnEnable()
{
SceneManager.sceneLoaded += OnSceneLoaded;
BindPlayer(FindFirstObjectByType<PlayerHealth>());
}
private void OnDisable()
{
SceneManager.sceneLoaded -= OnSceneLoaded;
BindPlayer(null);
}
private void OnSceneLoaded(Scene scene, LoadSceneMode mode)
{
BindPlayer(FindFirstObjectByType<PlayerHealth>());
}
private void BindPlayer(PlayerHealth next)
{
if (ReferenceEquals(boundPlayer, next)) return;
// 用托管引用判断,旧 Unity 对象即使已销毁仍可移除委托。
if (!ReferenceEquals(boundPlayer, null))
boundPlayer.HealthChanged -= Refresh;
boundPlayer = next;
if (boundPlayer == null) return;
boundPlayer.HealthChanged += Refresh;
Refresh(boundPlayer.CurrentHealth); // 绑定时立即同步当前值。
}
private void Refresh(int health)
{
Debug.Log($"HUD HP={health}");
}
}预期输出:进入 Play Mode 后,在 PlayerHealth 组件的上下文菜单执行一次 Test Damage 10,Console 中该脚本依次打印:
HUD HP=100
HUD HP=90ReferenceEquals 用于比较真正的托管引用,防止 Unity 已销毁对象的特殊空值比较跳过解绑。FindFirstObjectByType<PlayerHealth>() 适用于单玩家、单活动关卡的最小示例,不能在有多名玩家或叠加加载场景时当成稳定的玩家选择规则;正式项目应由生成器或场景管理器显式传入目标实例。
清理静态事件和持久 UI
如果 Unity 6 编辑器在 Edit > Project Settings > Editor > Enter Play Mode Settings 选择了 Reload Scene only,进入 Play Mode 不会重载脚本域,静态字段和静态事件订阅可能沿用上次运行的状态。对于项目自己拥有的静态任务总线,可在运行时初始化阶段清空旧委托:
using System;
using UnityEngine;
public static class MissionEvents
{
public static event Action<int> ProgressChanged;
public static void PublishProgress(int count)
{
ProgressChanged?.Invoke(count);
}
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
private static void ResetStaticEvents()
{
// 新的运行会话从空订阅列表开始。
ProgressChanged = null;
}
}这是可编译的事件总线定义,本身不产生日志;任务面板仍必须在自己的 OnEnable 中订阅、OnDisable 中移除相同命名方法。不要尝试清空 Unity 所拥有的 SceneManager.sceneLoaded,也不要用两个不同的匿名 lambda 分别执行订阅和退订。
对于需要跨场景保留的 HUD,仅对根对象调用 DontDestroyOnLoad(gameObject),并在 Awake 检查是否已有持久实例;若有,销毁新生成的重复对象。当前示例 HUD 不设置持久化,因此每次重载应只存在场景新建的一份。
用重复操作验证并定位异常
- 保存当前场景,在
File > Build Profiles的Scene List(Unity 6.0 的Platforms > Scene List)中执行Add Open Scenes,确保场景已启用。打开Window > General > Console,关闭Collapse,避免相同日志被折叠后误判次数。 - 进入 Play Mode。执行一次
Test Damage 10,检查HUD HP=90只出现一次。将HUD对象设为不激活,再执行一次同样的菜单,预期不产生 HUD 日志;重新激活后应仅打印一次HUD HP=80。 - 执行
Reload Scene三次。每次场景重新建立后应恰好打印一次HUD HP=100;再执行一次受击,应恰好打印一次HUD HP=90。没有重复刷新、MissingReferenceException或NullReferenceException才算通过。 - 退出并重新进入 Play Mode 三次,分别在默认重载设置和
Reload Scene only下检查日志次数。不要在Update中反复注册同一个回调。
| 异常 | 优先检查 | 修复动作 |
|---|---|---|
| 受击一次却打印两三次 | Hierarchy 中有重复 HUD,或回调多次执行 += |
删除重复实例,成对管理 += 和 -= |
| 重载后仍收到旧玩家的消息 | 旧 PlayerHealth 事件未解绑 |
切换时先退订旧实例,再绑定新实例 |
| 关闭面板仍触发回调 | 静态事件漏写 OnDisable 退订 |
使用同一个命名方法移除监听 |
| HUD 不刷新或绑定错玩家 | 查找时对象尚未激活,或存在多个玩家 | 等待场景加载完成,改为显式注入正确实例 |
验收标准可以写成三条可重复的断言:一次有效伤害对应一次 HUD 刷新;HUD 停用时对应零次;每次重载完成只绑定当前场景的玩家。事件来源从生命值替换成敌人死亡或任务完成时,也沿用相同的所有权与解绑规则。