Thiết lập dự án Unity

Hướng dẫn này trình bày chi tiết các phiên bản trình chỉnh sửa, chế độ cài đặt đồ hoạ, chế độ cài đặt URP và chế độ cài đặt dự án Android được đề xuất khi phát triển một ứng dụng Unity cho Android XR.

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

Để phát triển bằng Unity, bạn cần Tải và cài đặt Unity Hub.

Cài đặt phiên bản 6000.0.58f2 trở lên của Trình chỉnh sửa Unity và Android Build Support (Hỗ trợ bản dựng Android), bao gồm:

• OpenJDK
• SDK Android
• Công cụ Android NDK

Chọn một công cụ kết xuất

Bạn nên sử dụng API đồ hoạ Vulkan để kết xuất các ứng dụng Android XR. Để chọn Vulkan làm API đồ hoạ, hãy làm theo các bước sau:

1. Trong Unity, hãy chuyển đến phần Edit (Chỉnh sửa) > Project Settings (Cài đặt dự án) > Player (Trình phát).
2. Chọn thẻ Android rồi chuyển đến Other Settings > Rendering (Cài đặt khác > Kết xuất).
3. Nếu bạn bật Auto Graphics API, hãy tắt chế độ cài đặt này để hiển thị phần Graphics APIs (API đồ hoạ).

4. Trong phần Graphics APIs (API đồ hoạ), hãy chọn nút Thêm (+) rồi chọn Vulkan trong trình đơn thả xuống.

   

5. Sắp xếp lại các API Đồ hoạ bằng cách sử dụng các ô điều khiển (=) để Vulkan xuất hiện đầu tiên.

6. Bạn cũng có thể chọn bất kỳ API Đồ hoạ nào khác rồi nhấp vào nút Xoá (-) để xoá các API đó.

Universal Render Pipeline (Quy trình kết xuất phổ quát)

Android XR tương thích với Universal Render Pipeline (URP). Nếu dự định sử dụng chế độ truyền qua, bạn nên cập nhật chế độ cài đặt URP mặc định để có hiệu suất truyền qua tốt nhất trên Android XR.

Lưu ý: Đối với các dự án hiện có có tài sản được tạo cho Render Pipeline tích hợp, bạn nên sử dụng Render Pipeline Converter để chuyển đổi những tài sản đó cho tương thích với URP.

Bảng sau đây liệt kê các chế độ cài đặt URP mà Unity đề xuất. Các chế độ này sẽ được giải thích chi tiết hơn trong các phần sau.

Xem xét	Vị trí	Giá trị được đề xuất
HDR	Tài sản Universal Render Pipeline	Đã tắt
Hậu xử lý	Dữ liệu trình kết xuất chung	Đã tắt

Lưu ý: Bạn phải dùng Vulkan nếu đang sử dụng URP. Bạn nên sử dụng Vulkan làm API đồ hoạ cho Android XR, vì các tính năng đồ hoạ mới hơn chỉ được hỗ trợ bằng API đó.

Chế độ cài đặt Universal Render Pipeline Asset

Hãy làm theo các bước sau để tối ưu hoá Universal Render Pipeline Asset cho Android XR:

1. Xác định vị trí Universal Render Pipeline Asset (Tài sản Quy trình kết xuất phổ quát) của dự án. Một cách để thực hiện việc này là nhập t:UniversalRenderPipelineAsset vào thanh tìm kiếm của cửa sổ Project (Dự án).

   Lưu ý: Nếu dự án của bạn không chứa Universal Render Pipeline Asset, hãy tham khảo Installing the Universal Render Pipeline into an existing Project (Cài đặt Universal Render Pipeline vào một Dự án hiện có) trong tài liệu về URP.

2. Trong phần đầu trang Chất lượng, hãy tắt chế độ HDR.

   

Chế độ cài đặt Dữ liệu của trình kết xuất chung

Hãy làm theo các bước sau để tối ưu hoá Dữ liệu trình kết xuất chung cho Android XR:

1. Xác định vị trí Tài sản dữ liệu Universal Renderer của dự án. Một cách để thực hiện việc này là nhập t:UniversalRendererData vào thanh tìm kiếm của cửa sổ Project (Dự án).

2. Trong Inspector (Trình kiểm tra), trong tiêu đề Post-processing (Xử lý hậu kỳ), hãy bỏ chọn Enabled (Đã bật).

   

Cấp độ API tối thiểu trên Android

Đặt dự án của bạn thành cấp độ API tối thiểu là 24, đây là cấp độ mà OpenXR Loader yêu cầu. Nếu không, các bản dựng của bạn có thể không thành công.

Hoàn tất các bước sau để thiết lập cấp độ API tối thiểu trên Android.

1. Chuyển đến phần Edit (Chỉnh sửa) > Project Settings (Cài đặt dự án) > Player (Trình phát).
2. Chọn thẻ Android rồi mở phần Cài đặt khác.
3. Trong mục Identification (Nhận dạng), đối với Minimal API level (Cấp độ API tối thiểu), hãy chọn 24 trở lên.

Điểm truy cập vào ứng dụng

Định cấu hình các chế độ cài đặt sau cho điểm truy cập ứng dụng:

1. Chuyển đến phần Edit (Chỉnh sửa) > Project Settings (Cài đặt dự án) > Player (Trình phát).
2. Chọn thẻ Android rồi mở phần Cài đặt khác.
3. Trong phần Configuration (Cấu hình), hãy đảm bảo rằng Application Entry Point (Điểm truy cập ứng dụng) đã đánh dấu GameActivity và bỏ đánh dấu Activity (Hoạt động).

Cửa sổ bật lên

Hầu hết các ứng dụng Android XR đều yêu cầu cửa sổ có thể thay đổi kích thước, vì chúng cần hiển thị các cửa sổ bật lên như yêu cầu về quyền hệ thống.

Hãy làm theo các bước sau để đảm bảo cửa sổ bật lên hiển thị đúng cách.

1. Chuyển đến phần Edit (Chỉnh sửa) > Project Settings (Cài đặt dự án) > Player (Trình phát).
2. Chọn thẻ Android rồi mở Resolution and Presentation (Độ phân giải và trình bày)
3. Trong phần Độ phân giải, hãy bật Hoạt động có thể đổi kích thước.

Xem thêm

• Unity Android XR: OpenXR
• Nhập các tiện ích Android XR cho Unity

---

OpenXR™ và biểu trưng OpenXR là các nhãn hiệu thuộc sở hữu của The Khronos Group Inc. và được đăng ký làm nhãn hiệu ở Trung Quốc, Liên minh Châu Âu, Nhật Bản và Vương quốc Anh.