游戏引擎 / 系统课时
使用 NavMeshAgent 跟随目标
使用 NavMeshAgent 跟随目标
给场景中的敌人添加 NavMeshAgent,让它沿导航网格绕过墙体追逐移动的玩家,而不是直接朝玩家位置穿墙移动。完成后,敌人能按设定的速度和转向速率行走,在目标附近减速停止,且模型位置不会与导航模拟位置互相争夺控制权。
学习目标
- 为 Unity 6 场景烘焙可供敌人行走的 NavMesh。
- 配置移动参数,并以有限频率更新移动目标的位置。
- 验证路径可达性、停止距离及 NavMeshAgent 与 Transform 的同步关系。
烘焙可行走区域
本例适用于 Unity 6 和 AI Navigation 2.x。NavMeshAgent 负责寻路与移动,NavMeshSurface 负责根据关卡几何体生成可行走区域;没有烘焙数据,脚本提交目的地也无法完成追击。
- 打开
Window > Package Manager,在Unity Registry中安装AI Navigation。Unity 6.0 对应的已发布包包括 2.0.9;其他 Unity 6 小版本以 Package Manager 显示的兼容版本为准。 - 创建
Ground(GameObject > 3D Object > Plane),位置(0,0,0)、缩放(2,1,2),形成 20 m × 20 m 地面。再创建Wall(Cube),位置(0,1,0)、缩放(1,2,5),作为不能穿过的墙。 - 新建
EnvironmentLayer,并将Ground、Wall放入该层。创建空对象NavigationWorld,在 Inspector 中通过Add Component添加NavMesh Surface。 - 在
NavMesh Surface设置Collect Objects = All、Include Layers = Environment、Use Geometry = Physics Colliders;Agent Type保持默认Humanoid,单击Bake。
在 Scene 视图检查烘焙出的可行走网格:墙体占据的位置应被排除,墙两侧应存在能够绕行的连通区域。修改墙的位置、尺寸或参与烘焙的几何体后,需要重新 Bake。
配置敌人导航参数
创建空对象 EnemyRoot,位置 (-6,0,-4),添加 Nav Mesh Agent;给它添加一个仅负责显示的 Capsule 子对象,子对象局部位置为 (0,1,0)。再创建 PlayerRoot,位置 (6,0,4),也给它添加可见的 Capsule 子对象。两个 Root 的 Y 坐标都为 0,避免模型中心点与地面导航位置混淆。
在 EnemyRoot 的 Nav Mesh Agent Inspector 中使用以下起步值(场景按 1 Unity 单位 = 1 m 设计)。updatePosition 和 updateRotation 是脚本属性,稍后在 Awake 中明确设为 true:
| 字段 | 推荐值 | 作用 |
|---|---|---|
| Speed | 3.5 | 最高移动速度,m/s |
| Acceleration | 12 | 最大加速度,m/s² |
| Angular Speed | 540 | 最大转向角速度,°/s |
| Stopping Distance | 1.5 | 接近目标时允许的停止范围,m |
| Radius / Height | 0.5 / 2.0 | 导航代理的水平半径与高度,m |
| Auto Braking / Auto Repath | 开 / 开 | 接近终点减速;路径失效时尝试重寻路 |
| Base Offset | 0 | 使代理位置与地面根节点对齐 |
Agent Type 必须与 NavMesh Surface 烘焙类型相同。Radius 还应与该 Agent Type 的烘焙半径相协调;不能仅调小组件半径,就期待已经烘焙的狭窄通道自动变宽。
编写移动目标追击脚本
将下面的完整脚本保存为 EnemyChaseAgent.cs,挂到 EnemyRoot,并把 PlayerRoot 拖入 Inspector 中的 Target 字段。每隔 0.2 秒检查一次玩家位置,只有目标比上次请求位置移动至少 0.5 m,才重新请求路径,避免在 Update 中每帧重复寻路。
using UnityEngine;
using UnityEngine.AI;
[RequireComponent(typeof(NavMeshAgent))]
public sealed class EnemyChaseAgent : MonoBehaviour
{
[SerializeField] private Transform target;
[SerializeField, Min(0.05f)] private float repathInterval = 0.2f;
[SerializeField, Min(0.1f)] private float targetMoveThreshold = 0.5f;
private NavMeshAgent agent;
private Vector3 lastTargetPosition;
private float nextRepathAt;
private bool hasRequestedPath;
private void Awake()
{
agent = GetComponent<NavMeshAgent>();
// 由导航系统统一驱动根节点的位移与朝向。
agent.updatePosition = true;
agent.updateRotation = true;
}
private void Start()
{
if (target == null)
Debug.LogError("EnemyChaseAgent: Target 未赋值", this);
else if (!agent.isOnNavMesh)
Debug.LogError("EnemyChaseAgent: 敌人未在 NavMesh 上", this);
}
private void Update()
{
if (target == null || !agent.isOnNavMesh || Time.time < nextRepathAt)
return;
nextRepathAt = Time.time + repathInterval;
Vector3 targetPosition = target.position;
Vector3 delta = targetPosition - lastTargetPosition;
delta.y = 0f; // 只比较水平移动,避免玩家跳跃引起频繁重寻路。
if (hasRequestedPath &&
delta.sqrMagnitude < targetMoveThreshold * targetMoveThreshold)
return;
// 请求成功不等于已经得到可达的完整路径。
if (agent.SetDestination(targetPosition))
{
lastTargetPosition = targetPosition;
hasRequestedPath = true;
}
}
}预期结果:进入 Play 后,敌人绕过墙走向 PlayerRoot;运行中将玩家沿地面移动超过 0.5 m,敌人会在下次检查后请求新路径。SetDestination 返回 true 只表示请求被接受,路径计算可能需要数帧;此时 pathPending 为 true。
保持 Agent 与 Transform 同步
本例让 NavMeshAgent 拥有位移和水平转向控制权。其内部模拟位置通过 updatePosition = true 同步至 EnemyRoot.transform.position,旋转通过 updateRotation = true 作用于根节点;Capsule 子对象只跟随父节点显示,不再自行移动。

