在连接的导航扇区内创建路线

The created navigation sectors only provide the area within which routes are calculated. The routes themselves should be created from the code. So, let's create the corresponding C# component for 2D route calculation:创建的导航扇区仅提供计算路线的区域。 路由本身应该从代码中创建。 因此，让我们2D路由计算创建相应的C＃组件:

注意

If you have completed the previous guide on creating routes within a simple navigation sector, you can skip this step and copy the implemented Route2D.cs component to the data/components folder of your project.如果您已经完成了上一篇关于在简单导航扇区中创建路由的指南，则可以跳过此步骤并将实现的Route2D.cs组件复制到项目的data/components文件夹中。

1. Create the components folder in the data directory of your project: right-click in the Asset Browser and select Create Folder.在项目的data目录中创建components文件夹：在资源浏览器中右键单击并选择Create Folder。

2. In the created folder, create a new component: right-click and select Create Code -> C# Component and specify a name for the component.在创建的文件夹中，创建一个新组件：右键单击并选择Create Code -> C# Component并为组件指定一个名称。

   

3. Open the component in IDE to implement pathfinding logic.在IDE中打开组件实现寻路逻辑。

注意

If you have copied the Route2D.cs component on the previous step, you can skip this one.如果您在上一步复制了Route2D.cs组件，则可以跳过此步骤。

