虚幻引擎 Capsule Trace by Channel 节点-虚幻引擎

Capsule Trace by Channel 是虚幻引擎中一种基于通道的胶囊体扫描检测，用于检测从一个起点到终点路径上，与指定碰撞通道发生响应的物体。

你可以把它想象成将一个虚拟的胶囊体从A点“发射”到B点，如果途中碰到了任何“感兴趣”的物体（比如墙壁、敌人），就会返回碰撞信息。

下面是该节点的完整使用指南，包含具体操作步骤和一个实战案例。

在蓝图中，你可以通过搜索 Capsule Trace By Channel 找到它。其主要参数如下：

参数名称	类型	说明
Start	Vector (向量)	胶囊体扫描的起点位置。
End	Vector (向量)	胶囊体扫描的终点位置。
Radius	Float (浮点数)	胶囊体的半径。
Half Height	Float (浮点数)	胶囊体半高，即从中心到半球体顶端的距离。
Trace Channel	Enum (枚举)	指定本次检测使用的通道，只会检测对该通道有响应的物体。
Trace Complex	Boolean (布尔)	是否使用复杂碰撞进行检测。True更精确但性能消耗更大。
Actors to Ignore	Array (数组)	需要被忽略的Actor列表。
Draw Debug Type	Enum (枚举)	调试时是否在场景中绘制扫描线。
Ignore Self	Boolean (布尔)	是否忽略执行该检测的Actor自身。
Out Hit	Hit Result (结构体)	输出，碰撞结果，包含碰撞点、法线、被碰撞的Actor等信息。
Return Value	Boolean (布尔)	输出，`True`表示检测到了碰撞。

下面通过一个完整的案例，演示如何使用该节点实现一个简单的“冲刺（Dash）”技能检测。

案例目标：当玩家按下冲刺键，角色向前快速移动。我们使用 Capsule Trace by Channel 检测冲刺路径上是否有墙壁，如果有，则在墙壁前停下，防止角色穿墙。

从输入事件节点拉出连线，搜索并添加 Capsule Trace by Channel 节点。
连接 Start 和 End 引脚：
- Start：获取角色的当前位置，连接 Get Actor Location 节点。
- End：计算冲刺终点。使用 Get Actor Forward Vector (获取角色的前方向向量) 乘以 冲刺距离 (如1000)，再与角色当前位置相加 (Vector + Vector)，将结果连接到 End。
设置 Radius 和 Half Height：为了匹配角色碰撞体，可以获取角色的胶囊体组件 (Get Capsule Component)，然后分别获取其半径 (Get Unscaled Capsule Radius) 和半高 (Get Unscaled Capsule Half Height) 并连接。
设置 Trace Channel：根据需求选择，通常用于检测世界静态物体，可选择 Visibility 或 WorldStatic 通道。
设置 Actors to Ignore：添加一个 Make Array 节点，并将 Self (自身引用) 添加进去，防止检测到自身。
设置 Draw Debug Type：为方便调试，可暂时选 For One Frame。

从 Capsule Trace by Channel 节点的 Return Value 引脚拉出分支（Branch）。
如果为真 (Hit)：说明路径上有障碍物。从 Out Hit 引脚拉出 Break Hit Result 节点，获取 Impact Point (撞击点)。然后使用 Get Actor Location 和 Get Actor Forward Vector 等计算角色应停下的位置，并通过 Set Actor Location 或 Add Movement Input 实现。
如果为假 (No Hit)：说明路径畅通。执行正常的位移逻辑，如使用 Launch Character 或 Add Movement Input。

Multi Capsule Trace by Channel：标准的 Capsule Trace by Channel 只返回第一个阻挡命中。如果你需要获取扫描路径上的所有命中物体（例如，一个穿透技能伤害所有敌人），应使用 Multi Capsule Trace By Channel。它会返回一个包含所有命中的数组。
自定义检测通道：你可以在 项目设置 -> 引擎 -> 碰撞（Collision） 中，创建自己的 Trace Channel。之后可以在Actor的碰撞预设中，设置该Actor对此自定义通道的响应（阻挡、重叠、忽略），实现更精细的检测控制。

检测不到物体：检查执行追踪的Actor和目标的碰撞设置，确保目标的碰撞响应中，对你使用的 Trace Channel 设置为“阻挡（Block）”或“重叠（Overlap）”。
检测到不该检测的物体：检查 Actors to Ignore 数组是否正确包含了需要忽略的Actor。也可以检查目标Actor的碰撞响应设置。
检测结果不准确：检查 Radius 和 Half Height 是否设置正确。也可尝试将 Trace Complex 设为 True 以提高精度。