游戏 AI / 系统课时

运行时地图变了怎么查

运行时地图变了怎么查

运行时加载新区域、移动障碍或替换导航数据后,常见现象是“编辑器里能走,运行一会儿突然算不到路”。这类问题通常不是单纯的寻路算法失败,而是地图变化、NavMesh 更新和代理初始化不同步。本节按时间顺序建立排查链路,把异常定位到具体阶段。

学习目标

  • 能区分几何变化、障碍变化、导航数据变化和代理初始化四类问题
  • 能用运行时状态确认 Agent、目标与路径是否处于有效 NavMesh 上
  • 能按正确时序验证地图更新后何时才能重新提交路径

先按时间线定位变化发生在哪

运行时地图变化要先问四个问题:场景或区域什么时候完成加载,导航数据什么时候可用,角色什么时候真正落到 NavMesh 上,目标什么时候第一次提交。只看最终一次 SetDestination,很难判断前面的哪个阶段尚未准备好。

动态障碍也要单独看。如果使用 NavMeshObstacle 的 carving,障碍变化与可行走区域更新并不是“修改 Transform 后所有查询立即同步”的同一个动作;如果项目自行重建或替换导航数据,则更要避免在旧数据移除而新数据尚未可用时立即请求路径。

运行时地图变化与寻路初始化时序

用探针持续记录代理与目标状态

下面脚本不会修改导航数据,只负责每隔一段时间记录代理是否位于 NavMesh、目标是否能采样到 NavMesh,以及从代理位置到采样目标能否得到路径。把它挂到出现异常的角色上,就能比较地图变化前后的状态。

csharp
using UnityEngine;
using UnityEngine.AI;

public class RuntimeNavProbe : MonoBehaviour
{
    [SerializeField] private NavMeshAgent agent;
    [SerializeField] private Transform target;
    [SerializeField] private float sampleRadius = 1.5f;
    [SerializeField] private float logInterval = 1f;

    private float nextLogTime;
    private readonly NavMeshPath path = new NavMeshPath();

    private void Reset()
    {
        agent = GetComponent<NavMeshAgent>();
    }

    private void Update()
    {
        if (Time.time < nextLogTime || agent == null || target == null)
        {
            return;
        }

        nextLogTime = Time.time + logInterval;

        // 目标采样失败时,先不要把问题归咎于 Agent 的移动参数。
        bool targetSampled = NavMesh.SamplePosition(
            target.position,
            out NavMeshHit targetHit,
            sampleRadius,
            NavMesh.AllAreas);

        NavMeshPathStatus status = NavMeshPathStatus.PathInvalid;

        if (agent.isOnNavMesh && targetSampled)
        {
            NavMesh.CalculatePath(
                agent.transform.position,
                targetHit.position,
                NavMesh.AllAreas,
                path);

            status = path.status;
        }

        Debug.Log(
            $"time={Time.time:F1}, " +
            $"isOnNavMesh={agent.isOnNavMesh}, " +
            $"targetSampled={targetSampled}, " +
            $"pathStatus={status}");
    }
}

预期结果:地图稳定时,日志应持续显示代理位于 NavMesh、目标能够采样,并得到完整或可解释的路径状态。地图切换期间如果异常,可以直接观察是哪一个字段首先变化。

text
time=<TIME>, isOnNavMesh=True, targetSampled=True, pathStatus=PathComplete
time=<TIME>, isOnNavMesh=False, targetSampled=True, pathStatus=PathInvalid

<TIME> 是实际运行时刻。第二行表示首先失效的是代理与 NavMesh 的绑定关系,因此此时继续调整目标坐标或移动速度没有意义。

四类变化分别怎么查

场景加载后角色立即创建,但对应 NavMesh 数据稍后才可用时,agent.isOnNavMesh 可能为 false。此时不要继续调用依赖有效代理位置的移动逻辑,应先确认导航数据已经可用,再把角色放到有效网格并重新提交目标。

只有几何体发生变化,却没有同步改变导航数据时,导航查询仍可能基于旧的可行走区域。典型现象是规划路线穿过后来出现的墙体,随后角色被物理碰撞挡住。排查时要明确项目采用的是静态烘焙、NavMeshObstacle carving,还是运行时重建,三者处理地图变化的方式不同。

障碍位置频繁变化时,还要判断它是否真的需要 carving。普通移动角色或短暂经过的障碍通常更适合由局部避障处理;让大量持续移动的物体不断改变 NavMesh,反而可能造成频繁的路径失效与重新计算。

导航数据被替换之后,旧路径也不应继续被当成可信结果。地图版本发生变化时,应重新确认代理位置、目标落点和路径状态,而不是让角色继续沿一条基于旧地图计算出的路线移动。

地图更新后按固定顺序恢复

恢复时可以固定为四步:确认新导航数据已经生效,确认角色当前位置位于 NavMesh,确认目标附近存在可行走点,最后才重新计算或提交路径。只要前一步失败,就先停在这一层解决,不要继续向后调用。

如果地图替换后角色落在 NavMesh 外,可以先用 NavMesh.SamplePosition 在合理距离内寻找有效位置,再根据项目逻辑决定是否使用 NavMeshAgent.Warp 将代理重新放回网格。采样半径应与角色和关卡尺度匹配,不能通过无限扩大半径来掩盖地图断层。

按照“地图是否更新 → 代理是否仍在 NavMesh → 目标是否可落点 → 新路径是否完整”的顺序检查,可以避免在错误层反复调整速度、半径或停止状态,也更容易发现真正导致运行时寻路异常的初始化与更新时序。

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

目录与阅读设置

记录一个想法

运行时地图变了怎么查

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

登录哪都通