AR Foundation'ı kullanmaya başlama

Unity'nin AR Foundation, artırılmış gerçeklik deneyimlerini bir kez yazmanız ve ardından ek değişiklik yapmadan Android veya iOS cihazlar için derlemeniz sağlayan platformlar arası bir çerçevedir. Çerçeve, Unity'nin AR Foundation paketi aracılığıyla kullanılabilir.

ARCore'un isteğe bağlı AR Foundation için ARCore Uzantıları paketi, ek işlevler ekleyerek uygulamanızda Bulut Sabit Noktaları, 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 (desteği sonlandırılmış) ARCore SDK'sından Unity'nin AR Foundation'una ve isteğe bağlı olarak ARCore Extensions'e taşımak için taşıma kılavuzuna bakın.
  • Mevcut bir projeyi AR Foundation'ın önceki bir sürümünden yükseltmek için Unity'nin yükseltme ve taşıma rehberlerini inceleyin.

Şartlar

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

Yapay Zeka

Donanım

  • 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

Donanım

Yazılım

AR Foundation'ı yükleme

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 gidin.

  3. Packages'ün yanındaki Unity Registry'i seçin.

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

  5. Install simgesini tıklayın.

Platforma özgü eklenti paketlerini yükleme ve etkinleştirme

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

Yapay Zeka

ARCore XR Eklentisi paketi, Android cihazlar için artırılmış gerçeklik uygulamaları geliştirmenizi sağlar. Uygulamanız Android cihazları hedefliyorsa bu paketi Unity projenize yüklemek için aşağıdaki adımları uygulayın. Uyumluluk sorunlarını önlemek için AR Foundation paketiyle aynı sürümü kullanın.

  1. Projenizde Window > Package Manager bölümüne 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 gidin. XR Plug-in Management'te Android sekmesini açın ve ARCore'yi etkinleştirin.

iOS

ARKit XR eklentisi, iOS cihazlar için artırılmış gerçeklik uygulamaları oluşturmanıza olanak tanır. Uygulamanız iOS cihazları hedefliyorsa uygulamayı Unity projenize yüklemek için aşağıdaki adımları uygulayın. Uyumluluk sorunlarını önlemek için AR Foundation paketiyle aynı sürümü kullanın.

  1. Projenizde Window > Package Manager bölümüne gidin.

  2. Packages'ün yanındaki Unity Registry'i seçin.

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

  4. Install simgesini tıklayın.

  5. Edit > Project Settings adresine gidin. XR Plug-in Management içinde iOS sekmesini açıp ARKit ayarını etkinleştirin.

AR oturumu yapılandırma ve sahnenize AR Foundation bileşenleri ekleme

Hareket izleme, ortam anlama ve ışık tahmini gibi AR işlemlerini etkinleştirmek için sahnenin AR oturumuna ihtiyacı vardır. AR oturumunu desteklemek için aşağıdaki oyun nesnelerine ihtiyacınız vardır:

AR Foundation 4.x

  • AR Session: Bir AR 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 öğesini silin. AR Session Origin tarihinde yeni bir AR Camera ile değiştirilecek.

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

AR Foundation 5.x

  • AR Session: AR 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 öğesini silin. XR Origin tarihinde yeni bir AR Camera ile değiştirilecek.

Yeni AR oyun nesnelerini sahnenize ekleyin: Hierarchy bölmesini sağ tıklayın ve XR'i seçin. Yeni bir AR Session ve yeni bir XR Origin oyun nesnesi ekleyin.

Oynatıcı ayarlarını yapılandırma

Yapay Zeka

  1. Build Settings penceresini açmak için File > Build Settings bölümüne gidin.
  2. Platform altında, Android öğesini seçin ve Switch Platform seçeneğini 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 işaretini kaldırın.
    Graphics APIs altında Vulkan listelenmişse Vulkan henüz ARCore tarafından desteklenmediğinden kaldırın.
    Other Settings > Package Name Java paketi adı biçimini kullanarak benzersiz bir uygulama kimliği oluşturun.
    Örneğin, com.example.helloAR değerini kullanın.
    Other Settings > Minimum API Level AR Gerekli bir uygulama oluşturuyorsanız Android 7.0 'Nougat' (API Level 24) or higher değerini belirtin.
    AR İsteğe Bağlı bir uygulama geliştiriyorsanız Android API Level 19 or higher değerini belirtin.
    Other Settings > Scripting Backend 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) kullanma
    • FAT (32 bit + 64 bit) ARCore APK'sı yükleme

    Play Store'a gönderirken:

    • IL2CPP hareketini kullanın
    • Play Store'un 64 bit şartlarını karşılamak için hem 32 bit (ARMv7) hem de 64 bit (ARM64) desteğ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 64 bit şartını karşılamak için ARM64 (64 bit ARM) sürümünü etkinleştirin. 32 bit cihazları desteklemek için ARMv7 (32 bit ARM) seçeneğini etkin bırakın.

iOS

  1. Build Settings penceresini açmak için File > Build Settings bölümüne gidin.
  2. Platform altında, iOS öğesini seçin ve Switch Platform seçeneğini 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'yi (ör. ARKit) kullanım şeklinizi açıklayan bir açıklama girin.
    Other Settings > Target minimum iOS version 11.0 veya üzeri
    Other Settings > Architecture ARM64

Sırada ne var?