如果敌人同时使用 CharacterController.Move、Rigidbody 直接改位置或 Animator 的 Apply Root Motion,很容易发生滑动、抖动或模型被拉回。当前练习应由 Agent 单独移动根节点,Animator 可读取 agent.velocity.magnitude 驱动走跑动画,但不要再用根运动推动相同的 Transform。复活或传送敌人时,先确认新位置位于 NavMesh 上,再优先使用 agent.Warp(newPosition),而不是只改 transform.position。
验收停止位置与常见故障
- 保持玩家不动:敌人应绕墙前进,接近玩家时减速并停在约 1.5 m 的导航路径距离内,不应穿墙或一直挤进玩家模型。
- 在 Play 模式沿可行走地面拖动
PlayerRoot:目标移动超过 0.5 m 后,敌人应重新追击;如果目标只移动 0.2 m,可能保持原路径直到累计位移越过阈值。 - 通过运行时调试器或临时调试代码读取
agent.pathPending、agent.pathStatus、agent.remainingDistance:路径计算完成后应为PathComplete;只在!pathPending且剩余距离为有限值时判断是否抵达。remainingDistance是沿当前路径的剩余距离,并非玩家与敌人的直线距离。
| 异常 | 优先检查与修正 |
|---|---|
| 敌人原地不动 | 检查 Console 中的 Target / NavMesh 错误;确认 isOnNavMesh,重新 Bake,并核对 Agent Type |
| 请求了目标但走不到 | 检查 pathStatus 是否为 PathPartial 或 PathInvalid;确认目标在可达网格上、墙边留有足够通路 |
| 到终点反复转圈 | 检查 Stopping Distance 是否过小、Auto Braking 是否开启,以及目标是否每次更新都大幅移动 |
| 模型与代理位置分离 | 检查根节点是否被其他移动脚本或 Root Motion 改写;检查 updatePosition、updateRotation 是否仍为 true |
当玩家移出可达区域时,不要因为 SetDestination 返回 true 就判定追击成功;应等待路径计算结束,再根据 pathStatus 决定是继续接近可达边界、停止追击,还是进入另一个行为状态。