| areaMask | 一个位字段掩码，用于指定沿路径追踪时可以穿越哪些导航网格区域。 |
| maxDistance | 在此距离处终止扫描路径。 |
| hit | 包含结果位置的属性。 |
如果在到达 maxDistance 位置之前终止，则为 true，否则为 false。
根据当前路径采样一个位置。
此函数沿着当前路径向前查看指定的距离。然后通过 NavigationMesh 命中 对象返回该位置的网格详细信息。例如，这可用于在角色到达之前检查前方的表面类型 - 一个角色可以在准备蹚水时将枪举到头部上方。
using UnityEngine; using UnityEngine.AI; using System.Collections;
public class ExampleClass : MonoBehaviour { public Transform target; private NavMeshAgent agent; private int waterMask;
void Start() { agent = GetComponent<NavMeshAgent>(); waterMask = 1 << NavMesh.GetAreaFromName("Water"); agent.SetDestination(target.position); }
void Update() { NavMeshHit hit;
// Check all areas one length unit ahead. if (!agent.SamplePathPosition(NavMesh.AllAreas, 1.0F, out hit)) if ((hit.mask & waterMask) != 0) { // Water detected along the path... } } }