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, các SDK bắt buộc và chế độ cài đặt dự án Android khi phát triển một ứ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. Từ Epic Games Launcher, hãy cài đặt Unreal Engine phiên bản 5.6.1 (hoặc cao hơn).

  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 bài viết 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 (Panda 4 | 2025.3.4 Bản vá 1 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 đúng công cụ xây dựng Android cùng với Unreal Engine.

  1. Mở Epic Games Launcher.

  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 Áp dụng.
    2. Nếu được nhắc, hãy cho phép công cụ đăng ký mọi tiện ích tệp mà công cụ đó yêu cầu.

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

  4. Trong Android Studio, hãy 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 nâng cao về cách thiết lập và khắc phục sự cố 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 một 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. Khởi chạy Unreal Engine 5.6.1.
  2. Trong mục 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 Chế độ đặt sẵn về chất lượng thành Có thể mở rộng để nâng cao hiệu suất tối ưu trên phần cứng XR 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ác cấp độ API Android và chế độ cài đặt đồ hoạ bắt buộc 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 Bản dựng rồi chọn Hỗ trợ Vulkan.

    Vulkan là API đồ hoạ được đề xuất và có hiệu suất cao 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ể đối với VR di động so với trình kết xuất trì hoãn mặc định. Xin lưu ý rằng việc bật tính năng này yêu cầu bạn phải 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 phần Mobile (Thiết bị di động), hãy đặt Mobile MSAA (MSAA trên 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 trên thiết bị di động.

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

    2. Chọn Nhiều chế độ xem trên thiết bị di động.

      Điều này cho phép công cụ hiển thị cả hai mắt trong một lần truyền, giúp cải thiện đáng kể hiệu suất CPU.

Xem thêm

Để biết hướng dẫn chi tiết về cách triển khai một 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.