Importing A Unity Navmesh

Quantum 導航網格生成是基於 Unity 導航網格管線構建的。Unity 導航網格三角剖分會被匯入並烘焙為 Quantum 導航網格二進位格式。

烘焙過程會將世界座標寫入 Quantum 導航網格，因為僅支援位於原點的導航網格。與 Quantum 物理系統類似，建議遊戲玩法在原點附近進行，以避免定點精度問題。

匯入 Unity 導航網格

• 透過Unity Package Manager > Unity Registry將 AI 導航套件com.unity.ai.navigation新增至 Unity 專案。

• 建立並設定 Unity 導航網格表面 (Navmesh Surface)。

• 在地圖QuantumMapData下建立新的 GameObject，並新增QuantumMapNavMeshUnity指令碼。

• 將表面 GameObject 新增至Nav Mesh Surfaces清單。

• 選取地圖物件，在Bake All Mode選項中啟用Everything，然後按一下 Bake All。控制台將記錄導航網格匯入訊息。

  Imported Unity NavMesh 'Navmesh', cleaned up 7 vertices, found 1 region(s), found 0 link(s)
  

• Quantum 導航網格資產會烘焙為兩個資產檔案：導航網格資產和第二個二進位資料資產（後綴為_data），它們會放置在地圖資產旁邊。

• 烘焙後，導航網格資產會在QuantumMapData指令碼的Nav Mesh Links中被參考。

• 選取地圖物件以顯示 Quantum 導航網格 gizmo。開啟 Quantum Gizmo 疊加功能表以切換不同類型的 gizmo 繪製（在場景標籤上按右鍵 > 疊加功能表 > Quantum Gizmos）。

• （可選）在QuantumEditorSettings中切換不同自動建置模式觸發器的導航網格建置。

• 將Quantum.Core.NavigationSystem新增至遊戲啟動時在RuntimeConfig上設定的SystemsConfig中。預設配置已正確新增並啟用該系統。

匯入設定

從 Unity 導航網格轉換為 Quantum 導航網格時，會使用可透過QuantumMapNavMeshUnity指令碼自訂的匯入設定。

地圖上的導航網格設定

QuantumMapData指令碼有兩個相關的導航網格設定：序列化類型以及導航網格網格和世界大小。這兩個設定都會在烘焙期間套用並複製到導航網格資產。

導航網格序列化類型

此設定控制導航網格資產中序列化多少資產內容，以及在載入時生成多少內容。它可用於減小資產大小，這在執行時建立資產並傳送給用戶端時可能很有用（請參閱自訂導航網格生成）。

導航網格區域與格線

當在 Quantum 導航網格疊加功能表中開啟時，場景中會渲染NavMesh Area和NavMesh Grid的Gizmos。

可透過在NavMesh Settings標題下選取QuantumMapData指令碼來配置網格。X 和 Y/Z 方向的網格單元格數量以及網格節點大小（每個單元格的 Unity 單位維度）決定了整體網格大小。

導航網格網格區域需要包含整個導航網格（左側螢幕截圖中的藍色方塊）。

網格單元格（右側螢幕截圖中的黃色正方形）需要合理的大小，以避免包含太多單獨的導航網格三角形。這是在導航網格資料大小和性能之間的權衡。單元格越小，資料結構越大，但尋路期間需要處理的三角形越少。

即使導航網格世界位置不在原點附近，它仍然必須位於網格區域內。

自訂導航網格烘焙回調

可透過繼承MapDataBakerCallback類別的回調來擴充導航網格烘焙過程。

將以下指令碼新增至QuantumUser/Editor中。

QuantumMapBakeAssembly屬性是烘焙過程找到回呼所必需的。

C#

[assembly: Quantum.QuantumMapBakeAssembly]

namespace Quantum.Editor
{
  using System.Collections.Generic;
  using UnityEngine;

  public class NavmeshBakeCallback : MapDataBakerCallback
  {
    public override void OnBeforeBakeNavMesh(QuantumMapData data)
    {
      // Before any navmesh baking takes place.
    }

    public override void OnCollectNavMeshBakeData(QuantumMapData data, List<NavMeshBakeData> navMeshBakeData)
    {
      // Unity navmesh surfaces have been imported and bake data is already filled out.
      Debug.Log($"Found {navMeshBakeData.Count} navmesh bake data");
    }


    public override void OnCollectNavMeshes(QuantumMapData data, List<NavMesh> navmeshes)
    {
      // Quantum navmesh have been baked.
    }

    public override void OnBakeNavMesh(QuantumMapData data) {
      // Quantum navmeshes have been saved to assets.
    }

    // abstract methods have to be implemented but not needed here
    public override void OnBake(QuantumMapData data) { }
    public override void OnBeforeBake(QuantumMapData data) { }
  }
}