游戏引擎 / 系统课时

使用 NavMeshAgent 跟随目标

使用 NavMeshAgent 跟随目标

给场景中的敌人添加 NavMeshAgent,让它沿导航网格绕过墙体追逐移动的玩家,而不是直接朝玩家位置穿墙移动。完成后,敌人能按设定的速度和转向速率行走,在目标附近减速停止,且模型位置不会与导航模拟位置互相争夺控制权。

学习目标

  • 为 Unity 6 场景烘焙可供敌人行走的 NavMesh。
  • 配置移动参数,并以有限频率更新移动目标的位置。
  • 验证路径可达性、停止距离及 NavMeshAgent 与 Transform 的同步关系。

烘焙可行走区域

本例适用于 Unity 6 和 AI Navigation 2.x。NavMeshAgent 负责寻路与移动,NavMeshSurface 负责根据关卡几何体生成可行走区域;没有烘焙数据,脚本提交目的地也无法完成追击。

  1. 打开 Window > Package Manager,在 Unity Registry 中安装 AI Navigation。Unity 6.0 对应的已发布包包括 2.0.9;其他 Unity 6 小版本以 Package Manager 显示的兼容版本为准。
  2. 创建 Ground(GameObject > 3D Object > Plane),位置 (0,0,0)、缩放 (2,1,2),形成 20 m × 20 m 地面。再创建 Wall(Cube),位置 (0,1,0)、缩放 (1,2,5),作为不能穿过的墙。
  3. 新建 Environment Layer,并将 Ground、Wall 放入该层。创建空对象 NavigationWorld,在 Inspector 中通过 Add Component 添加 NavMesh Surface。
  4. 在 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 中每帧重复寻路。

csharp
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. 保持玩家不动:敌人应绕墙前进,接近玩家时减速并停在约 1.5 m 的导航路径距离内,不应穿墙或一直挤进玩家模型。
  2. 在 Play 模式沿可行走地面拖动 PlayerRoot:目标移动超过 0.5 m 后,敌人应重新追击;如果目标只移动 0.2 m,可能保持原路径直到累计位移越过阈值。
  3. 通过运行时调试器或临时调试代码读取 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 决定是继续接近可达边界、停止追击,还是进入另一个行为状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 NavMeshAgent 跟随目标

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通