在运行时使用 NavData

即时

这是添加和移除 NavData 的最简单的方法。使用以下 NavData 类方法：

KyResult NavData::AddToDatabaseImmediate();
KyResult NavData::RemoveFromDatabaseImmediate();

通过此方法，将立即启动数据库的完全更新，并阻止调用线程，直到更新完成。在更新期间，新数据将完全缝合到现有 NavData 中或完全与其余 NavData 脱离。

在确保人物和查询可用的数据始终与最近一次添加或移除保持同步方面，此方法具有明显的优势。但是，由于此方法会致使在当前帧期间完成整个更新，因此在实际产品中使用大型数据集时可能会引起 CPU 峰值。此外，该方法还需要您注意多线程；如果您在另一个线程中执行查询，修改这些查询所依赖的数据可能会导致意外结果，甚至会出现崩溃。因此，即时方法主要适用于初始集成和生成原型阶段，并期望您最终会采用异步方法来添加和移除数据。

但是请注意，如果从游戏循环的上下文外部加载数据（如数据生成过程的后期处理阶段），则必须使用此方法。

异步

添加和移除 NavData 的安全方式是使用以下方法：

KyResult NavData::AddToDatabaseAsync();
KyResult NavData::RemoveFromDatabaseAsync();

使用此方法时，将注册添加或移除 NavData 的请求，并在更新世界期间在后续帧中处理这些请求。

• 在世界更新期间触发异步数据库更新后，在世界中的任何数据库内添加或移除 NavData 的更多请求只有在更新完成后才会进行处理。因此，当您请求异步添加或移除时，根据数据库的当前状态，可能会在下一帧开始异步处理，也可能延迟几帧。
  注意:这也意味着，为获得最佳性能，应尝试将每个世界的所有添加和移除请求分到一组中，并在同一帧中请求处理。
• 根据数据库中数据的当前状态以及所涉及计算的复杂性（包括会对必须考虑在内的 NavMesh 进行动态修改的 TagVolume 数量），可能会在单个帧内完成处理，也可能跨多个帧根据时间片进行处理。
• 唯一能保证的是，至少有一个帧完成后数据库才反映新的数据集。

数据库可应对所有涉及跟踪数据添加和移除过程的复杂性。但是，跟踪请求状态非常有用，有助于您了解人物和查询是否正在使用数据库中 NavData 集的最新更改。每个 NavData 对象都具有自己的状态值，该值可通过 NavData::m_databaseStatus（表示该 NavData 在其指定数据库内的当前状态）进行访问。

下图概述了如何设置这些状态值以响应添加和移除请求。状态值以红色显示，用户启动的操作以黑色显示，内部操作以蓝色显示：