第4章 蓝图系统基础

4.1 蓝图系统概述

蓝图系统是Unreal Engine的可视化编程工具，允许开发者通过图形化界面创建游戏逻辑，而无需编写传统的代码。它提供了一种直观、高效的方式来开发游戏功能，特别适合： - 设计师和艺术家快速实现游戏机制 - 原型开发和快速迭代 - 不熟悉C++的开发者 - 需要可视化调试的复杂逻辑

4.1.1 蓝图的优势

  • 可视化编程：通过节点和连线创建逻辑，直观易懂
  • 实时调试：可以在编辑器中实时运行和调试
  • 快速迭代：修改后无需编译，立即生效
  • 与C++无缝集成：可以与C++代码相互调用
  • 跨平台支持：在所有UE支持的平台上运行

4.1.2 蓝图的类型

UE5提供了多种类型的蓝图，用于不同的场景：

  1. 演员蓝图（Actor Blueprint）
  2. 最常用的蓝图类型
  3. 基于Actor类，可以放置在场景中

  4. 用于创建具有特定行为的游戏对象

  5. 组件蓝图（Component Blueprint）

  6. 基于ActorComponent类
  7. 可以附加到任何Actor上

  8. 用于创建可重用的功能模块

  9. 关卡蓝图（Level Blueprint）

  10. 每个关卡都有一个关卡蓝图
  11. 用于控制关卡特定的逻辑和事件

  12. 适合处理关卡范围内的交互

  13. 界面蓝图（Widget Blueprint）

  14. 用于创建用户界面
  15. 基于UMG（Unreal Motion Graphics）系统

  16. 支持各种UI元素：按钮、文本、图像等

  17. 动画蓝图（Animation Blueprint）

  18. 用于控制骨架网格体的动画

  19. 支持动画状态机、混合空间等

  20. 蓝图函数库（Blueprint Function Library）

  21. 用于创建可在多个蓝图中重用的函数
  22. 类似于C++中的静态函数

4.2 蓝图编辑器界面

蓝图编辑器是创建和编辑蓝图的主要工具，包含多个面板和工具：

4.2.1 主要面板

  1. 工具栏
  2. 包含蓝图的基本操作：编译、保存、运行、调试等

  3. 显示蓝图的当前状态（是否需要编译）

  4. 我的蓝图（My Blueprint）

  5. 显示蓝图的结构：组件、变量、函数、事件等

  6. 可以快速访问和编辑这些元素

  7. 蓝图图表（Blueprint Graph）

  8. 可视化编程的主要区域

  9. 包含节点和连线，代表蓝图的逻辑

  10. 细节面板（Details）

  11. 显示当前选中元素的属性

  12. 可以编辑这些属性

  13. 组件面板（Components）

  14. 显示蓝图的组件层次结构

  15. 可以添加、删除和编辑组件

  16. 视口（Viewport）

  17. 用于预览蓝图的视觉效果
  18. 仅在某些蓝图类型中可用（如Actor Blueprint）

4.2.2 打开蓝图编辑器

  1. 在内容浏览器中，找到要编辑的蓝图文件
  2. 双击蓝图文件，或右键点击选择"编辑"
  3. 蓝图编辑器将打开

4.2.3 蓝图编辑器的基本操作

  • 平移图表：鼠标中键拖动
  • 缩放图表：鼠标滚轮或按住Alt键+鼠标右键拖动
  • 选择节点：点击节点
  • 多选节点：按住Shift键点击多个节点
  • 移动节点：拖动节点到新位置
  • 复制节点：Ctrl+C和Ctrl+V
  • 删除节点：Delete键

4.3 蓝图变量

变量是蓝图中存储和传递数据的基本单位，可以是各种类型的数据。

4.3.1 变量类型

