Godot自动寻路功能讲解-使用C#语言（2D游戏导航教程）

news2025/2/28 17:53:03

文章目录

创建导航
NavigationAgent2D节点
设置目标位置
其他文章

创建导航

首先，创建一个基本的场景，下面的文章讲解了如何创建一个基本的导航场景，点击如下链接前往该文章：
Godot2D角色导航-自动寻路教程

NavigationAgent2D节点

创建场景之后，我们就来讲一讲NavigationAgent2D这个节点。该节点用于2D的导航代理，它将寻路至某个位置，并且在寻路的过程中能够躲避障碍物，这个障碍物包括静态障碍物和动态障碍物。
躲避动态障碍物使用的是 RVO 防撞算法。
我们可以通过如下代码来获取节点，节点的路径要如实填写，也就是GetNode的参数。

private NavigationAgent2D navigationAgent;

navigationAgent = GetNode<NavigationAgent2D>("NavigationAgent2D");

设置目标位置

使用代理，那我们就需要告诉他一个目标位置，然后让它告诉我们移动到那个位置的路径，这个位置我们可以通过设置TargetPosition属性来告诉我们的NavigationAgent2D节点。当TargetPosition属性被设置为一个特定的2D坐标时，导航代理会自动计算并选择路径，以选择尽可能快地路径移动到这个目标位置。

一旦TargetPosition被设置，会向 NavigationServer 请求一条新的从当前代理位置到TargetPosition的导航路径。然后，我们可以通过这个路径，使该节点沿着路径移动，以达到指定的目标位置。

该属性接收一个Vector2类型的值，我们可以为其赋值，代码如下所示：

navigationAgent.TargetPosition=new Vector2(500.0f, 200.0f);

这样或许有些麻烦，因为我们需要打节点名，再打属性名，我们可以使用属性来对其进行一次封装，如下所示：

	public Vector2 MovementTarget
	{
		get { return navigationAgent.TargetPosition; }
		set { navigationAgent.TargetPosition = value; }
	}

需要注意的是，之前我们说过了，TargetPosition被设置后，会向 NavigationServer 请求一条新的从当前代理位置到TargetPosition的导航路径。而只有在第一帧物理模拟，NavigationServer才可以进行同步，而在第一帧物理模拟之前，导航服务器是无法正常同步的。

这意味着，我们如果直接在_Ready()方法中设置，是会导致错误的，因为_Ready方法会在物理模拟之前执行。此时导航服务器尚未初始化。导航服务器需要先完成初始化和同步，才能够有效地进行导航操作。

所以，我们使用异步等待的方法，来等待第一帧物理模拟，以便导航服务器可以同步。

我们通过使用 async 关键字来声明异步方法。异步方法可以在执行耗时操作时，使程序能够在此期间继续执行其他工作，而不会阻塞线程。这表示我们可以在异步方法内部编写一些长时间运行的操作或需要等待的异步操作。比如说，我们一直等待，直到第一帧物理模拟，然后再为TargetPosition赋值。具体代码如下所示：

	private async void ActorSetup()
	{
		// 等待第一帧物理模拟，以便导航服务器可以同步。
		await ToSignal(GetTree(), SceneTree.SignalName.PhysicsFrame);
		// 现在导航网格不再为空，可以设置移动目标。
		MovementTarget = _movementTargetPosition;
	}

在 ActorSetup() 方法中，我们使用了 await 关键字来等待第一帧物理模拟开始的型号。这意味着代码会暂停执行，直到接收到 PhysicsFrame 信号后才会继续执行下面的代码。

ToSignal 方法，该方法用于监听指定节点的信号。它返回一个 SignalAwaiter对象，配置完成时为指定的节点发出了指定的信号。
ToSignal 方法的参数有两个：

source：要监听信号的节点对象。
signal：要监听的信号的名称。

而GetTree方法，会返回包含此节点的 SceneTree。

然后我们调用该方法，代码如下所示：

Callable.From(ActorSetup).CallDeferred();

首先，通过使用 Callable.From() 方法，将方法 ActorSetup 转换为一个可调用对象。

接下来，使用 CallDeferred 方法对可调用对象进行延迟调用。延迟调用意味着该方法将在空闲帧期间调用，而不会立即执行。延迟调用的作用是将方法推迟到稍后的时间点执行，以便其他任务有机会执行。CallDeferred 方法可以接收参数，这些参数应与方法的参数列表相匹配。在调用时，传递的参数将作为对应方法的实际参数进行使用。
在这里插入图片描述