Table of Contents

从 EasyAR Sense Unity Plugin 4.2 及更老版本迁移 Unity 应用

从 4.3 版本开始，Unity 插件改为通过 Unity Package Manager 进行分发和管理，且插件包结构有较大调整。因此从 4.2 或更低版本升级到 4.3 及更高版本时需要进行一些额外的步骤。

迁移步骤

从 4.2 或更低的版本上升级时，需要：

  1. 删除老版本插件的所有文件，这些文件可能在 Assets/EasyAR、Assets/Plugins、Assets/Samples 和 Assets/StreamingAssets 文件夹中存在。
  2. 然后通过 Unity 的 Package Manager window 导入新版本。
  3. 根据下面各个版本的迁移指南，更新场景和代码。

迁移到 4000 及更新版本

迁移到 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

警告

版本 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

警告

版本 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 版本中删除。