NavMeshQuery.Raycast

参数

返回

PathQueryStatus 如果可以使用提供的参数来正确跟踪射线，则返回 Success。\ 如果 start 位置在查询的 NavMeshWorld 中无效，如果该位置在 areaMask 参数不允许的区域内，或者该位置在 NavMeshLink/OffMeshLink 上时，返回 Failure。

描述

在导航网格上的两点之间找出一条线。

该方法类似于 NavMesh.Raycast，两者共享相同的底层实现。\ 使之不同的属性是：\ - 可以将它用于并行的作业；
- 它返回的状态标志可表明操作成功还是失败；
- 报告的 hit.distance 受到区域成本的影响；
- 没有根据高度网格（如果存在）而在纵轴上调整生成的 hit.position；
- 它具有下文描述的变体，该变体也返回射线所通过的多边形的列表。\ \ 返回的 hit.distance 代表起点与终点之间的直线。它还考虑提供的区域成本的列表。它是将射线在每个单独区域上经过的全部距离相加，然后乘以相应区域的成本所得的结果。\ \ 首先，起始位置经过验证，在 NavMeshWorld 中有效，并在 NavMesh 上映射目标点。然后，从起点到目标，对射线进行跟踪。如果计算成功，将用射线达到的最远点的相关信息来填写 hit 数据。无论从源到目标的路径是否遭到阻塞，都会发生此情况。\ 如果计算失败，返回的 hit 中会填充无效数据。最值得注意的是，hit.distance 字段获得值 positiveInfinity。

如果射线投射在外边缘上终止，则 hit.mask 为 0；否则它包含阻挡多边形部分的区域遮罩。

可以使用此函数来检查代理是否可以在 NavMesh 上的两点之间畅通无阻地行走。例如，如果您的角色存在需要空间的逃避躲闪动作，您可以从角色位置向多个方向发射射线。这样将找到角色可以躲闪到的地方。

NavMeshQuery.Raycast 不同于物理射线投射。NavMeshQuery.Raycast 可以检测各种导航障碍物（例如地上的洞）。它也可以爬上斜坡（如果该区域适合行动）。

// TargetReachable
using Unity.Collections;
using UnityEngine;
using UnityEngine.AI;
using UnityEngine.Experimental.AI;

public class TargetReachable : MonoBehaviour
{
    public Transform target;
    NavMeshQuery m_NavQuery;
    NavMeshHit m_Hit;

    void OnEnable()
    {
        m_NavQuery = new NavMeshQuery(NavMeshWorld.GetDefaultWorld(), Allocator.Persistent);
    }

    void Update()
    {
        var startLocation = m_NavQuery.MapLocation(transform.position, Vector3.one, 0);
        var status = m_NavQuery.Raycast(out m_Hit, startLocation, target.position, NavMesh.AllAreas, new NativeArray<float>());
        if ((status &amp; PathQueryStatus.Success) != 0)
        {
            Debug.DrawLine(transform.position, target.position, m_Hit.hit ? Color.red : Color.green);

            if (m_Hit.hit)
                Debug.DrawRay(m_Hit.position, Vector3.up, Color.red);
        }
    }

    void OnDisable()
    {
        m_NavQuery.Dispose();
    }
}

参数

返回

PathQueryStatus 如果可以使用提供的参数来正确跟踪射线，则返回 Success。\ 如果 start 位置在查询的 NavMeshWorld 中无效，如果该位置在 areaMask 参数不允许的区域内，或者该位置在 NavMeshLink/OffMeshLink 上时，返回 Failure。\ 如果提供的 path 缓冲区大小不足以容纳射线通过的所有多边形，则 BufferTooSmall 是返回的标志的一部分。

描述

跟踪 NavMesh 上两点之间的一条线，并返回所通过的多边形的列表。

即使 path 缓冲区过小，它仍然会尽可能容纳多边形（从射线的原点位置开始）。\ \ 另请参阅：PolygonId。

// StraightPathFromRay
using Unity.Collections;
using UnityEngine;
using UnityEngine.AI;
using UnityEngine.Experimental.AI;

public class StraightPathFromRay : MonoBehaviour
{
    public Transform target;
    NavMeshQuery m_NavQuery;
    NavMeshHit m_Hit;
    NativeArray<PolygonId> m_Path;
    int m_PathCount;

    void OnEnable()
    {
        m_Path = new NativeArray<PolygonId>(3, Allocator.Persistent);
        m_NavQuery = new NavMeshQuery(NavMeshWorld.GetDefaultWorld(), Allocator.Persistent);
    }

    void Update()
    {
        var startLocation = m_NavQuery.MapLocation(transform.position, Vector3.one, 0);
        PathQueryStatus status = m_NavQuery.Raycast(out m_Hit, m_Path, out m_PathCount, startLocation, target.position, NavMesh.AllAreas, new NativeArray<float>());
        if ((status &amp; PathQueryStatus.Success) != 0)
        {
            var bufferTooSmall = (status &amp; PathQueryStatus.BufferTooSmall) != 0;
            Debug.DrawLine(transform.position, m_Hit.position, bufferTooSmall ? Color.black : Color.green);

            if (m_Hit.hit)
                Debug.DrawRay(m_Hit.position, Vector3.up, Color.red);
        }
    }

    void OnDisable()
    {
        m_NavQuery.Dispose();
        m_Path.Dispose();
    }
}