UE5支持多种变量类型：

  1. 基本类型：
  2. 布尔型（Boolean）：true/false
  3. 整数型（Integer）：-2,147,483,648到2,147,483,647
  4. 浮点型（Float）：带小数点的数字
  5. 字符串（String）：文本
  6. 名称（Name）：内部标识符

  7. 枚举（Enum）：预定义的选项列表

  8. 对象类型：

  9. Actor引用
  10. 组件引用
  11. 类引用
  12. 材质引用

  13. 纹理引用

  14. 容器类型：

  15. 数组（Array）：相同类型的元素集合
  16. 映射（Map）：键值对集合
  17. 集合（Set）：唯一元素的集合

4.3.2 创建变量

  1. 在"我的蓝图"面板中，点击"添加变量"按钮
  2. 选择变量类型
  3. 输入变量名称
  4. 在细节面板中设置变量属性：
  5. 可编辑：在编辑器中是否可见
  6. 可复制：是否随对象复制
  7. 默认值：变量的初始值
  8. 说明：变量的描述

4.3.3 使用变量

  1. 获取变量值：
  2. 从"我的蓝图"面板中拖拽变量到蓝图图表

  3. 选择"获取 [变量名]"

  4. 设置变量值：

  5. 从"我的蓝图"面板中拖拽变量到蓝图图表
  6. 选择"设置 [变量名]"

  7. 连接值到输入引脚

  8. 变量的生命周期：

  9. 实例变量：每个蓝图实例都有自己的变量副本
  10. 全局变量：在整个游戏会话中保持不变
  11. 局部变量：只在函数或事件中可见

4.4 蓝图节点与连线

蓝图节点是蓝图逻辑的基本构建块，每个节点代表一个操作或功能。

4.4.1 节点类型

  1. 事件节点（Event Nodes）
  2. 启动蓝图逻辑的入口点
  3. 响应特定事件：游戏开始、玩家输入、碰撞等

  4. 示例：Event BeginPlay、Event Tick、Event OnActorBeginOverlap

  5. 功能节点（Function Nodes）

  6. 执行特定功能的节点
  7. 可以有输入和输出参数

  8. 示例：Print String、Play Sound、Spawn Actor

  9. 变量节点（Variable Nodes）

  10. 用于访问和修改变量

  11. 分为获取节点和设置节点

  12. 流程控制节点（Flow Control Nodes）

  13. 控制执行流程

  14. 示例：If节点、Branch节点、For Loop节点、While Loop节点

  15. 数学节点（Math Nodes）

  16. 执行数学运算
  17. 示例：Add、Subtract、Multiply、Divide、Sin、Cos

4.4.2 节点引脚

每个节点都有输入和输出引脚：

  • 执行引脚（Execution Pins）：
  • 黄色引脚
  • 控制节点的执行顺序
  • 输入执行引脚（左侧）：接收执行信号

  • 输出执行引脚（右侧）：发送执行信号

  • 数据引脚（Data Pins）：

  • 各种颜色的引脚（根据数据类型）
  • 传递数据值
  • 输入数据引脚：接收数据
  • 输出数据引脚：发送数据

4.4.3 连线节点

  1. 连接执行流程：
  2. 从一个节点的输出执行引脚拖动到另一个节点的输入执行引脚

  3. 表示执行顺序

  4. 连接数据：

  5. 从一个节点的输出数据引脚拖动到另一个节点的输入数据引脚
  6. 传递数据值

  7. 只能连接相同类型的数据引脚（或兼容类型）

  8. 断开连线：

  9. 右键点击连线，选择"断开连接"
  10. 或拖动连线远离引脚

4.5 蓝图函数与事件

函数和事件是蓝图中组织和重用代码的主要方式。

4.5.1 函数（Functions）

函数是可重用的代码块，可以接收参数并返回值。

  1. 创建函数：
  2. 在"我的蓝图"面板中，点击"添加函数"按钮
  3. 输入函数名称

  4. 在蓝图图表中编辑函数逻辑

  5. 函数属性：

  6. 访问修饰符：公共（Public）、私有（Private）、保护（Protected）
  7. 复制引脚：是否在调用时显示所有参数

  8. 纯函数：不修改任何状态，只返回值

  9. 参数设置：

  10. 在"函数细节"面板中，点击"添加输入参数"或"添加输出参数"

  11. 设置参数名称、类型和默认值

  12. 调用函数：

  13. 从"我的蓝图"面板中拖拽函数到蓝图图表
  14. 连接执行流程和数据参数

