Penyiapan project Godot Engine

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

Panduan ini menjelaskan versi mesin yang direkomendasikan, SDK yang diperlukan, dan setelan project Android saat mengembangkan aplikasi Godot Engine untuk Android XR.

Prasyarat

Sebelum dapat mengonfigurasi project Godot Engine untuk pengembangan Android XR, Anda harus menyelesaikan prasyarat berikut:

  1. Download Godot 4.6.2 dari situs resmi Godot.
  2. Pastikan Anda memiliki headset XR atau kacamata XR.
  3. Instal Android Studio.

Menginstal dukungan build Android

Godot memerlukan alat build Android tertentu untuk mengompilasi dan mengekspor paket untuk spatial computing.

  1. Di Android Studio, gunakan SDK Manager untuk menginstal paket dan alat berikut:

    • Android SDK Platform: Android 14.0 ("UpsideDownCake") (Level API 34)
    • Android SDK Build-Tools: Versi 34.0.0 atau yang lebih tinggi
    • NDK: Versi 28.x apa pun
    • CMake: Versi 3.10.2

    Anda mungkin perlu memilih Show Package Details di SDK Manager untuk melihat semua versi alat yang tersedia.

  2. Di Godot, buka Editor > Editor Settings > Export > Android, lalu berikan jalur ke SDK Anda.

Membuat project XR Godot

Siapkan project baru untuk rendering spasial:

  1. Buka Godot dan buat project baru.

  2. Untuk Renderer, pilih Mobile.

    Ini adalah API grafis berperforma tinggi yang mengutamakan Vulkan dan direkomendasikan untuk Android XR.

    Dialog Create New Project di Godot Engine.

  3. Pilih opsi lain yang Anda inginkan, lalu klik Create.

  4. Buat adegan XR internal Anda (termasuk XROrigin3D dan XRCamera3D) menggunakan Panduan Penyiapan Adegan XR Godot Resmi.

    Buat adegan XR internal di project Godot baru Anda

Konfigurasikan setelan project

Selanjutnya, Anda akan mengonfigurasi setelan project untuk mengaktifkan OpenXR dan mengonfigurasi pipeline rendering untuk performa perangkat seluler:

  1. Buka Godot.
  2. Konfigurasi setelan project berikut untuk OpenXR:
    • Buka Project > Project Settings > XR > OpenXR, lalu pilih Enabled.
    • Buka Project > Project Settings > XR > Shaders, lalu pilih Enabled.

  3. Buka Rendering > Anti-Aliasing > Kualitas > MSAA 3D, lalu pilih 4x.

    Setelan ini memberikan kejernihan terbaik di Android XR.

Menyiapkan project untuk diekspor ke Android XR

Selesaikan langkah-langkah berikut untuk menyiapkan project Anda agar dapat diekspor ke Android XR:

  1. Menyiapkan Preset Ekspor: Buka Project > Export, lalu klik Add... > Android.

  2. Selesaikan Panduan Deployment: Ikuti Panduan Deployment Android Godot Resmi untuk mendapatkan petunjuk langkah demi langkah tentang izin dan deployment sekali klik.

  3. Periksa Versi SDK project Anda:

    • Untuk SDK Min: 34
    • Untuk Target SDK: 34

  4. Konfigurasi Mode XR: Tetapkan Mode XR ke OpenXR di setelan ekspor.

Menginstal Plugin Vendor Godot OpenXR

Aplikasi Anda harus menggunakan Plugin Vendor untuk mengakses ekstensi khusus Android XR. Ikuti langkah-langkah berikut untuk mendapatkan versi yang kompatibel:

  1. Di Godot, pilih AssetLib.

  2. Telusuri "Vendor".

    Temukan berbagai versi plugin Vendor Godot OpenXR dengan menelusuri Godot Asset Library

  3. Temukan plugin Godot OpenXR Vendors plugin versi 5.1 (atau yang lebih tinggi) dan download.

  4. Setelah download selesai, pilih Instal.

    Menginstal plugin Godot OpenXR Vendors

Lihat juga

Untuk mengetahui informasi selengkapnya tentang pengembangan Android XR dengan Godot, lihat halaman berikut dalam dokumentasi Godot Engine: