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

蓝图调试

蓝图调试是一种非常强大的功能,允许您在Play In Editor(在编辑器中运行)或Simulate In Editor(在编辑器中模拟)模式下使用断点来中止游戏执行过程,并单步调试任何蓝图图表或关卡蓝图。

调试控件

调试控件允许您在Play In Editor和Simulate In Editor模式下控制游戏的执行过程。当游戏运行时,会在蓝图编辑器中启用这些控件。根据所调试的 蓝图 及当前调试状态的不同, 会在工具条 上出现不同的调试按钮。

debugging_editor.png

当激活 Simulate in Editor 或 Play in Editor模式时, Debug(调试) 选卡和 Blueprint Debugger(蓝图调试器) 都将会显示情境关联的调试按钮。其中 Debug(调试) 选卡可以从 蓝图编辑器 中的 Graph(图表) 模式下打开。

调试控件允许您在Play In Editor和Simulate In Editor模式下控制游戏的执行过程。当游戏运行时会启用这些控件。根据所调试的 蓝图 及当前调试状态的不同, 会在工具条 上出现不同的调试按钮。一些控件仅当遇到相关 断点 时才会激活。

blueprint_debugger.png

断点

当从编辑器中运行游戏时,Breakpoints(断点) 可以在任何点处中止游戏的执行过程。属于一个蓝图或关卡蓝图的所有图表的所有断点都会显示在 Debug(调试) 选卡中。该列表中的断点名称都有超链接,您可以点击它们,并直接跳转到 Graph(图表) 选卡中和那个断点相关的节点处。

您可以在要执行的图表中任何节点上设置断点,比如 Function Calls(函数调用)Flow Control(流程控制) 操作,只需通过右击节点并选择 Add breakpoint(添加断点) 即可设置断点。当已经在一个节点上设置了断点时,会在该节点的左上角上显示一个图形。

Blueprint Debugging - Breakpoint Enabled

通过右击断点并选择 Disable breakpoint(禁用断点) 或者点击 Debug(调试) 菜单中断点旁边的图标将其关闭,可以禁用断点。这个处理也可以通过右击 Debug(调试) 选卡中的断点并选择 Disable breakpoint(禁用断点) 来完成。

Blueprint Debugging - Breakpoint Disable Option

这样做时断点会留在原处,但是当执行该节点时它不会使游戏停止。已禁用的断点仅显示为一个断点轮廓。

Blueprint Debugging - Breakpoint Disabled

要想启用已禁用的断点,请右击该节点并选择 Enable breakpoint(启用断点) 或点击 Debug(调试) 选卡中断点附近的图标。这个处理也可以通过右击 Debug(调试) 选卡中的断点并选择 Disable breakpoint(禁用断点) 来完成。

Blueprint Debugging - Breakpoint Enable Option

通过右击一个节点或者右击 Debug(调试) 选卡中的断点,并选择 Remove breakpoint(删除断点) ,可以删除断点。

当碰到一个断点时,图表将会专注于这个包含该断点的节点,并在断点上显示一个指示符。

Blueprint Debugging - Breakpoint Hit Indicator

另外,视口将会显示一个覆盖层,来告知玩家游戏已中止,正在进行调试。

Blueprint Debugging - Viewport overlay

调试选卡和蓝图调试器

Debug(调试) 选卡显示了设计师指定的重要信息,信息以断点、查看值及属于已经执行过的蓝图的所有节点的堆栈追踪的形式显示。当使用断点时,这个窗口也显示了用于控制游戏执行的控件。

变量值查看器

Watch values(查看值) 允许您在执行过程中快速并轻松地查看变量的值。当调试遇到一个断点后,所有的选中Actor及关卡蓝图的查看值都会显示在调试窗口中,并且随着您单步调试整个图表,这些查看值会随之更新。

Blueprint Debugging - Watch Values

在图表中,正在查看的值可以直接以气泡的形式显示在变量的上方。

Blueprint Debugging - Watch Value Info Bubble

要想启用显示查看信息气泡的功能,仅需简单地点击变量名称旁边的放大镜(Blueprint Debugging - Watch Value Button)即可。

执行追踪

Execution Trace(执行追踪) 栈显示了所执行的节点的列表,最近执行的节点显示在顶部。

Blueprint Debugging - Execution Trace Stack

这个列表随着您单步调试整个图表而进行更新。