| 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. |
bool Verdadero si se encuentra un punto más cercano.
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); } } }
| 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. |
bool Verdadero si se encuentra un punto más cercano.
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.