AR Foundation'ı kullanmaya başlama

Unity'nin AR Vakfı, artırılmış gerçeklik deneyimlerini bir kez yazdıktan sonra herhangi bir ek değişiklik yapmadan Android veya iOS cihazlar için derleme yapmanıza olanak tanıyan platformlar arası bir çerçevedir. Çerçeve, Unity'nin AR Foundation paketiyle kullanılabilir.

ARCore'un isteğe bağlı AR Foundation için ARCore Uzantıları paketi ek işlevler sağlayarak uygulamanızda Bulut Sabitlemeleri, Kamera yapılandırma filtreleri, Kayıt ve Oynatma gibi özellikleri kullanmanıza olanak tanır.

Mevcut projeleri taşıyın veya yükseltin

  • Mevcut bir projeyi Unity için (kullanımdan kaldırılmış) ARCore SDK'sından Unity'nin AR Foundation'a ve isteğe bağlı olarak ARCore Uzantıları'na taşımak için taşıma rehberini inceleyin.
  • Mevcut bir projeyi AR Foundation'ın eski bir sürümünden yükseltmek için Unity'nin yükseltme ve geçiş kılavuzlarına bakın.

Koşullar

Hedef platformunuza bağlı olarak AR Foundation paketi için aşağıdakiler gerekir:

Android

Hırdavat

  • ARCore destekli bir Android cihaz veya emülatör
  • Cihazınızı geliştirme makinenize bağlamak için bir USB kablosu

Yazılım

iOS

Hırdavat

Yazılım

AR Foundation'ı kurma

AR Foundation Unity paketini yüklemek için aşağıdaki adımları uygulayın.

  1. Mevcut bir Unity projesini açın veya yeni bir 3D proje oluşturun.

  2. Window > Package Manager adresine gidiş rotasını izle.

  3. Packages öğesinin yanındaki Unity Registry öğesini seçin.

  4. Arama çubuğuna "AR Foundation" yazın.

  5. Install simgesini tıklayın.

Platforma özel eklenti paketlerini yükleyip etkinleştirin

AR Foundation paketi, Unity geliştiricilerine kullanabileceği bir arayüz sunar ancak AR özelliklerini uygulamaz. AR Foundation'ı hedef cihazda kullanmak için ayrı paketler yüklemeniz ve her bir platform için ilgili eklentiyi etkinleştirmeniz de gerekir.

Android

ARCore XR Eklentisi paketi, Android cihazlar için artırılmış gerçeklik uygulamaları oluşturmanıza olanak tanır. Uygulamanız Android cihazları hedefliyorsa bu adımları uygulayarak Unity projenize yükleyin. Uyumluluk sorunları yaşamamak için AR Temeli paketiyle aynı sürümü kullanın.

  1. Projenizde Window > Package Manager hedefine gidin.

  2. Packages öğesinin yanındaki Unity Registry öğesini seçin.

  3. Arama çubuğuna "ARCore XR eklentisi" yazın.

  4. Install simgesini tıklayın.

  5. Edit > Project Settings adresine gidiş rotasını izle. XR Plug-in Management ürününde Android sekmesini açıp ARCore hizmetini etkinleştirin.

iOS

ARKit XR Eklentisi, iOS cihazlar için artırılmış gerçeklik uygulamaları oluşturmanızı sağlar. Uygulamanız iOS cihazları hedefliyorsa bu adımları uygulayarak Unity projenize yükleyin. Uyumluluk sorunları yaşamamak için AR Temeli paketiyle aynı sürümü kullanın.

  1. Projenizde Window > Package Manager hedefine gidin.

  2. Packages öğesinin yanındaki Unity Registry öğesini seçin.

  3. Arama çubuğuna "ARKit XR eklentisi" yazın.

  4. Install simgesini tıklayın.

  5. Edit > Project Settings adresine gidiş rotasını izle. XR Plug-in Management ürününde iOS sekmesini açıp ARKit hizmetini etkinleştirin.

AR Oturumu yapılandırın ve sahnenize AR Temeli bileşenlerini ekleyin

Hareket izleme, çevre anlama ve ışık tahmini gibi AR süreçlerini etkinleştirmek için sahnede AR oturumu gerekir. AR oturumunu desteklemek için aşağıdaki oyun nesnelerine ihtiyacınız vardır:

