Menyiapkan Pratinjau Langsung untuk Unreal Engine

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Headset XR
Kacamata XR Berkabel

Pratinjau Langsung memungkinkan Anda menguji dan melakukan iterasi pada interaksi yang kompleks langsung di dalam Unreal Editor menggunakan data live dari Perangkat Android XR. Dengan Pratinjau Langsung, mesin host merender dan men-debug konten, melakukan streaming area pandang visual langsung ke perangkat Android XR fisik Anda, dan melakukan streaming ekstensi OpenXR yang didukung kembali ke host secara real time.

Ikuti panduan ini untuk menyiapkan Pratinjau Langsung untuk project Anda di Unreal Engine.

Prasyarat

Sebelum memulai, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

  • Android XR Engine Hub: Selesaikan semua langkah di bagian memulai dalam panduan Android XR Engine Hub untuk menginstal dan mengonfigurasi mesin host Anda untuk Pratinjau Langsung.
  • Hardware:

    • Gunakan mesin host yang menjalankan Windows 11.
    • Gunakan kartu grafis modern dengan dukungan Encoding Video Vulkan.

Menyiapkan plugin Android XR

Siapkan Unreal Engine dengan plugin Android XR yang diperlukan:

  1. Ikuti langkah-langkah dalam panduan panduan memulai Android XR Extensions untuk Unreal Engine.

    Nanti, jika Anda membuat project baru atau membuka project yang belum digunakan dengan Pratinjau Langsung, ikuti langkah yang sama lagi.

  2. Untuk setiap project, pastikan project memiliki symlink ke folder plugin vendor.

Konfigurasikan setelan project

Konfigurasikan setelan project Anda untuk streaming Direct Preview:

  1. Buka Setelan Project > Platforms > Windows.
  2. Untuk RHI ke Vulkan.
  3. Buka Edit > Plugins.
  4. Aktifkan plugin AndroidXRStreaming.
  5. Buka Edit > Setelan project > Description.
  6. Aktifkan Mulai Dalam VR.

Mengaktifkan runtime streaming

Setelah project mengaktifkan plugin AndroidXRStreaming, periksa apakah runtime Streaming Android XR ada:

  1. Buka Project Settings > Plugins > AndroidXRStreaming.
  2. Klik Enable AndroidXR Streaming.

    Mengaktifkan runtime Streaming Android XR

  3. Mulai ulang Unreal Engine untuk menerapkan perubahan ini.

Mengonfigurasi klien streaming

Konfigurasikan klien streaming dengan berbagai opsi untuk project Anda:

  1. Buka Project Settings > Plugins.
  2. Di bagian AndroidXRStreamingClient, tinjau setiap opsi berikut dan aktifkan atau nonaktifkan sesuai kebutuhan project Anda:

    • Auto Start Client On Preview: Jika diaktifkan, akan meluncurkan aplikasi klien pratinjau di perangkat yang valid dan dipilih saat mengklik Start VR Preview dari editor.
    • Auto Stop Client On Preview: Jika diaktifkan, akan menghentikan klien pratinjau saat pratinjau VR dari editor dihentikan.
    • Auto Select Compatible Device: Jika diaktifkan, otomatis memilih perangkat kompatibel pertama yang terhubung ke mesin saat menelusuri perangkat.
    • Show Error Dialogs: Jika diaktifkan, akan menampilkan dialog error tambahan (misalnya, dialog error akan ditampilkan jika Anda mencoba memulai pratinjau VR tanpa memilih perangkat klien). Nonaktifkan opsi ini untuk menyembunyikan dialog ini.
    • Refresh: Jika diaktifkan, tombol Refresh akan menelusuri perangkat yang terhubung dan mencantumkan perangkat yang kompatibel (ditentukan oleh keberadaan aplikasi klien Pratinjau Langsung di Android XR Engine Hub).

Mulai Pratinjau Langsung

Mulai Direct Preview untuk melakukan streaming langsung dari Unreal Engine:

  1. Hubungkan perangkat Android XR ke mesin host menggunakan kabel USB-C berkualitas tinggi.

  2. Jika Anda belum pernah menggunakan perangkat ini dengan Pratinjau Langsung, hubungkan dan konfigurasikan perangkat untuk Pratinjau Langsung di Android XR Engine Hub sebelum memulai Pratinjau Langsung melalui game engine Anda.

  3. Di Unreal Editor, klik Play level in VR. Jangan gunakan opsi Play in Editor yang biasa saat memulai Direct Preview.