（109）宏

创建蓝图宏

蓝图宏 可以在 类蓝图 或 关卡蓝图 中进行创建，就像 蓝图函数 一样。蓝图宏还可以放到 蓝图宏库 中。

在另一个蓝图中创建蓝图宏

要想在一个 类蓝图 或 关卡蓝图 中创建 蓝图宏：

1. 在 Graph(图表) 模式，从 My Blueprint（我的蓝图） 选卡下，点击New Macro (新建宏)按钮。

   

2. 输入您的 Blueprint Macro(蓝图宏) 的名称。

   

将会在蓝图编辑器的 Graph Editor（图标编辑器） 选卡的一个新选卡中打开您的 蓝图宏。

您也可以在 我的蓝图 选卡中右击并选择 Macro(宏) 来创建一个 蓝图宏 。

在宏库中创建蓝图宏

在 蓝图宏库 中创建的 蓝图宏 可以用于您的项目中的任何 蓝图 内。

要想在 蓝图宏库 中创建一个 蓝图宏 ：

1. 在 Graph(图表) 模式，从 My Blueprint（我的蓝图） 选卡下，点击New Macro (新建宏)按钮。

   

2. 输入您的 Blueprint Macro(蓝图宏) 的名称。

   

将会在蓝图编辑器的 Graph （图表） 面板的一个新选卡中打开您的 蓝图宏。

您也可以在 我的蓝图 面板中右击并选择 Macro(宏) 来创建一个 蓝图宏 。

构建蓝图宏

当您第一次创建一个 蓝图宏 时，将会打开一个新图表，该图表包含一个 Inputs（输入） 通道节点和一个 Outputs（输出） 通道节点。

在您的 蓝图宏 的 Details（详细信息） 面板中，您可以添加输入和输出执行引脚及数据引脚。您也可以设置您的 蓝图宏 的 Description(描述) 、Category（类别） 及 Instance Color（实例颜色）。

要想添加输入或输出参数：

1. 点击 详细信息 面板的 Inputs（输入） 或 Outputs(输出) 部分的 New(新建) 按钮。

2. 命名该新参数并使用下拉菜单设置其类型。在这个示例中，有一个 整型 数据输入参数 Score 、一个输入执行引脚 Test 及两个输出执行引脚 Win 和 Lose 。

   

   蓝图宏 图表中的通道节点将会自动地更新为正确的引脚。

   

3. 您也可以通过展开参数项来设置一个默认值。

   

要想改变节点边缘上的这个参数的引脚的位置，请使用展开的 详细信息 面板项的向下和向上箭头。

要想给您的 蓝图宏 设置一些功能，请把数据引脚及执行引脚连接到您的 Inputs 和 Outputs 通道节点，并在它们之间创建一个节点网络。

这个示例 蓝图宏 判断输入到 宏 中的分数是否大于获胜的必要分数，然后根据比较结果触发不同的输出执行流程 。注意，这里通过使用 详细信息 面板中的向上和向下箭头翻转了 Test 和 Score 引脚，以避免在 蓝图宏 图表中出现交叉连线。

和 函数不同 ， 宏 可以具有多个输出执行引脚，所以您可以具有类似这样的执行流程，可以根据图表逻辑的结果 执行不同的输出执行引脚。同时，只要 宏 中的节点不是执行节点，您也可以具有没有执行引脚的 宏 ，这样的宏仅简单地操作数据。

实现宏

有很多种把 宏 节点添加到另一个 蓝图 图表中的方法。和 Function(函数) 节点及 Custom Event(自定义事件) 调用节点一样，您也可以在您的 蓝图 中添加多个 宏 节点的副本。

要想添加一个 宏 ，只需右击图表并在弹出的关联菜单中选择 Macro（宏） 即可。

您可以从另一个节点的引脚出拖拽并释放鼠标，如果该节点具有相应的变量类型和流程方向，那么该 宏 将出现在关联菜单中。

当然，您可以从 我的蓝图 选卡中拖拽该 宏 并把它放置到图表中。

一旦将 宏 节点添加到了图表中，它的处理就和其他任何节点一样，输入和输出引脚可以相应地进行连接。双击宏 节点将会打开 宏 的图表。