4.5.2 事件（Events）

事件是响应特定触发条件的代码块，与函数类似，但不需要显式调用。

  1. 预定义事件：

  2. UE提供了许多预定义事件：

    • Event BeginPlay：对象开始播放时触发
    • Event Tick：每帧触发
    • Event OnActorBeginOverlap：与其他对象重叠时触发
    • Event OnComponentHit：组件被击中时触发

  3. 自定义事件：

  4. 可以创建自己的事件
  5. 在"我的蓝图"面板中，点击"添加事件"→"自定义事件"
  6. 输入事件名称

  7. 可以有输入参数，但没有输出参数

  8. 触发事件：

  9. 使用"调用函数"节点调用自定义事件
  10. 预定义事件由系统自动触发

4.6 蓝图调试

调试是开发过程中的重要环节，UE5提供了强大的蓝图调试工具。

4.6.1 基本调试技巧

  1. 打印字符串：
  2. 使用"Print String"节点在屏幕上显示调试信息

  3. 可以设置显示时间、颜色、位置等

  4. 断点：

  5. 在节点上右键点击，选择"添加断点"
  6. 运行时，执行到断点处会暂停

  7. 可以查看变量值和执行流程

  8. 观察变量：

  9. 在调试模式下，将鼠标悬停在变量节点上

  10. 会显示变量的当前值

  11. 单步执行：

  12. 使用调试工具栏中的单步执行按钮
  13. 可以逐节点执行逻辑
  14. 进入、跳过或退出函数

4.6.2 调试模式

  1. PIE（Play In Editor）：
  2. 在编辑器中运行游戏
  3. 可以在游戏运行时编辑蓝图

  4. 支持实时调试

  5. SIE（Simulate In Editor）：

  6. 模拟模式，比PIE更接近实际运行

  7. 支持编辑模式下的调试

  8. 远程调试：

  9. 可以调试运行在设备上的游戏
  10. 需要启用远程调试功能

4.7 蓝图最佳实践

4.7.1 性能优化

  • 避免在Event Tick中使用复杂逻辑：每帧执行会影响性能
  • 使用延迟（Delay）节点代替长时间循环：避免阻塞主线程
  • 合理使用变量类型：选择适当的数据类型，避免不必要的转换
  • 减少节点数量：将复杂逻辑拆分为函数，避免过度复杂的图表
  • 使用蓝图函数库：将重复使用的逻辑放在函数库中

4.7.2 代码组织

  • 使用文件夹组织节点：将相关节点放在同一个文件夹中
  • 命名规范：使用清晰、一致的命名
  • 变量：使用驼峰命名法，前缀表示类型（如bIsVisible、MyActorRef）
  • 函数：使用动词开头（如SpawnEnemy、CalculateDamage）
  • 事件：使用Event前缀（如Event OnPlayerDeath）
  • 注释：为复杂逻辑添加注释，提高可读性
  • 模块化设计：将功能拆分为独立的函数和组件

4.7.3 与C++集成

  • 将性能关键代码放在C++中：复杂的算法、频繁调用的函数
  • 使用蓝图Callable标记C++函数：允许从蓝图中调用
  • 使用BlueprintImplementableEvent标记C++函数：允许在蓝图中重写
  • 使用蓝图宏库：创建可重用的蓝图片段

思考与练习

  1. 什么是蓝图系统？它的主要优势是什么？
  2. UE5提供了哪些类型的蓝图？它们的主要用途是什么？
  3. 蓝图编辑器包含哪些主要面板？它们的功能是什么？
  4. 如何创建和使用蓝图变量？
  5. 蓝图节点有哪些类型？如何连接节点？
  6. 函数和事件有什么区别？如何创建和调用它们？
  7. 蓝图调试有哪些方法？如何使用断点和观察变量？
  8. 蓝图开发的最佳实践有哪些？如何优化蓝图性能？