教程寻路系统
阅读本文大概需要 10 分钟。
使用寻路系统可以快速实现角色自动寻路功能，由此可以实现例如任务引导或是跟随的功能，接下来让我们一起了解一下如何使用寻路系统吧。
了解更多本节内容见产品文档：寻路系统 | 产品手册 (ark.online)
1. 什么是寻路系统
在现实生活中，我们想去到某个地点时经常会使用工具导航，沿着导航推荐的最优线路走。而在游戏中，角色需要在游戏世界中移动，寻路系统就是帮助角色计算出最佳路径的工具。它会考虑地图上的可行走区域和障碍物，然后找到一条避开障碍物、最短的路径来到目的地。这样，角色就可以根据寻路给出的指引，到达我们设定的目的地。
2. 如何设置寻路系统
在资源库【游戏功能对象】中，找到【寻路区域】，拖拽到主视口中，此时将绘制出一片绿色的寻路区域，在此区域中我们可以使用 API 实现 NPC 寻路的功能。绿色寻路区域的显示/隐藏可以在右上角菜单中的【显示】设置。
将寻路区域放到主视口后，我们可以通过修改其属性面板中的缩放和位置属性来调整寻路区域的覆盖范围，使绘制出来的绿色区域覆盖我们需要使用寻路功能的区域。
注意
建议每个场景中的寻路区域范围保持在2100 * 2100 * 100以内,防止因寻路区域过大会造成寻路区域失效的情况。
请勿修改寻路区域属性面板中的旋转属性,以免出现寻路计算异常情况。
寻路区域的高度如果过低可能会导致人物跳跃时跳出寻路区的情况
3. 使用寻路功能
使用navigateTo寻路到指定地点
调整好寻路区域后，就可以使用 navigateTo API，让寻路区域中的角色自动向目标位置移动，同时可以加入寻路成功的逻辑，新建寻路脚本，将脚本拖入场景并且设置为双端脚本，编写脚本如下：
typescript
@Component
export default class Navigator extends Script {
protected onStart(): void {
InputUtil.onKeyDown(Keys.One, () => {
//按下“1”，自身角色将寻路至（-900,1200,296）位置
Navigation.navigateTo(Player.localPlayer.character,new Vector(-900,1200,296),0,()=>{
//角色到达位置后将播放一段动画
Player.localPlayer.character.loadAnimation("122750").play();
})
})
InputUtil.onKeyDown(Keys.Two,()=>{
//按下“2”，自身角色将停止寻路
Navigation.stopNavigateTo(Player.localPlayer.character)
})
}
}@Component
export default class Navigator extends Script {
protected onStart(): void {
InputUtil.onKeyDown(Keys.One, () => {
//按下“1”，自身角色将寻路至（-900,1200,296）位置
Navigation.navigateTo(Player.localPlayer.character,new Vector(-900,1200,296),0,()=>{
//角色到达位置后将播放一段动画
Player.localPlayer.character.loadAnimation("122750").play();
})
})
InputUtil.onKeyDown(Keys.Two,()=>{
//按下“2”，自身角色将停止寻路
Navigation.stopNavigateTo(Player.localPlayer.character)
})
}
}运行游戏，进入场景后按下键盘的"1"，角色就会自动走到目标位置并且到达后开始跳舞啦。
TIPS
navigateTo 的成功回调函数会在到达目的地的时候执行
使用 follow 实现跟随逻辑
在寻路区域中，可以使用 follow 来实现角色之间的跟随功能，例如我们尝试制作一个宠物跟随功能：
- 在场景中放置一个角色对象，follow 跟随的目标和跟随者都需要是角色对象
- 将其改为你想要的宠物形象(在这里我将其改为了四足对象，用了熊猫的模型)
- 新建 Follow 脚本，代码如下：
typescript
@Component
export default class Follow extends Script {
private npc: Character
protected onStart(): void {
//此处填写NPC的gameObjectId
this.npc = GameObject.findGameObjectById("176792C4") as Character
if (SystemUtil.isClient()) {
InputUtil.onKeyDown(Keys.One, () => {
Event.dispatchToServer("Follow");
})
InputUtil.onKeyDown(Keys.Two, () => {
Event.dispatchToServer("StopFollow")
})
}
if (SystemUtil.isServer()) {
Event.addClientListener("Follow", (player) => {
Navigation.follow(this.npc, player.character, 0, () => {
//这里加入开始跟随的逻辑,播放宠物跑步的动画
let anim = this.npc.loadAnimation("181293");
anim.loop = 0;
anim.play()
})
})
Event.addClientListener("StopFollow", () => {
Navigation.stopFollow(this.npc)
let anim = this.npc.loadAnimation("170889");
anim.loop = 0;
anim.play()
})
}
}
}@Component
export default class Follow extends Script {
private npc: Character
protected onStart(): void {
//此处填写NPC的gameObjectId
this.npc = GameObject.findGameObjectById("176792C4") as Character
if (SystemUtil.isClient()) {
InputUtil.onKeyDown(Keys.One, () => {
Event.dispatchToServer("Follow");
})
InputUtil.onKeyDown(Keys.Two, () => {
Event.dispatchToServer("StopFollow")
})
}
if (SystemUtil.isServer()) {
Event.addClientListener("Follow", (player) => {
Navigation.follow(this.npc, player.character, 0, () => {
//这里加入开始跟随的逻辑,播放宠物跑步的动画
let anim = this.npc.loadAnimation("181293");
anim.loop = 0;
anim.play()
})
})
Event.addClientListener("StopFollow", () => {
Navigation.stopFollow(this.npc)
let anim = this.npc.loadAnimation("170889");
anim.loop = 0;
anim.play()
})
}
}
}- 将脚本拖入场景，运行游戏，按"1"宠物就能跟随我们，按"2"宠物将停在原地。一个简单的宠物跟随功能就做好啦！
TIPS
follow 的成功回调函数会在开始跟随时执行(即能够找到一条路线进行寻路跟随时执行)。