Cập nhật lên AR Foundation phiên bản 5.x (Beta)

Các tiện ích ARCore cho AR Foundation của Unity hỗ trợ cả phiên bản 4.xphiên bản 5.x của AR Foundation. Để nâng cấp dự án AR hiện có lên AR Foundation 5.x từ AR Foundation 4.x, hãy làm theo các bước sau:

  1. Chỉ có trong Unity 2021.x trở xuống:
    Một số gói Unity được liên kết với các phiên bản Unity Editor cụ thể. Có thể bạn cần phải chỉnh sửa Package manifest (Tệp kê khai gói) trong dự án Unity để cập nhật lên AR Foundation 5.x trong một số phiên bản Unity Editor. Để biết thêm thông tin, hãy xem bài viết Truy cập vào AR Foundation 5.0 trong Unity 2021.

    Đảm bảo rằng Packages/manifest.json chứa các phiên bản này cho các gói sau:

    "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. Các tiện ích ARCore dành cho AR Foundation của Unity sử dụng Biểu tượng tập lệnh tuỳ chỉnh ARCORE_USE_ARF_5 để xác định khả năng tương thích của phiên bản. Để tương thích với AR Foundation 5.x, hãy thêm biểu tượng tập lệnh tuỳ chỉnh ARCORE_USE_ARF_5:

    1. Trong Edit > Project Settings > Player > Other Settings (Chỉnh sửa > Cài đặt dự án > Trình phát > Cài đặt khác), hãy cuộn xuống Script Compilation (Biên dịch tập lệnh).
    2. Sử dụng nút + để thêm ARCORE_USE_ARF_5.
    3. Chọn Áp dụng.
  3. AR Foundation 5.x yêu cầu gói Hệ thống đầu vào do sự phụ thuộc vào TrackedPoseDriver. Cảnh mẫu của tiện ích ARCore yêu cầu mô-đun đầu vào cũ.

    Để hỗ trợ cả gói Hệ thống đầu vào và Trình quản lý đầu vào cũ, trong phần Project Settings > Player > Other Settings (Cài đặt dự án > Trình phát > Cài đặt khác), hãy đặt Active Input cụ (Xử lý đầu vào đang hoạt động) thành Both (Cả hai).

  4. Làm theo các bước khác trong hướng dẫn nâng cấp và di chuyển AR Foundation của Unity.