Version: 2023.2
特性
Null 引用异常

UnityEvent

借助 UnityEvent 可让用户驱动的回调从编辑时间一直持续到运行时,无需进行额外的编程和脚本配置。

UnityEvent 对许多方面都很有用:

  • 内容驱动的回调

  • 解耦系统

  • 持久回调

  • 预配置的调用事件

UnityEvent 可添加到任何 MonoBehaviour,并从标准 .net 委托之类的代码中执行。当 UnityEvent 添加到 MonoBehaviour 时,它会出现在 Inspector 中,并可添加持久回调。

UnityEvent 与标准委托有类似的限制。也就是说,它们会保留对目标元素的引用,而这会阻止对目标进行垃圾收集。如果将 UnityEngine.Object 作为目标,而本机表示消失,则不会调用回调。

使用 UnityEvent

要在 Editor 中配置回调,需执行以下几个步骤:

  1. 确保脚本导入/使用 UnityEngine.Events

  2. 选择 + 图标为回调添加字段

  3. 选择要接收回调的 UnityEngine.Object(可使用对象选择器进行选择)

  4. 选择要调用的函数

  5. You can add more than one callback for the event

在 Inspector 中配置 UnityEvent 时,支持两种类型的函数调用:

  • 静态。静态调用是预配置的调用,具有在 UI 中设置的预配置值。这意味着,在调用回调时,使用已在 UI 中输入的参数调用目标函数。
  • 动态。使用从代码发送的参数调用动态调用,并与正在调用的 UnityEvent 类型相关。UI 会过滤回调,仅显示对 UnityEvent 有效的动态调用。

通用 UnityEvent

默认情况下,Monobehaviour 中的 UnityEvent 动态绑定到 void 函数。但不一定非得如此,因为 UnityEvent 的动态调用支持绑定到最多包含 4 个参数的函数。为此,您需要定义一个支持多个参数的自定义 UnityEvent 类。此定义十分简单:

[Serializable]

public class StringEvent : UnityEvent <string> {}

通过将此类的实例添加到您的类而不是基本 UnityEvent,即可使回调动态绑定到字符串函数。

然后,可通过调用以 string 为参数的 Invoke() 函数来对其进行调用。

UnityEvent 可在其通用定义中定义最多 4 个参数。

特性
Null 引用异常