Unreal Engine projesi kurulumu

Uygun XR cihazlar
Bu kılavuz, bu tür XR cihazları için deneyimler geliştirmenize 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 Unreal 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

Unreal Engine'i Android XR geliştirme için ayarlamadan önce aşağıdaki uygulamaları ve araçları yüklemeniz gerekir:

  1. Epic Games Launcher'ı indirip yükleyin.

    1. Epic Games Başlatıcı'dan Unreal Engine'in 5.6.x veya 5.8.x sürümünü yükleyin.

  2. Sisteminizi C++ kodu derleyecek şekilde ayarlayın (ör. Windows için Visual Studio 2022 veya macOS için Xcode kullanarak). Daha fazla bilgi için Epic'in C++ geliştirme ortamı kurulumu başlıklı makalesini inceleyin.

  3. .NET 8.0 SDK'yı yükleyin.

  4. Android Studio'yu (Rabbit 2 | 2026.2.2 veya sonraki sürümler) yükleyin.

Android derleme desteğini yükleme

Android XR belirli SDK sürümlerini kullandığından Unreal Engine ile birlikte doğru Android derleme araçlarını yüklemeniz gerekir.

  1. Epic Games Başlatıcısı'nı açın.

  2. Yüklü Engine sürümünüzün (Launch düğmesi) yanındaki açılır oku tıklayın ve Options'ı (Seçenekler) tıklayın.

    1. Yükleme seçeneklerine gidin, Android'i seçin ve Uygula'yı tıklayın.
    2. İstenirse motorun ihtiyaç duyduğu dosya uzantılarını kaydetmesine izin verin.

  3. Java JDK 17'yi yükleyin.

  4. Android Studio'da, Android XR örnekleri için gereken aşağıdaki belirli sürümleri yüklemek üzere SDK Manager'ı kullanın:

    • SDK platformları: 34, 35 ve 36
    • NDK: 29.0.x
    • Komut Satırı Araçları (tüm öğeler)

  5. Aşağıdaki sistem ortam değişkenlerini yapılandırmak için Epic'in Gelişmiş kurulum ve sorun giderme kılavuzunu uygulayın:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Unreal XR projesi oluşturma

Ardından yeni bir proje oluşturun ve projeyi gerekli XR eklentileri ve girişleriyle yapılandırın:

  1. Unreal Engine'i (5.6.x veya 5.8.x sürümü) başlatın.
  2. New Project Categories (Yeni Proje Kategorileri) bölümünde Virtual Reality (Sanal Gerçeklik) şablonunu seçin.
  3. Project Defaults (Proje Varsayılanları) menüsünde Target Platform'u (Hedef Platform) Mobile (Mobil) olarak ayarlayın.
  4. Mobil XR donanımında optimum performansı desteklemek için Quality Preset'i (Kalite Ön Ayarı) Scalable (Ölçeklenebilir) olarak ayarlayın.
  5. Bir proje adı seçin ve Oluştur'u tıklayın.

Android ayarlarını yapılandırma

Projeniz açıldıktan sonra Android XR için gerekli Android API seviyelerini ve grafik ayarlarını belirlemek üzere aşağıdaki adımları uygulayın:

  1. Edit > Project Settings'e (Düzenle > Proje Ayarları) gidin.
  2. Platforms > Android'e (Platformlar > Android) gidin.
  3. Accept SDK License (SDK Lisansını Kabul Et) düğmesi kırmızı renkle vurgulanmışsa bu düğmeyi tıklayın.
  4. APKPackaging bölümünde:
    • Minimum SDK Sürümü'nü 34 olarak ayarlayın.
    • Hedef SDK Sürümü'nü 34 (veya daha yeni bir sürüme) ayarlayın.

  5. Derleme bölümüne gidin ve Vulkan'ı destekle'yi seçin.

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

Oluşturma ayarlarını yapılandırma

Android XR için gereken yüksek kare hızlarına ve görsel netliğe ulaşmak için Unreal Engine'i optimize edilmiş mobil oluşturma yolunu kullanacak şekilde de yapılandırmanız gerekir:

  1. Edit > Project Settings'e (Düzenle > Proje Ayarları) gidin ve Engine > Rendering'e (Motor > Oluşturma) gidin.

  2. Forward Renderer (İleri İşleyici) bölümünde Forward Shading'i (İleri Gölgelendirme) seçin.

    İleri oluşturucu, mobil VR için varsayılan ertelenmiş oluşturucudan önemli ölçüde daha hızlıdır. Bu seçeneği etkinleştirmek için düzenleyicinin yeniden başlatılması ve gölgelendiricinin derlenmesi gerekir.

  3. Default Settings (Varsayılan Ayarlar) bölümünde Anti-Aliasing Method'ı (Örtüşme Önleme Yöntemi) MSAA olarak ayarlayın.

  4. Mobil bölümünde Mobil MSAA'yı 4x olarak ayarlayın.

    MSAA, Geçici AA'nın (TAA) neden olduğu bulanıklaştırma efektleri olmadan VR için en keskin sonuçları sağlar.

  5. VR bölümünde:

    1. Mobil HDR'yi temizleyin.

      Mobil cihazlarda Yüksek Dinamik Aralığı devre dışı bırakmak, işlem sonrası ek yükü önemli ölçüde azaltır.

    2. Mobil Çoklu İzleme'yi seçin.

      Bu sayede motor, her iki gözü tek bir geçişte oluşturarak CPU performansını önemli ölçüde artırır.

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

Şablon projeyi Android destekli bir cihaza dağıtma hakkında ayrıntılı talimatlar için Android geliştirme için Unreal Engine projelerini ayarlama başlıklı makaleyi inceleyin.