虚幻引擎 Event BeginPlay 节点

一、Event BeginPlay 概述

Event BeginPlay 是虚幻引擎5中最核心的事件节点之一。它在 Actor 被生成到游戏世界并完成所有组件初始化后，仅执行一次。

可以把它理解为这个 Actor 的“出生”事件——当游戏开始，引擎会调用它，告诉蓝图：“游戏开始了，该你上场了！”。它是进行各种初始化工作的理想位置，比如生成其他 Actor、启用玩家输入、初始化角色装备等。

二、具体操作步骤

案例一：基础入门——在游戏开始时打印文字

这是最基础的入门案例，帮助理解 Event BeginPlay 的执行时机。

第1步：创建蓝图类

• 在 Content Browser（内容浏览器） 中，点击 New 按钮，选择 Blueprint Class

• 在 Pick Parent Class 窗口中选择 Actor

• 为蓝图命名（例如 BP_BeginPlayDemo），然后双击打开蓝图编辑器

第2步：添加 Event BeginPlay 节点

• 进入 Event Graph（事件图表） 选项卡

• 在图表中右键单击，搜索并添加 Event BeginPlay 节点

第3步：添加 Print String 节点并连接

• 从 Event BeginPlay 的白色执行引脚（输出端）拖出连线

• 松开鼠标，搜索并添加 Print String 节点

• 在 Print String 节点的 In String 输入框中，输入你想显示的文字，比如 "Hello, 游戏开始了！"

第4步：编译并测试

• 点击工具栏的 Compile（编译） 按钮

• 关闭蓝图，将 BP_BeginPlayDemo 从内容浏览器拖入关卡场景中

• 点击 Play 运行游戏，屏幕左上角会显示你输入的文字

案例二：实用案例——为 Actor 启用玩家输入

这是开发交互式物体（如开关灯、开门）的常用模式。

第1-2步：同案例一，创建 Actor 蓝图并添加 Event BeginPlay 节点

第3步：获取玩家控制器

• 在图表中右键单击，搜索并添加 Get Player Controller 节点

• 这个节点会获取当前控制游戏的玩家控制器

第4步：启用输入

• 在图表中右键单击，搜索并添加 Enable Input 节点

• 按以下方式连接节点：

  • Event BeginPlay 的输出执行引脚 → Enable Input 的输入执行引脚

  • Get Player Controller 的返回值 → Enable Input 的 Player Controller 输入引脚

• Enable Input 的 Target 目标默认为 Self（即当前 Actor 自身）

第5步：添加按键响应

• 现在你可以添加任何 Input Event 节点（如按键事件、鼠标点击事件）

• 当玩家按下对应按键时，就会执行你连接的操作逻辑

案例三：进阶案例——在 BeginPlay 中初始化增强输入系统

在 UE5 中，旧版输入系统已被 Enhanced Input（增强输入系统） 取代。以下是在 BeginPlay 中注册输入映射的典型流程：

核心逻辑（从左到右依次执行）：

1. Event BeginPlay 触发 —— 角色被生成并初始化后执行

2. Get Controller → Cast To PlayerController —— 获取并转换为玩家控制器类型

   为什么需要转换？因为 Get Controller 返回的是基类 AController，而增强输入子系统只存在于 APlayerController 中

3. Get Enhanced Input Local Player Subsystem —— 从玩家控制器中提取输入子系统

4. Add Mapping Context —— 将输入映射上下文（如 IMC_FPSInput）绑定到玩家控制系统

5. 之后可继续执行其他初始化逻辑，如生成武器、设置 FOV 等

三、常见应用场景

四、重要注意事项

1. 仅执行一次：Event BeginPlay 在 Actor 生命周期中只执行一次，不同于每帧执行的 Event Tick

2. 执行顺序：BeginPlay 在 Actor 的所有组件初始化完成后才执行，在 Event Tick 之前执行

3. 必须放置在场景中：蓝图必须被拖入关卡场景（或通过代码生成），BeginPlay 才会被执行

4. 记得编译：修改蓝图后务必点击 Compile 按钮，否则修改不会生效

5. 关卡中的 Actor：如果 Actor 在关卡加载时就存在，BeginPlay 在游戏开始时执行；如果是游戏过程中动态生成的，则在生成时执行

感谢您的来访，获取更多精彩文章请收藏本站。