Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


AddNavMeshData

Adds the specified NavMeshData to the game.
Read time 1 minuteLast updated 12 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine.AI
  • Assembly: UnityEngine.AIModule

AddNavMeshData(NavMeshData)

Adds the specified NavMeshData to the game.
public static NavMeshDataInstance AddNavMeshData(NavMeshData navMeshData)

Parameters

navMeshData

Contains the data for the navmesh.

Returns

Type

Description

NavMeshDataInstanceRepresenting the added navmesh.

Remarks

This makes the NavMesh data available for agents and NavMesh queries. Returns an instance for later removing the NavMesh data from the runtime.
The instance returned will be valid unless the NavMesh data could not be added - e.g. due to running out of memory or navmesh data being loaded from a corrupted file.

AddNavMeshData(NavMeshData, Vector3, Quaternion)

Adds the specified NavMeshData to the game.
public static NavMeshDataInstance AddNavMeshData(NavMeshData navMeshData, Vector3 position, Quaternion rotation)

Parameters

navMeshData

Contains the data for the navmesh.

position

Translate the navmesh to this position.

rotation

Rotate the navmesh to this orientation.

Returns

Type

Description

NavMeshDataInstanceRepresenting the added navmesh.

Remarks

This function is similar to NavMesh.AddNavMeshData above, but the position and rotation specified is applied in addition to the position and rotation where the NavMesh data was baked.

Examples

using UnityEngine;using UnityEngine.AI;class Example : MonoBehaviour{ public NavMeshData data; NavMeshDataInstance[] instances = new NavMeshDataInstance[2]; public void OnEnable() { // Add an instance of navmesh data instances[0] = NavMesh.AddNavMeshData(data); // Add another instance of the same navmesh data - displaced and rotated instances[1] = NavMesh.AddNavMeshData(data, new Vector3(0, 5, 0), Quaternion.AngleAxis(90, Vector3.up)); } public void OnDisable() { instances[0].Remove(); instances[1].Remove(); }}