更新至 AR Foundation 5.x 版(Beta 版)

ARCore Extensions for Unity AR Foundation 支持 4.x 版5.x 版 AR Foundation。如需将现有的 AR 项目从 AR Foundation 4.x 升级到 AR Foundation 5.x,请按以下步骤操作:

  1. 仅适用于 Unity 2021.x 或更低版本:
    某些 Unity 软件包绑定到特定的 Unity 编辑器版本。您可能需要修改 Unity 项目中的 Package manifest,才能在某些 Unity Editor 版本中更新到 AR Foundation 5.x。如需了解详情,请参阅在 Unity 2021 中访问 AR Foundation 5.0

    确保 Packages/manifest.json 包含用于以下软件包的这些版本:

    "dependencies": {
      -- other dependencies --
      "com.unity.xr.arcore": "5.0.5",
      "com.unity.xr.arfoundation": "5.0.5",
      "com.unity.xr.arkit": "5.0.5",
      -- other dependencies --
    }
    
  2. ARCore Extensions for Unity AR 基础使用 ARCORE_USE_ARF_5 自定义脚本符号来确定版本兼容性。为了与 AR Foundation 5.x 兼容,请添加 ARCORE_USE_ARF_5 自定义脚本符号

    1. Edit > Project Settings > Player > Other Settings 中,向下滚动到 Script Compilation
    2. 使用 + 按钮添加 ARCORE_USE_ARF_5
    3. 选择采用
  3. 由于依赖于 TrackedPoseDriver,因此 AR Foundation 5.x 需要输入系统软件包。 ARCore 扩展示例场景需要旧版输入模块。

    如需同时支持输入系统软件包和旧版输入管理器,请在 Project Settings > Player > Other Settings 中,将 Active Input Handling 设置为两者

  4. 按照 Unity AR 基础升级和迁移指南中的其他步骤进行操作。