游戏客户端架构 / 系统课时
移动前预检测能解决哪些问题
移动前预检测能解决哪些问题
角色高速移动时可能出现越过薄墙、撞向复杂墙角后抖动,或在切换碰撞体尺寸时嵌入障碍。移动前预检测通过沿预期位移方向扫描角色占用空间,提前识别障碍并限制可移动距离。本课使用 Unity 胶囊扫描实现基本预检测,同时明确它与实际碰撞求解的职责边界。
学习目标
- 区分移动前扫描、当前位置重叠检测与移动后的碰撞处理。
- 使用 Physics.CapsuleCast 实现沿运动方向的空间预检测。
- 理解安全间距、扫描盲区和最终碰撞验证的必要性。
预检测应该放在移动流程的哪里
移动前预检测不是重新实现整个物理引擎,而是在正式移动前回答两个问题:预期路径上是否存在障碍,以及沿当前方向最多能移动多远。
一种实用的执行顺序是:读取输入、计算本帧位移、构建角色胶囊、执行空间扫描、按命中距离限制位移、调用控制器 Move,最后处理碰撞反馈。

不同检测方法解决的问题并不相同:
| 检测方法 | 适合回答的问题 | 主要局限 |
|---|---|---|
| Raycast | 某条射线上有没有障碍 | 不代表角色整个体积 |
| CapsuleCast | 胶囊沿方向移动是否会碰撞 | 无法发现扫描开始时已有的重叠 |
| CheckCapsule | 目标姿态或空间是否已被占用 | 不检查从当前位置到目标位置的完整路径 |
| CharacterController.Move | 本次位移实际受到哪些碰撞限制 | 不直接提供完整的前瞻扫描结果 |
对于胶囊形角色,单根 Raycast 往往遗漏肩部、底部或侧面障碍,因此需要与角色占用空间相匹配的形状扫描。
使用 CapsuleCast 限制前进距离
下面实现一个可直接挂载的简化组件。它针对水平移动计算胶囊扫描:如果命中障碍,就预留一小段安全距离后再移动。该组件只负责演示碰撞前扫描,不包含重力、跳跃、平台运动或完整贴墙滑动算法。
场景准备:Player 挂载 CharacterController,Transform Scale 设为 (1,1,1);墙壁挂载 Box Collider。将墙壁放在 Default 层,确保扫描遮罩包含 Default,并且该层也参与控制器的正常碰撞。
创建 PrecheckedMover.cs:
using UnityEngine;
[RequireComponent(typeof(CharacterController))]
public class PrecheckedMover : MonoBehaviour
{
[SerializeField] private float speed = 4f;
[SerializeField] private float clearance = 0.02f;
[SerializeField] private LayerMask obstacleMask = ~0;
private CharacterController controller;
private void Awake()
{
controller = GetComponent<CharacterController>();
}
private void Update()
{
float x = Input.GetAxisRaw("Horizontal");
float z = Input.GetAxisRaw("Vertical");
Vector3 input = Vector3.ClampMagnitude(new Vector3(x, 0f, z), 1f);
Vector3 delta = input * speed * Time.deltaTime;
float distance = delta.magnitude;
if (distance < 0.0001f) return;
Vector3 up = transform.up;
Vector3 center = transform.TransformPoint(controller.center);
float radius = controller.radius;
float halfSegment = Mathf.Max(0f, controller.height * 0.5f - radius);
Vector3 top = center + up * halfSegment;
Vector3 bottom = center - up * halfSegment;
Vector3 direction = delta / distance;
// 扫描整个胶囊的移动轨迹,而不是只扫描中心射线。
if (Physics.CapsuleCast(top, bottom, radius, direction,
out RaycastHit hit, distance + clearance,
obstacleMask, QueryTriggerInteraction.Ignore))
{
// 在障碍前停下,避免把安全间距算入允许位移。
distance = Mathf.Min(distance, Mathf.Max(0f, hit.distance - clearance));
}
// 保留控制器的最终碰撞约束,不直接修改 Transform。
controller.Move(direction * distance);
}
}该示例假设角色保持竖直、物体缩放为 1,并使用旧版 Input Manager。代码通过 TransformPoint 计算世界空间中心,在旋转保持竖直且不缩放的前提下构建胶囊端点。
预期结果:在角色前方放置一面厚度 0.10 米的薄墙。Play 模式下持续按前进键,角色会在接近墙壁时停止,而不是直接把目标位置设置到墙后。若场景中无障碍,角色按输入方向移动。
为了验证扫描是否提前命中,可在 CapsuleCast 的命中分支中临时添加日志:
Debug.Log($"预检测命中:{hit.collider.name}");这是片段示例,必须插入上述脚本的命中分支内部,因为它依赖局部变量 hit。预期输出为类似下面的控制台消息,具体名称由场景对象决定:
预检测命中:Wall此处假设被命中的墙体对象名称为 Wall。调试完成后可移除逐帧日志,避免控制台持续刷屏。
为什么扫描成功仍可能出现异常
预检测主要减少明显的路径碰撞问题,但不能承诺角色绝不穿透,也不能替代控制器的碰撞求解。
首先,CapsuleCast 通常不会检测扫描开始时已经与胶囊重叠的碰撞体。如果角色因传送、出生点放置或碰撞尺寸变更而处于障碍内部,单纯执行扫描可能无法发现初始重叠。这时需要额外进行 OverlapCapsule 或 CheckCapsule 一类的占用检查,并设计合理的脱困行为。
其次,示例使用整个期望方向扫描,遇到斜向墙壁时可能直接缩短位移,甚至停止,而没有充分保留沿墙面的移动分量。这是一种保守策略,并不是成熟的滑动求解算法。正式角色控制器应让 Move 处理正常碰撞与滑动,预检测则重点用于高速位移、特殊冲刺或明确的空间验证。
还需要注意以下边界:
- 碰撞层不一致:扫描忽略的层可能仍阻挡 Move,反过来也可能导致不必要的提前停止。
- 触发器参与检测:示例通过 QueryTriggerInteraction.Ignore 排除了触发器,避免普通交互区域阻挡移动。
- 其他对象持续运动:扫描完成后障碍仍可能移动,预检测结果不是未来时刻的绝对保证。
- 安全间距不合理:间距过大使角色看似隔空停住,过小可能出现视觉接触抖动。
- 检测自身碰撞体:扫描环境包含自身的其他 Collider 时,必须通过图层隔离或命中过滤避免误判。
如何验证预检测的实际价值
测试时不要只检查一堵墙。建议建立薄墙、门框、墙角和狭窄通道四种场景,分别用正常移动速度和较高冲刺速度执行测试。
- 记录无预检测时的移动表现,确认 CharacterController.Move 本身的碰撞效果。
- 开启预检测,检查薄墙前是否正常停下,且不会产生明显的过大空隙。
- 从不同角度接近墙角,观察是否因保守扫描损失了正常贴墙滑动能力。
- 将角色初始位置故意放入障碍,确认初始重叠需要独立检查,而不是错误地依赖 CapsuleCast。
- 使用相同输入、帧率条件和场景比较结果,避免把其他移动代码的变化归因于预检测。
预检测负责提前判断可用空间,Move 负责实际移动时的碰撞处理,而重叠检测负责识别已经占用的空间。把这三者分工清楚,才能在减少明显穿透的同时,避免因过度拦截造成新的卡顿。