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

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

Migration steps

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

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

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

參考 Creating and configuring AR session 來重新創建場景結構。

相關改動：

prefab 已刪除。

VIOCameraDeviceUnion 已刪除。

使用 AR Foundation 需要參考 Enabling AR Foundation in EasyAR projects 來使用 AR Foundation。

相關改動：

AR Foundation 支援已重新實現。

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

相關改動：

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

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

參考 Migration to version 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 版本中刪除。