SceneAPI

O3DE 场景流水线有两个步骤。首先，场景生成器读取场景文件的内容，并将其放入名为 “场景图 ”的内存图中。然后，SceneAPI 的各个部分将使用该图。例如，读取的数据可以通过场景设置界面呈现给用户，或转换为 O3DE 数据。这种方法可以为场景管道添加新的格式，同时利用现有的处理工具和代码。

SceneCore

场景管道的核心是 SceneCore 库。SceneCore 提供了整个流水线中使用的所有基础类型、接口和容器，以及用于促进组成 SceneAPI 的各个部分之间通信的多个 EBus。

SceneCore 是资产导入框架的中心库。它提供图形（SceneGraph）和字典（SceneManifest）的存储空间，前者包含导入数据的内存表示，后者包含指导导出过程的组和规则。它还包含各种实用程序，使图形和清单的处理更加容易。最后，它还包含一系列接口，为导入和导出过程提供了通用 “语言”。其中一些接口是必须的，如 IManifestObject 接口，以便实现基本功能。其他接口则是可选的，但建议实施，因为它们可以使代码重复使用。例如，如果要加载自定义网格数据，最好让数据容器实现 IMesh 接口，这样用户界面就知道何时将网格作为可选项呈现给用户，而输出程序也知道如何解释数据。当然，如果不希望这样做，不实现 IMesh 接口将禁用此功能，但新数据仍可在图形中使用。

SceneData

在 SceneData 中可以找到许多接口和基本类型的具体实现。除了有用的默认实现外，SceneData 还包含许多控制场景管道如何从场景文件中提取信息的行为。要加载 .fbx 文件，需要专门使用 FbxSceneBuilder，它负责读取 .fbx 文件并转换为内存中的SceneGraph。SceneBuilderWorker 会使用这些库，并根据 SceneManifest 中的指令将 SceneGraph 转换为 O3DE 资产。

SceneUI

编辑器插件 EditorAssetImporter 为编辑器添加了一个窗口，允许用户配置管道。该窗口中使用的大部分用户界面元素都位于 SceneUI 库中，因此可与其他工具共享。

场景生成器组件

场景流水线各阶段的关键功能由几类场景构建器组件控制。

加载

加载组件在加载开始前创建，并在加载完成后销毁。加载组件的作用范围很广，从加载场景文件到读取特定字段并将其值添加到场景图中。如果加载组件希望在不修改代码的情况下将逻辑注入到现有的加载器中，它们通常可以连接到一个名为 CallProcessor 的特殊 EBus。通过连接到该 EBus，加载过程中的所有事件都会被接收，但会被过滤为组件中绑定的事件。绑定可以通过调用 “BindToCall ”并指定要调用的成员函数来完成。CallProcessor 会查看绑定函数的参数，只有当事件的上下文与参数类型相匹配时，才会调用该函数。

生成

为了让数据优化器在导出之前运行，会调用生成事件。在生成阶段，组件可以响应场景生成事件，并对场景图进行任意转换。例如，网格优化器生成组件会识别清单中网格组选择的所有网格数据节点，并将优化后的网格添加到场景图中，以便其他场景构建器可以引用。

行为组件

与加载和导出组件不同，行为组件没有有限的生命周期，相反，只要 SceneAPI 处于活动状态，它们就会一直存在。它们的职责也有很大的不同，如：

创建和更新清单
提供图形和清单的元信息
对用户界面事件做出反应

如果某项任务既不适合加载组件，也不适合导出组件，行为组件通常是实现该功能的好地方。

导出

导出组件的工作方式与加载组件类似，但这些组件只存在于处理和导出过程中，而不是加载过程中。这些组件有双重目的，一是将图形中的数据转换为引擎可以理解的数据类型，二是将转换后的数据保存到相应的文件中。保存文件时，必须使用资产处理器提供的路径，以确保生成的文件受到正确监控，并最终保存在缓存中的正确位置。