文档

Unity 引擎

Unity 引擎

事件函数执行 Order

了解 Unity 内置事件函数的执行 Order,以便可以响应事件并以正确的 Order 更新游戏状态。
阅读时间9 分钟最后更新于 5 天前

下图提供了 MonoBehaviour 脚本组件生命周期内运行的事件函数的执行顺序的高级关卡 Overview。为便于阅读,图表的作用域仅限于脚本Lifecycle的Key部分,并为上下文提供了一些额外的内部部子系统更新。完整的播放PlayerLoop是针对指定的系统和子系统的更长和更复杂的更新序列,这些系统和子系统以定义的默认OrderOther运行。要检索完整的 Player Loop 及其所有系统,可以使用 PlayerLoop API。您还可以使用此 API 通过删除系统、添加您自己的系统以及更改更新 Order 来自定义 Player Loop 序列。
ON每个回调的含义和限制的更多信息,请参阅 MonoBehaviour API 参考的消息部分。

Order of execution for event functions during the lifecycle of a MonoBehaviour script.

Scene 加载和卸载之前

上图中未显示
SceneManager.sceneLoaded
和
SceneManager.sceneUnloaded
事件,允许分别在加载和卸载 Scene 时接收回调。Unity 在
OnEnable
之后但在对 Scene 中的所有对象进行
Start
之前引发
sceneLoaded
事件。有关细节信息和用法示例,请参阅相关的 API 参考页面。
有关在执行流程中包含 Scene 加载的图表,请参阅禁用 Domain 和 Scene 重新加载的细节

ON Editor 启动时运行代码

有时,make代码的某些部分ON Unity Editor 启动时或运行时时立即运行,无需Any额外的用户Action,也无需将代码作为 MonoBehaviour 脚本的一部分,可能会很有用。您可以将
[InitializeOnLoad]
属性应用于具有 Static 构造函数的类,从而在 Editor 启动时运行代码,而无需任何用户 Action。或者,可将
[InitializeOnLoadMethod]
属性应用于各个方法。有关更多信息和使用示例,请参阅这些Attributes的 API 引用。

运行时时初始化ON运行代码

您可以通过将
[RuntimeInitializeOnLoadMethodAttribute]
应用于方法来运行运行时应用程序的 ON 初始化代码。还可以指定一个
RunTimeInitializeLoadType
属性参数来控制在 Player Loop 中属性代码的执行位置。有关使用此属性标记的方法的执行 Order 的更多信息,请参阅 API 参考以了解
RuntimeInitializeOnLoadMethodAttribute
。

内部动画更更新

下图显示了常规动画更新 Loop 的执行 Order,并展开上图中标记为内部动画更新的节点:

Order of execution for the regular Animation update loop.

从 MonoBehaviour 派生的脚本调用图中所示的以下动画 Loop 回调:
派生自
StateMachineBehaviour
的 ON 脚本调用其他与动画相关的事件函数:
图中显示的Other动画函数是动画系统的内部函数,用于上下文。这些函数具有关联的性能分析器 Markers,因此您可以使用性能分析器查看 Unity 在帧中调用它们的时间。了解 Unity WhenCalls这些函数可以帮助您准确了解所调用的事件函数的执行When。有关动画函数和性能分析器 Markers 的完整执行 Order,请参阅性能分析器 Markers。

渲染

此执行 Order 仅适用于内置渲染管道。有关基于可编程渲染管线的渲染管线中的执行 Order 的细节,请参阅通用渲染管道或高清渲染管道文档的相关部分。如果要在渲染之前立即开展工作,请参阅 Application.onBeforeRender。
  • 在 Camera 剔除 Scene 之前调用。剔除确定哪些对象对 Camera 可见。在进行剔除之前立即调用
    OnPreCull
    。
  • 当对象对任何 Camera 可见/不可见时调用。上面的流程图中未显示
    OnBecameInvisible
    ,因为Object 可能随时变为不可见。
  • 如果 Object 可见,则为每个 Camera 调用一次。
  • 在 Camera 开始渲染 Scene 之前调用。
  • Done All 常规场景渲染完成后调用。此时可以使用 GL 类或图形。DrawMeshNow 绘制自定义几何体。
  • 在 Camera 完成 Scene 渲染后调用。
  • 在场景渲染完成后调用以允许对图像进行 POST 处理,请参阅 POST 处理特效。
  • 帧调用多个次以响应 GUI 事件。首先处理 Layout 和 Repaint 事件,然后为每个输入事件处理 Layout 和键盘/鼠标事件。
  • OnDrawGizmos
    用于在“场景”视图中绘制小工具以实现可视化。
注意
OnPreCull、OnPreRender、OnPostRender 和 OnRenderImage 是在 MonoBehaviour 脚本上调用的内置 Unity 事件函数,但仅当这些脚本附加到与已启用的 Camera 组件相同的对象时。如果要接收对不同对象所挂的 MonoBehaviour 的
OnPreCull
、
OnPreRender
和
OnPostRender
的等效回调,则必须使用等效委托(注意名称中的小写
on
)Camera.onPreCull、Camera.onPreRender 和 Camera.onPostRender,如脚本参考相关页面的代码示例所示。

协程和异步任务的恢复

根据使用的 yield 指令,暂停的协程可以在执行序列的不同点恢复。例如,使用
WaitForEndOfFrame
的协程在帧结束时恢复,而使用
WaitForFixedUpdate
的协程在已修复的更新步骤结束时恢复。如需了解更多信息,请参阅协程。
常规 .NET 任务和异步方法在
Update
阶段恢复。与协程类似,Unity 的自定义
Awaitable
类可以根据您在等待时使用的方法在不同点恢复。有关更多信息,请参阅使用 Awaitable 类异步编程。
注意
不能保证恢复协程和异步任务之间的确切执行 Order。可等待项会分组到全体学员,并按其等待的 Order 执行。

将 MonoBehaviour 与 Entities 结合

使用实体组件系统 (ECS) 时,Unity 会将 ECS System 组更新合并到 Player Update Loop 中。
您可以使用 Entities 系统 窗口View ECS System组相对于完整播放PlayerLoop的更新Order。有关更多信息,请参阅 Entities 包文档中的 Update Order of systems。

局限性

General 中,您不能依赖于为不同游戏对象调用相同事件函数的 Order,但 When the Order is显式documented or settable 除外。
无法指定为同一 MonoBehaviour 脚本的不同实例调用事件函数的 Order。例如,一个 MonoBehaviour 的
Update
函数可以在另一个游戏对象(包括自己的父或子游戏对象)上的同一 MonoBehaviour 的
Update
函数之前或之后调用。
要在不同 MonoBehaviour 脚本之间配置执行 Order,请参阅 Script Execution Order。

其他资源