Pratinjau Langsung memungkinkan Anda menguji dan melakukan iterasi pada interaksi kompleks langsung di dalam Unreal Editor menggunakan data live dari Perangkat Android XR. Dengan Pratinjau Langsung, mesin host merender dan men-debug konten, menstreaming viewport visual langsung ke perangkat Android XR fisik Anda, dan menstreaming 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:
- Versi Unreal Engine: Unreal Engine 5.6.1 atau yang lebih baru.
- Penyiapan project: Selesaikan semua langkah dalam panduan penyiapan project Unreal Engine.
- Android XR Engine Hub: Selesaikan semua langkah di bagian memulai 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 Vulkan Video Encoding.
Menyiapkan plugin Android XR
Siapkan Unreal Engine dengan plugin Android XR yang diperlukan:
Ikuti langkah-langkah dalam panduan Ekstensi Android XR untuk Unreal Engine memulai cepat.
Nanti, jika Anda membuat project baru atau membuka project yang belum Anda gunakan dengan Pratinjau Langsung, ikuti langkah-langkah yang sama lagi.
Untuk setiap project, pastikan project memiliki symlink ke folder plugin vendor.
Mengonfigurasi setelan project
Konfigurasi setelan project Anda untuk streaming Pratinjau Langsung:
- Buka Project Settings > Platforms > Windows.
- Untuk RHI ke Vulkan.
- Buka Edit > Plugins.
- Aktifkan plugin AndroidXRStreaming.
- Buka Edit > Project Settings > Description.
- Aktifkan Start In VR.
Mengaktifkan runtime streaming
Setelah project mengaktifkan plugin AndroidXRStreaming, periksa apakah runtime Streaming Android XR ada:
- Buka Project Settings > Plugins > AndroidXRStreaming.
Klik Enable AndroidXR Streaming.
Mulai ulang Unreal Engine untuk menerapkan perubahan ini.
Mengonfigurasi klien streaming
Konfigurasi klien streaming dengan berbagai opsi untuk project Anda:
- Buka Project Settings > Plugins.
Di bagian AndroidXRStreamingClient, tinjau setiap opsi berikut dan aktifkan atau nonaktifkan opsi tersebut agar sesuai dengan kebutuhan project Anda:
- Auto Start Client On Preview: Jika diaktifkan, akan meluncurkan aplikasi klien pratinjau di perangkat valid yang 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, akan otomatis memilih perangkat kompatibel pertama yang terhubung ke mesin saat menelusuri perangkat.
- Tampilkan Dialog Error: 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).
Memulai Pratinjau Langsung
Mulai Pratinjau Langsung untuk melakukan streaming langsung dari Unreal Engine:
Hubungkan perangkat Android XR Anda ke mesin host menggunakan kabel USB-C berkualitas tinggi.
Jika Anda belum pernah menggunakan perangkat ini dengan Pratinjau Langsung sebelumnya, hubungkan dan konfigurasi perangkat untuk Pratinjau Langsung di Android XR Engine Hub sebelum Anda memulai Pratinjau Langsung melalui game engine.
Di Unreal Editor, klik Play level in VR. Jangan gunakan opsi Play in Editor biasa saat memulai Pratinjau Langsung.