AR Foundation 4.x

  • AR Session: Artırılmış gerçeklik deneyiminin yaşam döngüsünü kontrol eder.

  • AR Session Origin: AR koordinatlarını Unity dünya koordinatlarına dönüştürür.

Yeni oyun nesnelerini eklemeden önce varsayılan Main Camera değerini silin. AR Session Origin içinde yeni bir AR Camera ile değiştirilecek.

Yeni AR oyunu nesnelerini sahnenize ekleyin: Hierarchy bölmesini sağ tıklayıp XR seçeneğini belirleyin. Yeni bir AR Session ve yeni AR Session Origin oyun nesnesi ekleyin.

AR Foundation 5.x

  • AR Session: Artırılmış gerçeklik deneyiminin yaşam döngüsünü kontrol eder.

  • XR Origin: AR koordinatlarını Unity dünya koordinatlarına dönüştürür.

Yeni oyun nesnelerini eklemeden önce varsayılan Main Camera değerini silin. XR Origin içinde yeni bir AR Camera ile değiştirilecek.

Yeni AR oyunu nesnelerini sahnenize ekleyin: Hierarchy bölmesini sağ tıklayıp XR seçeneğini belirleyin. Yeni bir AR Session ve yeni XR Origin oyun nesnesi ekleyin.

Oynatıcı Ayarlarını Yapılandırın

Android

  1. Build Settings penceresini açmak için File > Build Settings adresine gidin.
  2. Platform altında, Android seçeneğini belirleyin ve Switch Platform'yi tıklayın.
  3. Player Settings simgesini tıklayın.

  4. Aşağıdaki değişiklikleri uygulayın:

    Player Settings > … Değer
    Other Settings > Rendering Auto Graphics API öğesinin işaretini kaldırın.
    Vulkan Graphics APIs altında listeleniyorsa Vulkan henüz ARCore tarafından desteklenmediğinden kaldırın.
    Other Settings > Package Name Java paket adı biçimi kullanarak benzersiz bir uygulama kimliği oluşturun.
    Örneğin, com.example.helloAR kullanın.
    Other Settings > Minimum API Level AR Zorunlu bir uygulama oluşturuyorsanız Android 7.0 'Nougat' (API Level 24) or higher olarak belirtin.
    İsteğe bağlı AR uygulaması oluşturuyorsanız Android API Level 19 or higher değerini belirtin.
    Other Settings > Scripting Backend Bir sonraki adımda ARM64 desteğinin etkinleştirilmesine izin vermek için Mono yerine IL2CPP seçeneğini belirleyin.

    Geliştirme sırasında:

    • Mono + 32 bit (ARMv7) kullanın
    • FAT (32 bit + 64 bit) ARCore APK'sını yükleyin

    Play Store'a gönderim yaparken:

    • IL2CPP hareketini kullanın
    • Play Store'un 64 bit gereksinimlerini karşılamak için hem 32 bit (ARMv7) hem de 64 bit (ARM64) seçeneğini etkinleştirin
    • İsteğe bağlı (2018.3 ve sonraki sürümlerde desteklenir): Build Settings ürününde Android App Bundles özelliğini etkinleştirin
    Other Settings > Target Architectures Google Play'in 64 bit gereksinimini karşılamak için ARM64 (64 bit ARM) özelliğini etkinleştirin. 32 bit cihazları desteklemek için ARMv7 (32 bit ARM) ayarını etkin bırakın.

iOS

  1. Build Settings penceresini açmak için File > Build Settings adresine gidin.
  2. Platform altında, iOS seçeneğini belirleyin ve Switch Platform'yi tıklayın.
  3. Player Settings simgesini tıklayın.

  4. Aşağıdaki ayarları yapılandırın:

    Player Settings > … Değer
    Other Settings > Bundle Identifier Uygulamanızın adını ters DNS biçiminde ekleyin.
    Örneğin, com.mycompany.myapp kullanın.
    Other Settings > Camera usage description AR (örneğin, ARKit) kullanımınızı açıklamak için bir açıklama girin.
    Other Settings > Target minimum iOS version 11.0 veya üzeri
    Other Settings > Architecture ARM64

Sırada ne var?