Language:
Share
此中文页面内容对应的英文页面有后续更新,如需浏览最新文档可切换至英文页面浏览。

蓝图宏 从本质上讲和合并的节点图表一样。它们具有由通道节点指定的一个入口点和一个出口点 。每个通道可以具有多个执行引脚或数据引脚,当在其他 蓝图 及图表中使用该宏节点时这些引脚会呈现在宏节点上。

创建蓝图宏

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

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

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

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

    new_macro_blueprint.png

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

    name_macro_blueprint.png

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

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

add_macro_rtclick.png

在宏库中创建蓝图宏

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

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

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

    library_new_macro.png

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

    library_name_macro.png

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

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

library_macro_rtclick.png

构建蓝图宏

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

input_output_macro.png

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

new_macro_details.png

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

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

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

    macro_details.png

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

    macro_tunnels_with_pins.png

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

    macro_details_expanded.png

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

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

score_comparison_example_macro.png

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

move_pin_arrows.png

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

data_macro.png

实现宏

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

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

right_click_add_macro.png

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

pin_macro_summon.png

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

macro_drag_1.png

macro_drop_1.png

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