Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

连接导航网格

如果不同的 NavigationMesh 至少有一条边的两个顶点位于完全重合的位置，那么 NavigationServer 就会自动将这两个网格合并。

要连接任意距离的两个位置，见使用 NavigationLink。

../../_images/navigation_vertex_merge.png

对于多个NavigationPolygon资源也是如此。只要它们的轮廓点完全重叠，导览服务器就会合并它们。NavigationPolygon轮廓必须来自不同的NavigationPolygon资源才能连接。

同一NavigationPolygon上的重叠或相交轮廓将导致导览网格建立失败。来自不同导览多边形的重叠或相交轮廓通常无法在导览服务器上建立导览区域边缘连接，因此应避免。

../../_images/navigation_vertex_merge2.png

警告

精确意味着精确地进行顶点位置合并。汇入的网格经常发生的小 float 错误将阻止成功的顶点合并。

当导航网格的边几乎平行，且间距在一定范围内时，NavigationServer 可以不合并导航网格，仍将其视为相互连接。这一连接距离由每个导航地图的 edge_connection_margin 定义。在许多情况下，导航网格的边在部分重叠时无法正确连接。为了实现一致的合并行为，最好避免让导航网格之间发生重叠。

../../_images/navigation_edge_connection.png

如果启用了导览调试并且导览服务器处于活动状态，则已建立的导览网格联机将可视化。有关导览调试选项的更多信息，请参阅导航调试工具。

默认的 2D edge_connection_margin 可以在 ProjectSettings 的 navigation/2d/default_edge_connection_margin 中修改。

默认的 3D edge_connection_margin 可以在 ProjectSettings 的 navigation/3d/default_edge_connection_margin 中修改。

任何导览地图的边缘联机边距值也可以在执行时使用NavigationServer API进行变更。

extends Node2D

func _ready() -> void:
    # 2D margins are designed to work with 2D "pixel" values.
    var default_map_rid: RID = get_world_2d().get_navigation_map()
    NavigationServer2D.map_set_edge_connection_margin(default_map_rid, 50.0)

using Godot;

public partial class MyNode2D : Node2D
{
    public override void _Ready()
    {
        // 2D margins are designed to work with 2D "pixel" values.
        Rid defaultMapRid = GetWorld2D().NavigationMap;
        NavigationServer2D.MapSetEdgeConnectionMargin(defaultMapRid, 50.0f);
    }
}

extends Node3D

func _ready() -> void:
    # 3D margins are designed to work with 3D world unit values.
    var default_map_rid: RID = get_world_3d().get_navigation_map()
    NavigationServer3D.map_set_edge_connection_margin(default_map_rid, 0.5)

using Godot;

public partial class MyNode3D : Node3D
{
    public override void _Ready()
    {
        // 3D margins are designed to work with 3D world unit values.
        Rid defaultMapRid = GetWorld3D().NavigationMap;
        NavigationServer3D.MapSetEdgeConnectionMargin(defaultMapRid, 0.5f);
    }
}

备注

更改边缘连接边距将触发导览服务器上所有导览网格连接的完整更新。