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

蓝图用户指南:变量

概述

Variables(变量) 是存放一个值或引用世界中的一个Object或Actor的属性。这些用户界面 内部访问,或者通过设置使得可以在外部进行访问, 以便应用放置在关卡中的蓝图实例的设计人员可以修改它们的 值。

变量显示为圆角方框,方框内包含了变量的名称:

Variable Nodes

关于使用Matinee修改特定类型的变量的信息,请惨重啊使用Matinee修改蓝图属性

变量类型

您可以创建各种类型的变量,包括数据类型的变量(比如布尔型、整型及浮点型)及用于存放类似于Object、Actor及特定类的引用型变量。 您还可以创建每种变量类型的数组 。每种变量类型都进行了颜色编码,以方便识别:

变量类型

颜色

示例

应用

Boolean(布尔型)

红色

RedWire.png

红色变量代表布尔型(true/false)数据。

Integer(整型)

蓝绿色

CyanWire.png

蓝绿色变量代表整型数据或者没有小数位的数值,比如0、152和 -226。

Float(浮点型)

绿色

GreenWire.png

绿色变量代表浮点型数据或具有小数位的数值,比如 0.0553、101.2887和 -78.322。

String(字符串)

洋红色

MagentaWire.png

洋红色变量代表字符串型数据或者一组字母数字字符,比如 Hello World

Text(文本)

粉色

PinkWire.png

粉色变量代表显示的文本数据,尤其是在文本需要进行本地化的地方。

Vector(向量)

金黄色

GoldWire.png

金黄色变量代表向量型数据,或者说是代表由三个浮点型数值的元素或坐标轴构成的数值,比如XYZ 或 RGB 信息。

Rotator(旋转量)

紫色

PurpleWire.png

紫色变量代表旋转量数据,这是一组在三维空间中定义了旋转度的数值。

Transform(变换)

橙色

OrangeWire.png

橙色变量代表变换数据,它包括平移(三维位置)、旋转及缩放。

Object(对象)

蓝色

BlueWire.png

蓝色变量代表Objects(对象), 包括 LightsActorsStaticMeshesCamerasSoundCues

我的蓝图选卡中的变量

我的蓝图 面板允许给 蓝图 添加自定义的变量,且列出了所有的现有变量, 包括在 组件列表 中添加的组件实例变量 或通过在图表中通过把一个值提升为变量而创建的变量。

My BLueprint Pane

创建变量

我的蓝图 中,通过使用 New Variable 按钮可以直接添加新变量。 您可以在 我的蓝图 选卡中命名该变量,并在 详细信息 选卡中设置其类型及其他属性。

Variable Details Pane

要想添加一个新变量:

  1. 我的蓝图 选卡内,在文本框中输入该变量的名称,并按下 回车 键。

    Variable Name

  2. 详细信息 选卡中,从 Variable Type(变量类型) 菜单中选择您想添加的变量的类型。

    Set New Variable Type

    某些变量类型需要展开来查看需要的子菜单项,比如对象或结构体。

    New Variable Type Submenu

  3. 如果您正在创建这种变量类型的数组 ,请点击 Variable Type(变量类型) 下拉框旁边的Array(数组)按钮。

    example_variable_array.png

提升变量:

您可以把一个 节点 上的任何输入或输出引脚提升为变量,除非该引脚是无类型的 数组 引脚。

set_light_color_node.png

  1. 右击您想提升为变量的引脚,然后从弹出的菜单中选择 Promote to Variable(提升为变量)

    promote_to_variable.png

  2. 新变量名称 菜单中输入您的新变量的名称。

    name_promoted_variable.png

图表上将会出现到那个新变量的引用。将一个输入引脚提升为变量将会创建一个Get节点,将一个输出引脚提升为变量将会创建一个Set节点。

promoted_variable_reference.png

您的新变量将会列出在 我的蓝图 选卡中,在那里您可以选择它并在 Details(详细信息) 选卡中编辑它的详细信息。

编辑变量

变量值可设置为蓝图节点网络的一部分,或者在执行前设置为默认值。要想设置变量的默认值:

  1. 在蓝图编辑器中选择 Defaults(默认) 模式或在 Components(组件)Graph(图表) 模式中的 Window(窗口) 菜单内打开 Blueprint Defaults(蓝图默认值) 选卡。

    defaults_window_menu.png

  2. 在您的变量名称的右侧输入想使用的默认值。

    blueprint_details_variable_callout.png

    如果您在默认值列表中没有看到你的变量,那么请确定您点击了 Compile Needed(编译需要编译的内容) 按钮。

重命名变量

要想重命名一个变量:

  1. 我的蓝图 选卡中右击变量名称,并在出现的菜单中选择 Rename(重命名)

    rename_variable_menu.png

  2. 在文本框中输入新变量的名称,并按下 回车 键来保存它。

    rename_variable.png

变量属性

您可以在 详细信息 面板中设置一个变量的所有属性。某些变量的属性数量会比这里显示的属性数量更多,比如向量的 Expose to Matinee(暴露给Matinee) 属性或 像 整型浮点型 这样的数值变量的 Slider Range(滑块范围) 属性。

属性

描述

Variable Type(变量类型)

设置下拉菜单中的变量类型,并决定该变量是否是个数组。

Editable(可编辑)

设置是否可以在 Blueprint Defaults(蓝图默认值)蓝图详细信息 面板中编辑该变量的值。

Tooltip(工具提示信息)

设置该变量的工具提示信息。

Private(私有)

设置该变量是否应该是私有变量,如果是私有的,则不能被该 蓝图 的子类所修改。

Category (类目)

选择一个现有类目或者输入一个新类目的名称。设置类目决定了在 蓝图默认值我的蓝图 选卡及 蓝图详细信息 选卡中该变量出现的位置。

Replication(复制)

选择是否应该在客户端之间复制该变量的值、是否复制该值、是否应该通过调用函数产生一个通知。

获取&设置变量值

变量也可以作为您的蓝图网络的一部分来进行编辑,通过Get和Set节点来完成。创建这些节点的最简单的方法是,从变量选卡中直接拖拽变量到事件图表中, 将会出现一个小菜单,询问您是否要创建一个Get或Set节点。

VariableGetSet.png

Get 节点

Get节点向部分节点网络提供一个变量值。一旦创建这些节点,可以把它们连入到取入适当类型的任何节点中。

GetVariable.png

Set节点

Set节点允许您修改变量的值。注意,这些节点必须通过执行引脚连线进行调用才能执行。

SetVariable.png

当从我的蓝图选卡中进行拖拽时可以使用的快捷方式

Ctrl-拖拽

创建一个Get节点。

Alt-拖拽

创建一个Set节点。