NavigationLink¶

实验性： This class may be changed or removed in future versions.

NavigationRegion上代理可以通过的两个位置之间的链接。

描述¶

代理可以通过的NavigationRegion上两个位置之间的链接。这些位置可以在同一个NavigationRegion上，也可以在两个不同的位置上。链接有助于表达导航方法，而不是沿着导航网格的表面移动，例如拉链、传送器或可以跳过的间隙。

属性¶

bool	bidirectional	`true`
bool	enabled	`true`
Vector3	end_position	`Vector3(0, 0, 0)`
float	enter_cost	`0.0`
int	navigation_layers	`1`
Vector3	start_position	`Vector3(0, 0, 0)`
float	travel_cost	`1.0`

方法¶

Vector3	get_global_end_position() const
Vector3	get_global_start_position() const
bool	get_navigation_layer_value(layer_number: int) const
RID	get_navigation_map() const
RID	get_rid() const
void	set_global_end_position(position: Vector3)
void	set_global_start_position(position: Vector3)
void	set_navigation_layer_value(layer_number: int, value: bool)
void	set_navigation_map(navigation_map: RID)

属性说明¶

bool bidirectional = true 🔗

void set_bidirectional(value: bool)
bool is_bidirectional()

这个环节是双向通行还是只能从start_position到end_position。

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

此链接当前是否处于活动状态。如果false，NavigationServer3D.map_get_path()将忽略此链接。

Vector3 end_position = Vector3(0, 0, 0) 🔗

void set_end_position(value: Vector3)
Vector3 get_end_position()

链接的结束位置。

此位置将搜索出导航网格中要附加的最近的多边形。

链接将搜索的距离由NavigationServer3D.map_set_link_connection_radius()控制。

float enter_cost = 0.0 🔗

void set_enter_cost(value: float)
float get_enter_cost()

当寻路从另一个区域导航网格进入此链接时，enter_cost值被添加到路径距离中，用于确定最短路径。

int navigation_layers = 1 🔗

void set_navigation_layers(value: int)
int get_navigation_layers()

确定链接所属的所有导航层的位域。当使用NavigationServer3D.map_get_path()请求路径时，将检查这些导航层。

Vector3 start_position = Vector3(0, 0, 0) 🔗

void set_start_position(value: Vector3)
Vector3 get_start_position()

链接的起始位置。

此位置将搜索出导航网格中要附加的最近的多边形。

链接将搜索的距离由NavigationServer3D.map_set_link_connection_radius()控制。

float travel_cost = 1.0 🔗

void set_travel_cost(value: float)
float get_travel_cost()

当寻路沿链路移动时，行进距离乘以travel_cost，以确定最短路径。

方法说明¶

Vector3 get_global_end_position() const 🔗

将相对于链接的end_position作为全局位置返回。

Vector3 get_global_start_position() const 🔗

将相对于链接的start_position作为全局位置返回。

返回是否启用navigation_layers位掩码的指定层，给定介于1和32之间的layer_number。

返回此链接使用的当前导航地图RID。

RID get_rid() const 🔗

返回NavigationServer3D上此链接的RID。

void set_global_end_position(position: Vector3) 🔗

设置从全局position相对于链接的end_position。

void set_global_start_position(position: Vector3) 🔗

设置从全局position相对于链接的start_position。

基于value，启用或禁用navigation_layers位掩码中的指定层，给定介于1和32之间的layer_number。

设置此链接应使用的导航地图的RID。默认情况下，该链接将自动加入World3D默认导航地图，因此仅需要此功能来覆盖默认地图。