Unreal Engine projesi 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 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

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

  1. Epic Games Başlatıcı'yı indirip yükleyin.

    1. Epic Games Başlatıcı'dan Unreal Engine'in 5.6.1 (veya daha yeni) sürümünü yükleyin.

  2. Sisteminizi C++ kodu oluşturacak şekilde ayarlayın (örneğin, Windows için Visual Studio 2022'yi veya macOS için Xcode'u kullanarak). Daha fazla bilgi için Epic'in C++ geliştirme ortamı kurulumu başlıklı makalesine bakın.

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

  4. Android Studio'yu (Panda 4 | 2025.3.4 Patch 1 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ı'yı açın.

  2. Yüklü motor sürümünüzün (Başlat düğmesi) yanındaki açılır oku tıklayın ve Seçenekler'i tıklayın.

    1. Yükleme seçeneklerine ilerleyin, 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ılavuzu'nu inceleyin:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Unreal XR projesi oluşturma

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

  1. Unreal Engine 5.6.1'i başlatın.
  2. Yeni Proje Kategorileri bölümünde Sanal Gerçeklik şablonunu seçin.
  3. Proje Varsayılanları menüsünde Hedef Platform'u Mobil olarak ayarlayın.
  4. Mobil XR donanımında optimum performansı desteklemek için Kalite Ön Ayarı'nı Ölçeklenebilir olarak ayarlayın.
  5. Bir proje adı seçip Oluştur'u tıklayın.

Android ayarlarını yapılandırma

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

  1. Düzenle > Proje Ayarları'na gidin.
  2. Platformlar > Android'e gidin.
  3. SDK Lisansını Kabul Et düğmesi kırmızı renkte 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 yüksek) olarak ayarlayın.

  5. Ekranı Derleme bölümüne kaydırın 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 üzere Unreal Engine'i optimize edilmiş mobil oluşturma yolunu kullanacak şekilde de yapılandırmanız gerekir:

  1. Düzenle > Proje Ayarları'na gidin ve Motor > Oluşturma'ya gidin.

  2. Forward Renderer bölümünde Forward Shading'i seçin.

    İleri oluşturucu, mobil VR için varsayılan ertelenmiş oluşturucudan önemli ölçüde daha hızlıdır. Bu özelliği etkinleştirmek için düzenleyicinin yeniden başlatılması ve gölgelendirici derlemesi gerektiğini unutmayın.

  3. Varsayılan Ayarlar bölümünde Kenar Yumuşatma Yöntemi'ni MSAA olarak ayarlayın.

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

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

  5. VR bölümünde:

    1. Mobil HDR'yi temizleyin.

      Mobil cihazlarda yüksek dinamik aralığın devre dışı bırakılması, işlem sonrası ek yükünü önemli ölçüde azaltır.

    2. Mobil Çoklu Görünüm'i seçin.

      Bu, motorun her iki gözü tek geçişte oluşturmasına olanak tanıyarak CPU performansını önemli ölçüde artırır.

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

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