Thiết lập dự án Unreal Engine

Các thiết bị XR được hỗ trợ
Hướng dẫn này giúp bạn xây dựng các trải nghiệm cho những loại thiết bị XR sau.
Tìm hiểu về các loại thiết bị XR →
Thiết bị đeo đầu XR
Kính thông minh XR có dây
Tìm hiểu về các loại thiết bị XR →

Hướng dẫn này trình bày chi tiết các phiên bản công cụ được đề xuất, SDK bắt buộc và chế độ cài đặt dự án Android khi phát triển ứng dụng Unreal Engine cho Android XR.

Điều kiện tiên quyết

Trước khi có thể thiết lập Unreal Engine để phát triển Android XR, bạn cần cài đặt các ứng dụng và công cụ sau:

  1. Tải xuống và cài đặt Epic Games Launcher.

    1. Trong Epic Games Launcher, hãy cài đặt phiên bản 5.6.x hoặc 5.8.x của Unreal Engine.

  2. Thiết lập hệ thống để tạo mã C++ (ví dụ: sử dụng Visual Studio 2022 cho Windows hoặc Xcode cho macOS). Để biết thêm thông tin, hãy xem phần Thiết lập môi trường phát triển C++ của Epic.

  3. Cài đặt SDK .NET 8.0.

  4. Cài đặt Android Studio (Rabbit 2 | 2026.2.2 trở lên).

Cài đặt tính năng hỗ trợ bản dựng Android

Vì Android XR dựa vào các phiên bản SDK cụ thể, nên bạn phải cài đặt các công cụ bản dựng Android chính xác cùng với Unreal Engine.

  1. Mở Trình chạy Epic Games.

  2. Nhấp vào mũi tên thả xuống bên cạnh phiên bản Engine đã cài đặt (nút Launch) rồi nhấp vào Options (Tuỳ chọn).

    1. Di chuyển xuống các lựa chọn cài đặt, chọn Android rồi nhấp vào Apply (Áp dụng).
    2. Nếu được nhắc, hãy cho phép công cụ đăng ký mọi đuôi tệp mà công cụ đó yêu cầu.

  3. Cài đặt Java JDK 17.

  4. Trong Android Studio, hãy sử dụng Trình quản lý SDK để cài đặt các phiên bản cụ thể sau đây mà các mẫu Android XR yêu cầu:

    • Nền tảng SDK: 34, 35 và 36
    • NDK: 29.0.x
    • Công cụ dòng lệnh (tất cả các mục)

  5. Làm theo Hướng dẫn thiết lập và khắc phục sự cố nâng cao của Epic để định cấu hình các biến môi trường hệ thống sau:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Tạo dự án Unreal XR

Tiếp theo, hãy tạo một dự án mới và định cấu hình dự án đó bằng các trình bổ trợ và dữ liệu đầu vào XR cần thiết:

  1. Chạy Unreal Engine (phiên bản 5.6.x hoặc 5.8.x).
  2. Trong phần New Project Categories (Danh mục dự án mới), hãy chọn mẫu Virtual Reality (Thực tế ảo).
  3. Trong trình đơn Project Defaults (Mặc định của dự án), hãy đặt Target Platform (Nền tảng mục tiêu) thành Mobile (Thiết bị di động).
  4. Đặt Quality Preset (Giá trị đặt trước về chất lượng) thành Scalable (Có thể mở rộng) để tăng hiệu suất tối ưu trên phần cứng XR dành cho thiết bị di động.
  5. Chọn tên dự án rồi nhấp vào Tạo.

Định cấu hình chế độ cài đặt Android

Sau khi mở dự án, hãy hoàn tất các bước sau để đặt cấp độ API Android và chế độ cài đặt đồ hoạ cần thiết cho Android XR:

  1. Chuyển đến Edit > Project Settings (Chỉnh sửa > Cài đặt dự án).
  2. Chuyển đến Platforms > Android (Nền tảng > Android).
  3. Nếu nút Accept SDK License (Chấp nhận giấy phép SDK) được đánh dấu màu đỏ, hãy nhấp vào nút đó.
  4. Trong phần APKPackaging:
    • Đặt Phiên bản SDK tối thiểu thành 34.
    • Đặt Phiên bản SDK mục tiêu thành 34 (hoặc cao hơn).

  5. Di chuyển xuống phần Build (Bản dựng) rồi chọn Support Vulkan (Hỗ trợ Vulkan).

    Vulkan là API đồ hoạ hiệu suất cao được đề xuất cho Android XR.

Định cấu hình chế độ cài đặt kết xuất

Để đạt được tốc độ khung hình cao và độ rõ nét hình ảnh cần thiết cho Android XR, bạn cũng phải định cấu hình Unreal Engine để sử dụng đường dẫn kết xuất được tối ưu hoá cho thiết bị di động:

  1. Chuyển đến Edit > Project Settings (Chỉnh sửa > Cài đặt dự án) rồi chuyển đến Engine > Rendering (Công cụ > Kết xuất).

  2. Trong phần Forward Renderer (Trình kết xuất chuyển tiếp), hãy chọn Forward Shading (Đổ bóng chuyển tiếp).

    Trình kết xuất chuyển tiếp nhanh hơn đáng kể cho VR trên thiết bị di động so với trình kết xuất trì hoãn mặc định. Xin lưu ý rằng để bật tính năng này, bạn cần khởi động lại trình chỉnh sửa và biên dịch chương trình đổ bóng.

  3. Trong phần Default Settings (Cài đặt mặc định), hãy đặt Anti-Aliasing Method (Phương pháp khử răng cưa) thành MSAA.

  4. Trong mục Mobile (Thiết bị di động), hãy đặt Mobile MSAA (MSAA cho thiết bị di động) thành 4x.

    MSAA mang lại kết quả sắc nét nhất cho VR mà không có hiệu ứng làm mờ do Temporal AA (TAA) gây ra.

  5. Trong phần VR:

    1. Xoá HDR cho thiết bị di động.

      Việc tắt Dải động cao trên thiết bị di động sẽ giảm đáng kể mức hao tổn sau khi xử lý.

    2. Chọn Nhiều khung hình trên thiết bị di động.

      Điều này cho phép công cụ kết xuất cả hai mắt trong một lượt, giúp cải thiện đáng kể hiệu suất của CPU.

Xem thêm

Để biết hướng dẫn chi tiết về cách triển khai dự án mẫu cho thiết bị chạy Android, hãy tham khảo bài viết Thiết lập dự án Unreal Engine để phát triển cho Android.