Table of Contents

導入最新版本的 EasyAR 插件以啟用 Mega 功能

本文介紹了如何導入最新版本的 EasyAR Sense Unity Plugin (for Mega) 以啟用 Mega 功能。

使用 Mega 應導入最新版本的 EasyAR 插件

需要使用 Unity 2021.3.30 或更高版本。

下載頁面,您會看到 Unity 插件有兩個版本:EasyAR Sense Unity PluginEasyAR Sense Unity Plugin (for Mega)。 這兩個版本的主要差異為:

  • EasyAR Sense Unity Plugin: 不含 Mega 支援檔案,不能用於 Mega 開發。EasyAR 提供從 4.6 開始的歷史版本下載。
  • EasyAR Sense Unity Plugin (for Mega):包含 Mega 支援檔案,可以用於 Mega 開發。EasyAR 不提供歷史版本下載。

在使用 4000 之後的版本時,只要版本號相同,兩個壓縮包內的 EasyAR Sense Unity Plugin(即 com.easyar.sense)檔案是完全相同的,可以互相替換。因此,如果您已經下載並導入了最新版本的 EasyAR Sense Unity Plugin,可以直接從 EasyAR Sense Unity Plugin (for Mega) 壓縮包中提取 com.easyar.mega 檔案導入到 Unity 專案中,而不需要重新導入整個插件包。

附註

在 4000 版本之後,導入不相容的 com.easyar.sensecom.easyar.mega 時,腳本編譯器會報錯,提示版本不匹配。請確保 com.easyar.sensecom.easyar.mega 來自同一版本的插件包或互相相容。

4.7 版本的 com.easyar.sensecom.easyar.mega 的版本號包含後面的所有數字和字母在內必須完全一致,才能保證相容性。

在應用程式上線前,建議再次檢視 EasyAR 網站,如果有更新版本的 EasyAR Sense Unity Plugin (for Mega),請下載並導入最新版本以確保應用程式可以正常使用最新的 Mega 服務,以確保最長的相容性和最佳的效能。

重要事項

使用過時的 EasyAR Sense Unity Plugin (for Mega) 開發的應用程式,可能無法使用最新的 Mega 服務。 在線上服務沒有變化時(即 Mega 定位庫的版本沒有更新時),使用舊版本的 EasyAR Sense Unity Plugin (for Mega) 打包的應用程式仍然可以正常使用。

導入 EasyAR 插件和 Mega 支援包

解壓下載的 zip 包之後可以看到 readme 和若干 tgz 檔案,tgz 檔案可以直接導入 Unity 不要再解壓。

導入方法:

  • 從選單列依序點擊 Window 並選擇 Package Manager
  • 在彈出的視窗中單擊左上角的 + 號, 選擇 Install Package from tarball ...
  • 在彈出的對話方塊中選擇下載並解壓得到的 .tgz 檔案
  • 只導入 com.easyar.sense 可以開發 Mega 應用程式,但不支援 block mesh 載入及內容參考擺放等編輯器功能。
  • 導入 com.easyar.sensecom.easyar.mega 可以開發 Mega 應用程式,支援 block mesh 載入及內容參考擺放等編輯器功能。
  • 通常不需要導入 com.easyar.mega.studio。這個工具不能用於 Unity 開發,僅用於建立和導入標註資料,並配合 Mega Toolbox 檢視效果。

com.easyar.sensecom.easyar.mega 兩個 .tgz 檔案導入順序不限,可以先導入 com.easyar.sense,也可以先導入 com.easyar.mega

alt text

成功導入 com.easyar.sensecom.easyar.mega 後,在 Unity 的 Console 視窗中不應看到任何錯誤提示,同時打開 Package Manager 視窗,可以看到 EasyAR Sense Unity PluginEasyAR Mega Support 均已導入且顯示為剛剛導入的版本號。

alt text

提示

com.easyar.mega 依賴一些第三方套件,如 com.unity.cloud.ktxcom.unity.cloud.gltfast,導入時請確保網路連線正常,以便 Unity 可以自動下載並導入這些依賴套件。

在部分網路環境下,Unity 導入這些依賴套件的過程可能比較緩慢,建議修改網路環境或多次嘗試導入,直到所有依賴套件都成功導入。

附註

在導入插件套件後, tgz 檔案不能被刪除或移動到另一個位置,因此通常需要在導入前將這個檔案放在合適的地方。通常建議放在 Unity 專案 Packages 資料夾內,方便版本管理。

啟用 Mega 功能支援

檢查並開啟 Project Settings 面板中的 Mega > Mega Block/Landmark support 選項:

該選項在導入 com.easyar.mega 後會預設開啟,未導入時預設關閉。

附註

啟用 Mega 功能支援會強制新增(fine)定位權限,為達到最佳效果,這是使用 Mega 功能所必需的。

後續步驟