Version: 2023.2
LanguageEnglish
  • C#

NavMeshBuilder.UpdateNavMeshData

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public static bool UpdateNavMeshData(AI.NavMeshData data, AI.NavMeshBuildSettings buildSettings, List<NavMeshBuildSource> sources, Bounds localBounds);

Parameters

data The NavMeshData to update.
buildSettings The build settings which is used to update the NavMeshData. The build settings is also hashed along with the data, so changing settings will cause a full rebuild.
sources List of input geometry used for baking, they describe the surfaces to walk on or obstacles to avoid.
localBounds Bounding box relative to position and rotation which describes the volume where the NavMesh should be built.

Returns

bool Returns true if the update was successful.

Description

Incrementally updates the NavMeshData based on the sources. (UnityEngine)

Each time NavMeshData is built or updated, the source data is hashed, and the hashes are stored along with the NavMeshData.

When called, first the hashes are recomputed and compared and only changed portions are rebuilt. For this reason, the list of sources should always contain all the input geometry, even if they haven't moved or changed. If the list of sources is modified between calls to UpdateNavMeshData the missing/added sources are considered changes. Try to provide the sources that have not changed since the last update in the same relative order as before because their sequence can affect the values of the hashes. This measure ensures that unchanged portions don't get rebuilt unnecessarily.

You must supply a Bounds struct for the localBounds parameter.

Additional resources: NavMeshBuilder.UpdateNavMeshDataAsync.