Godot Engine proje kurulumu

Uygun XR cihazlar

Bu kılavuz, bu tür XR cihazlar için deneyimler oluşturmanıza yardımcı olur.

XR cihaz türleri hakkında bilgi edinin →

XR Kulaklığı

Kablolu XR Gözlükleri

XR cihaz türleri hakkında bilgi edinin →

Bu kılavuzda, Android XR için Godot Engine uygulaması geliştirirken önerilen motor sürümleri, gerekli SDK'lar ve Android proje ayarları ayrıntılı olarak açıklanmaktadır.

Ön koşullar

Android XR geliştirme için bir Godot Engine projesini yapılandırabilmenizden önce aşağıdaki ön koşulları tamamlamanız gerekir:

1. Resmi Godot web sitesinden Godot 4.6.2'yi indirin.
2. XR kulaklığınızın veya XR gözlüğünüzün olduğundan emin olun.
3. Android Studio'yu yükleyin.

Android derleme desteğini yükleme

Godot, uzamsal bilişim için paketleri derleyip dışa aktarmak üzere belirli Android derleme araçları gerektirir.

1. Android Studio'da aşağıdaki paketleri ve araçları yüklemek için SDK Yöneticisi'ni kullanın:

   • Android SDK Platformu: Android 14.0 ("UpsideDownCake") (API düzeyi 34)
   • Android SDK Build-Tools: 34.0.0 veya sonraki sürümler
   • NDK: 28.x sürümü
   • CMake: Sürüm 3.10.2

   Bir aracın mevcut tüm sürümlerini görmek için SDK Manager'da Paket Ayrıntılarını Göster'i seçmeniz gerekebilir.

2. Godot'ta Editor > Editor Settings > Export > Android'e (Düzenleyici > Düzenleyici Ayarları > Dışa Aktarma > Android) gidip SDK'nızın yolunu belirtin.

Godot XR projesi oluşturma

Uzamsal oluşturma için yeni bir proje oluşturun:

1. Godot'u açın ve yeni bir proje oluşturun.

2. Oluşturucu için Mobil'i seçin.

   Bu, Android XR için önerilen yüksek performanslı, Vulkan öncelikli grafik API'sidir.

   

3. İstediğiniz diğer seçenekleri belirleyip Oluştur'u tıklayın.

4. Resmi Godot XR Sahne Kurulumu Kılavuzu'nu kullanarak dahili XR sahnenizi (XROrigin3D ve XRCamera3D dahil) oluşturun.

   

Proje ayarlarını yapılandırın

Ardından, OpenXR'yi etkinleştirmek için proje ayarlarını yapılandıracak ve mobil performans için oluşturma ardışık düzenini yapılandıracaksınız:

1. Godot'u açın.
2. OpenXR için aşağıdaki proje ayarlarını yapılandırın:
   • Proje > Proje Ayarları > XR > OpenXR'a gidin ve Etkin'i seçin.
   • Project > Project Settings > XR > Shaders'a (Proje > Proje Ayarları > XR > Gölgelendiriciler) gidin ve Enabled'ı (Etkin) seçin.

3. Oluşturma > Kenar Yumuşatma > Kalite > MSAA 3D'ye gidin ve 4x'i seçin.

   Bu ayar, Android XR'da en iyi netliği sağlar.

Projenizi Android XR'ye aktarılacak şekilde ayarlama

Projenizi Android XR'ye aktarılacak şekilde ayarlamak için aşağıdaki adımları uygulayın:

1. Dışa aktarma hazır ayarı oluşturma: Proje > Dışa aktar'a gidin ve Ekle...'yi tıklayın. > Android.

2. Dağıtım Kılavuzu'nu tamamlayın: İzinler ve tek tıklamayla dağıtım hakkında adım adım talimatlar için Resmi Godot Android Dağıtım Kılavuzu'nu inceleyin.

3. Projenizin SDK sürümlerini kontrol edin:

   • Minimum SDK için: 34
   • Hedef SDK için: 34

4. XR modunu yapılandırma: Dışa aktarma ayarlarında XR Modu'nu OpenXR olarak ayarlayın.

Godot OpenXR Vendors eklentisini yükleyin

Uygulamanızın Android XR'a özel uzantılara erişmek için Vendors Plugin'i kullanması gerekir. Uyumlu bir sürüm edinmek için aşağıdaki adımları uygulayın:

1. Godot'ta AssetLib'i seçin.

2. "Satıcı"yı arayın.

   

3. Godot OpenXR Vendors eklentisinin 5.1 (veya daha yeni) sürümünü bulup indirin.

4. İndirme işlemi tamamlandıktan sonra Yükle'yi seçin.

   

Aşağıdaki kaynakları da incelemenizi öneririz:

Godot ile Android XR geliştirme hakkında daha fazla bilgi için Godot Engine dokümanlarındaki aşağıdaki sayfaları inceleyin:

• Resmi Godot XR Dokümanları
• Godot Android Export Documentation (Godot Android'e Aktarma Dokümanları)