Version: 2017.3

NavMesh.SamplePosition

Cambiar al Manual
public static bool SamplePosition (Vector3 sourcePosition, out AI.NavMeshHit hit, float maxDistance, int areaMask);

Parámetros

sourcePosition El origen de la consulta muestra.
hit Contiene las propiedades de la ubicación resultante.
maxDistance Muestra dentro de esta distancia desde sourcePosition.
areaMask Una máscara que especifica qué áreas del NavMesh se permiten al encontrar el punto más cercano.

Valor de retorno

bool Verdadero si se encuentra un punto más cercano.

Descripción

Encuentra el punto más cercano en el NavMesh dentro del rango especificado.

La función muestrea el NavMesh para encontrar el punto más cercano en el NavMesh.

El punto más cercano se devuelve en función de la distancia al punto de consulta. La función no comprueba si hay obstrucción en el mundo. Por ejemplo, el sourcePosition está en el techo, un punto en el segundo piso será devuelto (si hay NavMesh allí), en lugar de una posición del suelo en el primer piso.

La función puede ser bastante costosa si el radio de búsqueda es realmente grande. Un buen punto de partida para maxDistance es 2 veces la altura del agente.

Si está intentando encontrar un punto aleatorio en el NavMesh, es mejor usar el radio recomendado y probarlo varias veces en lugar de usar un radio muy grande.

// RandomPointOnNavMesh
using UnityEngine;
using UnityEngine.AI;

public class RandomPointOnNavMesh : MonoBehaviour { public float range = 10.0f;

bool RandomPoint(Vector3 center, float range, out Vector3 result) { for (int i = 0; i < 30; i++) { Vector3 randomPoint = center + Random.insideUnitSphere * range; NavMeshHit hit; if (NavMesh.SamplePosition(randomPoint, out hit, 1.0f, NavMesh.AllAreas)) { result = hit.position; return true; } } result = Vector3.zero; return false; }

void Update() { Vector3 point; if (RandomPoint(transform.position, range, out point)) { Debug.DrawRay(point, Vector3.up, Color.blue, 1.0f); } } }

public static bool SamplePosition (Vector3 sourcePosition, out AI.NavMeshHit hit, float maxDistance, AI.NavMeshQueryFilter filter);

Parámetros

sourcePosition El origen de la consulta muestra.
hit Contiene las propiedades de la ubicación resultante.
maxDistance Muestra dentro de esta distancia desde sourcePosition.
filter A filter specifying which NavMesh areas are allowed when finding the nearest point.

Valor de retorno

bool Verdadero si se encuentra un punto más cercano.

Descripción

Samples the position closest to sourcePosition - on any NavMesh built for the agent type specified by the filter.

Consider only positions on areas defined in the NavMeshQueryFilter.areaMask. A maximum search radius is set by maxDistance. The information of any found position is returned in the hit argument.