使用 NavigationLayer

NavigationLayers are an optional feature to further control which navigation meshes are considered in a path query. They work similar to how physics layers control collision between collision objects or how visual layers control what is rendered to the Viewport.

NavigationLayers可以在 ProjectSettings 中与物理层或视觉层相同地命名。

../../_images/navigationlayers_naming.png

如果一个区域没有一个与路径查询的 navigation_layers 参数兼容的导览层，则在寻路时将跳过该区域的导览网格。有关查询导览服务器路径的更多信息，请参阅 使用 NavigationPath 。

NavigationLayers是用作 bitmask 的单个 int 值。许多与导航相关的节点都具有 set_navigation_layer_value() 和 get_navigation_layer_value() 函数，可以直接设置和获取层数，而不需要更复杂的逐位操作。

在脚本中，以下辅助函数可用于处理 navigation_layers 位掩码。

2D GDScript3D GDScript

  1. func change_layers():
  2.     var region: NavigationRegion2D = get_node("NavigationRegion2D")
  3.     # enables 4-th layer for this region
  4.     region.navigation_layers = enable_bitmask_inx(region.navigation_layers, 4)
  5.     # disables 1-rst layer for this region
  6.     region.navigation_layers = disable_bitmask_inx(region.navigation_layers, 1)
  8.     var agent: NavigationAgent2D = get_node("NavigationAgent2D")
  9.     # make future path queries of this agent ignore regions with 4-th layer
  10.     agent.navigation_layers = disable_bitmask_inx(agent.navigation_layers, 4)
  12.     var path_query_navigation_layers: int = 0
  13.     path_query_navigation_layers = enable_bitmask_inx(path_query_navigation_layers, 2)
  14.     # get a path that only considers 2-nd layer regions
  15.     var path: PoolVector2Array = NavigationServer2D.map_get_path(
  16.         map,
  17.         start_position,
  18.         target_position,
  19.         true,
  20.         path_query_navigation_layers
  21.         )
  23. static func is_bitmask_inx_enabled(_bitmask: int, _index: int) -> bool:
  24.     return _bitmask & (1 << _index) != 0
  26. static func enable_bitmask_inx(_bitmask: int, _index: int) -> int:
  27.     return _bitmask | (1 << _index)
  29. static func disable_bitmask_inx(_bitmask: int, _index: int) -> int:
  30.     return _bitmask & ~(1 << _index)
  1. func change_layers():
  2.     var region: NavigationRegion3D = get_node("NavigationRegion3D")
  3.     # enables 4-th layer for this region
  4.     region.navigation_layers = enable_bitmask_inx(region.navigation_layers, 4)
  5.     # disables 1-rst layer for this region
  6.     region.navigation_layers = disable_bitmask_inx(region.navigation_layers, 1)
  8.     var agent: NavigationAgent3D = get_node("NavigationAgent3D")
  9.     # make future path queries of this agent ignore regions with 4-th layer
  10.     agent.navigation_layers = disable_bitmask_inx(agent.navigation_layers, 4)
  12.     var path_query_navigation_layers: int = 0
  13.     path_query_navigation_layers = enable_bitmask_inx(path_query_navigation_layers, 2)
  14.     # get a path that only considers 2-nd layer regions
  15.     var path: PoolVector3Array = NavigationServer3D.map_get_path(
  16.         map,
  17.         start_position,
  18.         target_position,
  19.         true,
  20.         path_query_navigation_layers
  21.         )
  23. static func is_bitmask_inx_enabled(_bitmask: int, _index: int) -> bool:
  24.     return _bitmask & (1 << _index) != 0
  26. static func enable_bitmask_inx(_bitmask: int, _index: int) -> int:
  27.     return _bitmask | (1 << _index)
  29. static func disable_bitmask_inx(_bitmask: int, _index: int) -> int:
  30.     return _bitmask & ~(1 << _index)

更改路径查询的导览层是 enabling / disabling (启用/停用)整个导览区域的一种性能友善的替代方案。与区域变更相比，具有不同导览层的导览路径查询不会触发导览服务器上的大规模更新。

Changing the navigation layers of NavigationAgent nodes will have an immediate effect on the next path query. Changing the navigation layers of regions will have an effect after the next NavigationServer sync.