Table of Contents

驗證元件

驗證元件用於在 PC 上模擬運行並驗證 Mega 效果。

未運行狀態介面總覽

如果驗證工具沒有在單獨視窗開啟,studio 工具面板會顯示

validation

如果驗證工具在單獨視窗開啟,studio 工具面板會顯示

validation

而驗證工具視窗會顯示

validation

運行狀態介面總覽

如果驗證工具沒有在單獨視窗開啟,studio 工具面板會顯示

validation

如果驗證工具在單獨視窗開啟,驗證工具視窗會根據視窗大小調整顯示

validation validation

工具區域說明

  1. 運行控制區
  2. EIF 播放區
  3. 定位控制區
  4. 顯示控制區
  5. 狀態資訊區

運行控制區

validation validation

  1. 使用/停用驗證工具
  2. 啟動/停止驗證工具
  3. 在單獨視窗開啟
  4. 關閉單獨視窗中的工具
  5. 在單獨工具視窗中選擇 studio 工具

EIF播放區

validation

  1. 播放/暫停
  2. 停止
  3. 向前 5s(新格式資料可用,錄製異常停止除外)
  4. 減速播放(新格式資料可用)
  5. 加速播放(新格式資料可用)
  6. 向後 5s(新格式資料可用,錄製異常停止除外)
  7. 開啟 EIF 檔案
  8. 目前時間/總時間
  9. 目前倍速
  10. 播放進度(新格式資料可拖動,錄製異常停止除外)

定位控制區

validation

  1. 定位狀態指示器
  2. 啟動/停止定位(預設啟動)
  3. 重設追蹤狀態
  4. 服務地址選擇(工具不在執行狀態時才能修改)

定位狀態指示器顏色說明

  • 綠色:定位到 Block 且裝置 VIO 追蹤成功顯示綠色,若無新的定位結果將在 5s 內漸變至透明;
  • 黃色:定位到 Block 但裝置 VIO 追蹤失敗顯示黃色,若無新的定位結果將在 5s 內漸變至透明;
  • 白色:定位不到 Block 顯示白色,若無新的定位結果將在5s內漸變至透明;
  • 紅色:定位出錯顯示紅色,在下次定位結果返回前保持顯示;

顯示控制區

validation

  1. 顯示/隱藏影片背景
  2. 顯示/隱藏標註資料
  3. 顯示/隱藏 Block 模型(URP 下將同時隱藏 Scene 視窗的模型)
  4. 顯示/隱藏按鈕名稱
  5. 控制 Block 模型透明度(URP 下無法使用)

Block 模型透明度變換效果如下

validation

狀態資訊區

validation

  1. 每幀更新的 session 狀態
  2. 伺服器返回的定位結果(和追蹤效果有關,但不是全部追蹤結果)
  3. 複製
  4. 複製
  5. 是否在 Game View 中顯示 dump 資訊

使用流程

準備 EIF 數據

驗證效果需要使用 EIF 數據,請使用 Mega Toolbox 的 遠程開發模擬定位用的EIF測試數據錄製工具 錄製 EIF 文件。根據所選錄製格式不同,錄製結果中會保存 .mkveif 文件(或 .eif 文件和 .eif.json 文件,這兩個文件缺一不可)。

準備 Package

確保 com.easyar.sense 已經導入。如果沒有導入會看到以下信息,

validation

這時候需要使用 Unity Package Manager 導入需要的 package 包: com.easyar.sense-**.tgz 。

填寫 EasyAR Sense License Key

在網頁上登錄 EasyAR 開發中心 ,獲取 EasyAR Sense License Key

validation

在Unity菜單中打開 EasyAR > Sense > Configuration

validation

然後在打開的 Project Settings 窗口中填寫從網站上覆製的 license key

validation

連接 Mega 定位服務 在添加工具之後,需要在對應工具中選擇所需驗證的定位服務

validation

準備 Block 數據(可選)

為了直觀的查看定位效果,一般建議加載對應區域的 Block 模型數據。請參照 Block 數據組件 的說明進行加載。

準備標註數據(可選)

如果需要在定位時顯示標註數據,可以使用 標註組件 標註或通過 標註數據包組件導入標註。

validation

如果這時場景中 Block 和標註數據都已經導入,場景中都會顯示

validation

準備 3D 內容(可選)

可以通過郵件菜單創建 3D 物體,需要注意 3D 物體需要放在 Block 節點下,

validation

創建出來後可以根據需要調整位置大小等,

validation

當然你也可以導入自己的模型,

validation

啟動工具

首先啟用工具,然後點擊運行按鈕啟動,

validation

你也可以通過 Unity 工具欄上的按鈕啟動,

validation

啟動後有提示彈窗,如果你在開發 Unity 應用,請仔細閱讀,

validation

打開 EIF

EIF 打開後會自動開始播放,

validation

查看效果

可以根據需求進行播放控制,通常效果會是這樣,

validation

你也可以完全隱藏 Block 模型,這樣就和真實場景中看到的效果是一致的,

validation

停止運行和應用恢復

通過工具按鈕停止運行,

validation

或者也可以通過 Unity 工具欄上的按鈕停止運行,

validation

如果你需要開發自己的應用,如果需要在編輯器上運行自己的程序,別忘記禁用驗證工具(僅對編輯器有效,不影響手機上效果),

validation

顯示效果及 Unity 使用建議

調整 Game 視窗大小

視窗大小建議與 EIF 影片影格大小一致。一般建議使用大致與 1080P 相當的固定大小,比如 1080x1920(橫向 1920x1080)。

validation validation

如果視窗大小與 EIF 影片影格差異較大,將無法檢視完整的影片畫面,工具也會顯示警告訊息。

調整場景光照

為了更好的觀察渲染效果,可以根據需求新增和調整光照。如果沒有 Unity 光照的特殊需求,可以讓 Unity 自動生成環境光,

validation validation

同時顯示 Scene 視窗和 Game 視窗

有些時候需要同時檢視 Scene 視窗和 Game 視窗的內容,這時候可以調整 Unity 預設視窗佈局,根據需求調整 Scene 視窗和 Game 視窗的位置。

validation

Unity 開發注意點

ARSession

工具啟動時會自動建立 ARSession 及其它必要的 EasyAR 元件,如果場景中本身就有 ARSessio n存在(active),則工具會停用原本的 ARSession。但是動態建立的 session 不會受控制,如果運行起來會報錯。

Main Camera

工具在運行時會修改 main camera 的 Clear Flags 和 Background。Clear Flags 會被改為 Solid Color。Background 會被改為黑色。這些修改不會被儲存。

中心模式

工具運行時可以使用所有可支援的中心模式。通常情況下推薦使用 First Target 中心模式。