Thiết lập tính năng Xem trước trực tiếp cho 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.
Thiết bị đeo đầu XR
Kính thông minh XR có dây

Tính năng Xem trước trực tiếp cho phép bạn kiểm thử và lặp lại các hoạt động tương tác phức tạp ngay trong Unreal Editor bằng cách sử dụng dữ liệu trực tiếp từ Thiết bị Android XR. Với tính năng Xem trước trực tiếp, máy chủ sẽ kết xuất và gỡ lỗi nội dung, truyền trực tiếp khung hiển thị trực quan đến thiết bị Android XR thực của bạn và truyền các tiện ích OpenXR được hỗ trợ trở lại máy chủ theo thời gian thực.

Làm theo hướng dẫn này để thiết lập tính năng Xem trước trực tiếp cho dự án của bạn trong Unreal Engine.

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

Trước khi bắt đầu, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:

  • Android XR Engine Hub: Hoàn tất tất cả các bước trong phần bắt đầu của hướng dẫn Android XR Engine Hub để cài đặt và định cấu hình máy chủ cho tính năng Xem trước trực tiếp.
  • Phần cứng:

    • Sử dụng một máy chủ chạy Windows 11.
    • Sử dụng một card đồ hoạ hiện đại có hỗ trợ Vulkan Video Encoding (Mã hoá video bằng Vulkan).

Thiết lập các trình bổ trợ Android XR

Thiết lập Unreal Engine bằng các trình bổ trợ Android XR bắt buộc:

  1. Làm theo các bước trong hướng dẫn Android XR Extensions for Unreal Engine (Tiện ích Android XR cho Unreal Engine).

    Sau này, nếu bạn tạo một dự án mới hoặc mở một dự án mà bạn chưa dùng với tính năng Xem trước trực tiếp, hãy làm theo các bước tương tự một lần nữa.

  2. Đối với mỗi dự án, hãy đảm bảo dự án có một symlink đến thư mục trình bổ trợ của nhà cung cấp.

Định cấu hình chế độ cài đặt dự án

Định cấu hình chế độ cài đặt dự án cho tính năng phát trực tiếp Xem trước trực tiếp:

  1. Chuyển đến phần Project Settings > Platforms > Windows (Cài đặt dự án > Nền tảng > Windows).
  2. Đối với RHI đến Vulkan.
  3. Chuyển đến Edit > Plugins (Chỉnh sửa > Trình bổ trợ).
  4. Bật trình bổ trợ AndroidXRStreaming.
  5. Chuyển đến Edit (Chỉnh sửa) > Project Settings (Cài đặt dự án) > Description (Nội dung mô tả).
  6. Bật chế độ Bắt đầu ở chế độ thực tế ảo.

Bật thời gian chạy truyền phát trực tiếp

Giờ đây, dự án đã bật trình bổ trợ AndroidXRStreaming, hãy kiểm tra xem có thời gian chạy Android XR Streaming hay không:

  1. Chuyển đến Project Settings > Plugins > AndroidXRStreaming.
  2. Nhấp vào Bật tính năng phát trực tuyến AndroidXR.

    Bật thời gian chạy Truyền phát trực tiếp của Android XR

  3. Khởi động lại Unreal Engine để áp dụng các thay đổi này.

Định cấu hình ứng dụng truyền phát trực tiếp

Định cấu hình ứng dụng truyền phát trực tiếp bằng nhiều lựa chọn cho dự án của bạn:

  1. Chuyển đến Project Settings > Plugins (Cài đặt dự án > Trình bổ trợ).
  2. Trong phần AndroidXRStreamingClient, hãy xem xét từng lựa chọn sau đây và bật hoặc tắt các lựa chọn đó cho phù hợp với nhu cầu của dự án:

    • Auto Start Client On Preview (Tự động khởi động ứng dụng khách khi xem trước): Khi được bật, chế độ này sẽ khởi chạy ứng dụng khách xem trước trên mọi thiết bị hợp lệ, được chọn khi nhấp vào Start VR Preview (Bắt đầu xem trước VR) trong trình chỉnh sửa.
    • Auto Stop Client On Preview (Tự động dừng ứng dụng trong bản xem trước): Khi được bật, tính năng này sẽ kết thúc ứng dụng xem trước khi bản xem trước VR trong trình chỉnh sửa bị dừng.
    • Tự động chọn thiết bị tương thích: Khi bạn bật chế độ này, hệ thống sẽ tự động chọn thiết bị tương thích đầu tiên được kết nối với máy khi tìm kiếm thiết bị.
    • Hiện hộp thoại báo lỗi: Khi được bật, chế độ này sẽ hiển thị các hộp thoại báo lỗi bổ sung (ví dụ: hộp thoại báo lỗi sẽ xuất hiện nếu bạn cố gắng bắt đầu xem trước VR mà không chọn thiết bị khách). Tắt lựa chọn này để ẩn các hộp thoại này.
    • Làm mới: Khi được bật, nút Làm mới sẽ tìm kiếm các thiết bị đã kết nối và liệt kê các thiết bị tương thích (được xác định bằng sự hiện diện của ứng dụng khách Xem trước trực tiếp trong Android XR Engine Hub).

Bắt đầu xem trước trực tiếp

Bắt đầu chế độ Direct Preview (Xem trước trực tiếp) để phát trực tiếp từ Unreal Engine:

  1. Kết nối thiết bị Android XR với máy chủ lưu trữ bằng cáp USB-C chất lượng cao.

  2. Nếu bạn chưa từng sử dụng thiết bị này với tính năng Xem trước trực tiếp trước đây, hãy kết nối và định cấu hình thiết bị cho tính năng Xem trước trực tiếp trong Android XR Engine Hub trước khi bắt đầu Xem trước trực tiếp thông qua công cụ phát triển trò chơi của bạn.

  3. Trong Unreal Editor, hãy nhấp vào Play level in VR (Phát cấp độ trong thực tế ảo). Không sử dụng lựa chọn Phát trong trình chỉnh sửa thông thường khi bắt đầu tính năng Xem trước trực tiếp.