從 EasyAR Sense Unity Plugin 4.2 及更老版本遷移 Unity 應用

從 4.3 版本開始，Unity 插件改爲通過 Unity Package Manager 進行分發和管理，且插件包結構有較大調整。因此從 4.2 或更低版本升級到 4.3 及更高版本時需要進行一些額外的步驟。

遷移步驟

從 4.2 或更低的版本上升級時，需要：

刪除老版本插件的所有文件，這些文件可能在 Assets/EasyAR、Assets/Plugins、Assets/Samples 和 Assets/StreamingAssets 文件夾中存在。
然後通過 Unity 的 Package Manager window 導入新版本。
根據下面各個版本的遷移指南，更新場景和代碼。

遷移到 4000 及更新版本需要進行下面這些改動。

參考創建和配置 AR session 來重新創建場景結構。

相關改動：

prefab 已刪除。

VIOCameraDeviceUnion 已刪除。

使用 AR Foundation 需要參考在 EasyAR 項目中啓用 AR Foundation 來使用 AR Foundation。

相關改動：

AR Foundation 支持已重新實現。

您無法在 XREAL X 及 XREAL Light 這些設備上使用 EasyAR，建議更換 XREAL Air2 Ultra。

相關改動：

Nreal/XREAL X 及 Nreal/XREAL Light 已不再被支持。

XREAL 支持已內建於 EasyAR Sense，支持 XREAL Air2 Ultra。

參考遷移到 4000 進行接下來的遷移工作。

4000 版本相較 4.x 還有更多變化。

版本 4.6 已不再維護，建議直接升級到 4000 或更新版本，EasyAR 網站上詳盡的 Unity 開發文檔都是爲 4000 及以上版本所準備的。

遷移到版本 4.6 需要進行下面這些改動。

建議參考 4.6 版本示例來了解新的場景結構，建議重新創建相關組件。

相關改動：

prefab 已刪除。

VIOCameraDeviceUnion 已刪除。

AR Foundation 支持已被拆成獨立的 package。

如不需要使用 AR Foundation，可以刪除場景中 AR Session 下的 AR Foundation 節點以及代碼中對 ARFoundationFrameSource 的使用。

相關改動：

AR Foundation 支持已被拆成獨立的 package。

如不需要使用 Nreal，可以刪除場景中 AR Session 下的 Nreal 節點以及代碼中對 NrealFrameSource 的使用。使用 Nreal 時不再需要創建虛擬的 package。

相關改動：

Nreal 支持已被拆成獨立的 package。

建議參考腳本中的接口文檔以及 4.6 版本示例來了解接口的變化和使用方式，並進行適當調整。

相關改動：

一些其它腳本接口也有所改變。

有一些公有方法的 XML 註釋中標記爲了 internal，應避免使用這些接口，這些接口已經在 4000 版本中刪除。

版本 4.4 已不再維護，建議直接升級到 4000 或更新版本，EasyAR 網站上詳盡的 Unity 開發文檔都是爲 4000 及以上版本所準備的。

遷移到版本 4.4 需要關注下面這些改動。

需要儘可能刪除對插件包內 prefab 的引用。如果繼續使用這些 prefab 會看到警告日誌，且這些日誌中包含在新的插件中如何替代的簡短指引。建議參考 4.4 版本示例來了解新的場景結構。

相關改動：

prefab 已經標記爲過時，並在 4.6 版本中刪除。

刪除 VIOCameraDeviceUnion 的使用。如果繼續使用這個組件會有警告日誌，且這些日誌中包含在新的插件中如何替代的簡短指引。建議參考 4.4 版本示例來了解新的場景結構。

相關改動：

VIOCameraDeviceUnion 已經標記爲過時，並在 4.6 版本中刪除。

建議參考腳本中的接口文檔以及 4.4 版本示例來了解接口的變化和使用方式，並進行適當調整。

相關改動：

一些其它腳本接口也有所改變。

有一些公有方法的 XML 註釋中標記爲了 internal，應避免使用這些接口，這些接口已經在 4000 版本中刪除。