1. Declare component parameters:声明组件参数:

   • Two parameters that will accept nodes between which a route should be calculated两个参数将接受应该计算路由的节点
   • Route color路线颜色
   源代码 (C#)

   public class Route2D : Component
   {
   
   	// a node that will serve as a start point
   	public Node startPoint = null;
   	// a node that will serve as a destination point
   	public Node finishPoint = null;
   
   	// route color 
   	[ParameterColor]
   	public vec4 routeColor = vec4.ZERO;
   
   	// ...
   
   }

2. Create a route and set the radius and height that required to move the point along the route in the Init() method. Before creation, check if the nodes to be used as the start and finish points are specified.创建一条路线，并设置在Init()方法中沿着路线移动点所需的半径和高度。 在创建之前，检查是否指定了要用作起点和终点的节点。

   注意

   Choosing the radius and height values is essential. If the height or radius exceeds the size of the sector or the intersection area, such sector/area will be excluded from pathfinding. To address this, you can modify the route parameters or adjust the size of the sector or intersection area.选择半径和高度值至关重要。 如果高度或半径超过扇区或交叉区域的大小，则此类扇区/区域将被排除在寻路之外。 为了解决这个问题，您可以修改路线参数或调整扇区或交叉区域的大小。
   源代码 (C#)

   // a route
   private PathRoute route = null;
   
   private void Init()
   {
   	// check if the start and destination nodes are correctly specified via the component interface
   	if (startPoint && finishPoint)
   	{
   		// create a new route
   		route = new PathRoute();
   
   		// set a radius and height for the point which will move along the route
   		route.Radius = 0.1f;
   		route.Height = 0.1f;
   
   	}
   }

3. To enable displaying the calculated route at run time, turn on the Visualizer. Additionally, you can output console messages to the application screen. Add the following logic to the Init() function:要启用在运行时显示计算的路由，请打开Visualizer。 此外，您还可以将控制台消息输出到应用程序屏幕。 将以下逻辑添加到Init()函数中:

   源代码 (C#)

   // enable the onscreen console messages to display info on route calculation
   Unigine.Console.Onscreen = true;
   // enable visualization of the calculated route
   Visualizer.Enabled = true;

4. In the Update() function, calculate the route from the start to destination node:在Update()函数中，计算从起点到目的节点的路由:

   源代码 (C#)

   private void Update()
   {
   	// check if the start and destination nodes are correctly specified via the component interface
   	if (startPoint && finishPoint)
   	{
   		// calculate the path from the start to destination point
   		// a destination point of the route is reached
   		route.Create2D(startPoint.WorldPosition, finishPoint.WorldPosition);
   		if (route.IsReached)
   		{
   			// if the destination point is reached, render the root in a specified color
   			route.RenderVisualizer(routeColor);
   		}
   		else
   			Log.Message($"{node.Name} PathRoute not reached yet\n");
   	}
   }

   注意

   Here the route is recalculated each frame. However, it is not optimal for application performance. Instead, you can calculate the route once per several frames: pass a delay to the create2D() function as the third argument.这里每帧重新计算路由。然而，这并不是应用程序性能的最佳选择。相反，您可以每几帧计算一次路由:将延迟传递给Create2D()函数作为第三个参数。

5. Implement the Shutdown() function to disable the visualizer and onscreen console messages:实现Shutdown()函数以禁用可视化工具和屏幕控制台消息:

   源代码 (C#)

   private void Shutdown()
   {
   	Unigine.Console.Onscreen = false;
   	Visualizer.Enabled = false;
   }

Here is the full code of the component:下面是组件的完整代码:

using System.Collections;
using System.Collections.Generic;
using Unigine;

[Component(PropertyGuid = "AUTOGENERATED_GUID")] // <-- this line is generated automatically for a new component
public class Route2D : Component
{
	// a node that will serve as a start point
	public Node startPoint = null;
	// a node that will serve as a destination point
	public Node finishPoint = null;

	public bool visualizeRoute = false;
	// route color 
	[ParameterColor]
	public vec4 routeColor = vec4.ZERO;
	// a route
	private PathRoute route = null;

	private void Init()
	{
		// check if the start and destination nodes are correctly specified via the component interface
		if (startPoint && finishPoint)
		{
			// create a new route
			route = new PathRoute();

			// set a radius and height for the point which will move along the route
			route.Radius = 0.1f;
			route.Height = 0.1f;
			// enable the onscreen console messages to display info on route calculation
			Unigine.Console.Onscreen = true;
			// enable visualization of the calculated route
			Visualizer.Enabled = true;
		}
	}
	private void Update()
	{
		// check if the start and destination nodes are correctly specified via the component interface
		if (startPoint && finishPoint)
		{
			// calculate the path from the start to destination point
			// a destination point of the route is reached
			route.Create2D(startPoint.WorldPosition, finishPoint.WorldPosition);
			if (route.IsReached)
			{
				// if the destination point is reached, render the root in a specified color
				if (visualizeRoute)
					route.RenderVisualizer(routeColor);
			}
			else
				Log.Message($"{node.Name} PathRoute not reached yet\n");
		}
	}

	private void Shutdown()
	{
		Unigine.Console.Onscreen = false;
		Visualizer.Enabled = false;
	}
}

When the component logic is implemented, you should assign it to a node.实现组件逻辑时，应将其分配给节点。

1. In UnigineEditor, select Create -> Node -> Dummy and place it in the navigation area.在UnigineEditor中，选择Create -> Node -> Dummy并将其放置在导航区域中。
2. Select the dummy node and assign the Route2D.cs component to it in the Parameters window.选择虚拟节点并在Parameters窗口中将Route2D.cs组件分配给它。

3. In the component parameters, specify the start and finish static meshes in the Start Point and Finish Point fields.在组件参数中，在Start Point和Finish Point字段中指定start和finish静态网格体。

   

4. Change the Route Color, if necessary.如有必要，请更改Route Color。

1. In the components folder, create the AreaVisualizer component.在components文件夹中，创建AreaVisualizer组件。

   注意

   If you have completed the previous guide on creating routes within a simple navigation sector, you can skip this step and use the implemented AreaVisualizer component. Just copy it to the data/components folder of your project and assign it to all the navigation sectors forming the navigation area.如果您已经完成了上一篇关于在简单导航扇区中创建路由的指南，则可以跳过此步骤并使用实现的AreaVisualizer组件。 只需将其复制到项目的data/components文件夹中，并将其分配给构成导航区域的所有导航扇区。

2. Implement rotation logic:实现旋转逻辑:

   源代码 (C#)

   public class AreaVisualizer : Component
   {
   	private NavigationSector navigationSector = null;
   
   	private void Init()
   	{
   		// get the navigation sector to which the component is assigned
   		navigationSector = node as NavigationSector;
   		
   		// enable rendering of the visualizer
   		if (navigationSector)
   			Visualizer.Enabled = true;
   	}
   
   	private void Update()
   	{
   		// display the navigation area gizmo
   		if (navigationSector)
   			navigationSector.RenderVisualizer();
   	}
   
   	private void Shutdown()
   	{
   		// disable rendering of the visualizer
   		Visualizer.Enabled = false;
   	}
   }

3. Assign the component to each navigation sector forming the navigation area.将组件分配给形成导航区域的每个导航扇区。

Click Run to run the component logic and check the result.单击Run以运行组件逻辑并检查结果。

You can force the Route2D component to calculate a 3D route within the same navigation area by changing a single line of the code. Replace the route.Create2D() function call with the following:您可以通过更改代码的单行来强制Route2D组件计算同一导航区域内的3D路线。 将route.Create2D()函数调用替换为以下内容:

route.Create3D(startPoint.WorldPosition, finishPoint.WorldPosition);