游戏引擎 / 系统课时

清理事件订阅和场景引用

清理事件订阅和场景引用

本课把玩家生命值、任务消息和 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。

csharp
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 内的日志改为更新生命值显示。

csharp
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 中该脚本依次打印:

text
HUD HP=100
HUD HP=90

ReferenceEquals 用于比较真正的托管引用,防止 Unity 已销毁对象的特殊空值比较跳过解绑。FindFirstObjectByType<PlayerHealth>() 适用于单玩家、单活动关卡的最小示例,不能在有多名玩家或叠加加载场景时当成稳定的玩家选择规则;正式项目应由生成器或场景管理器显式传入目标实例。

清理静态事件和持久 UI

如果 Unity 6 编辑器在 Edit > Project Settings > Editor > Enter Play Mode Settings 选择了 Reload Scene only,进入 Play Mode 不会重载脚本域,静态字段和静态事件订阅可能沿用上次运行的状态。对于项目自己拥有的静态任务总线,可在运行时初始化阶段清空旧委托:

csharp
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 不设置持久化,因此每次重载应只存在场景新建的一份。

用重复操作验证并定位异常

  1. 保存当前场景,在 File > Build Profiles 的 Scene List(Unity 6.0 的 Platforms > Scene List)中执行 Add Open Scenes,确保场景已启用。打开 Window > General > Console,关闭 Collapse,避免相同日志被折叠后误判次数。
  2. 进入 Play Mode。执行一次 Test Damage 10,检查 HUD HP=90 只出现一次。将 HUD 对象设为不激活,再执行一次同样的菜单,预期不产生 HUD 日志;重新激活后应仅打印一次 HUD HP=80。
  3. 执行 Reload Scene 三次。每次场景重新建立后应恰好打印一次 HUD HP=100;再执行一次受击,应恰好打印一次 HUD HP=90。没有重复刷新、MissingReferenceException 或 NullReferenceException 才算通过。
  4. 退出并重新进入 Play Mode 三次,分别在默认重载设置和 Reload Scene only 下检查日志次数。不要在 Update 中反复注册同一个回调。
异常 优先检查 修复动作
受击一次却打印两三次 Hierarchy 中有重复 HUD,或回调多次执行 += 删除重复实例,成对管理 += 和 -=
重载后仍收到旧玩家的消息 旧 PlayerHealth 事件未解绑 切换时先退订旧实例,再绑定新实例
关闭面板仍触发回调 静态事件漏写 OnDisable 退订 使用同一个命名方法移除监听
HUD 不刷新或绑定错玩家 查找时对象尚未激活,或存在多个玩家 等待场景加载完成,改为显式注入正确实例

验收标准可以写成三条可重复的断言:一次有效伤害对应一次 HUD 刷新;HUD 停用时对应零次;每次重载完成只绑定当前场景的玩家。事件来源从生命值替换成敌人死亡或任务完成时,也沿用相同的所有权与解绑规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

清理事件订阅和场景引用

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

登录哪都通