AR Foundation için ARCore Uzantılarını kullanmaya başlama

İsteğe bağlı AR Foundation için ARCore Uzantıları paketi Unity'nin AR Foundation paketine işlev ekleyerek uygulamanızda Bulut Sabitlemeleri, kamera yapılandırma filtreleri ve Kayıt ve Oynatma gibi özellikleri kullanmanızı sağlar.

Koşullar

AR Foundation için ARCore Extensions ile geliştirme yapmak üzere şunlara ihtiyacınız vardır:

Android

Hırdavat

• ARCore destekli Android cihaz
• Cihazınızı geliştirme makinenize bağlamak için bir USB kablosu

Yazılım

• Android Derleme Desteği ile Unity 2019.4.3f1 veya üzeri
• AR Foundation 4.1.5 veya üzeri (ARCore Extensions for AR Foundation SDK'sı ile otomatik olarak yüklenir)
• ARCore XR Eklentisi 4.1.5 veya üzeri (AR Foundation için ARCore Extensions SDK'sı ile otomatik olarak yüklenir)

iOS

Hırdavat

• ARKit uyumlu, ARCore destekli bir cihaz
• Cihazınızı geliştirme makinenize bağlamak için bir USB kablosu

Yazılım

• iOS Derleme Desteği ile Unity 2019.4.3f1 veya üzeri
• AR Foundation 4.1.5 veya üzeri (ARCore Extensions for AR Foundation SDK'sı ile otomatik olarak yüklenir)
• ARKit XR Eklentisi 4.1.5 veya üzeri (ARKit Temeli SDK'sı için ARCore Extensions SDK'sı ile otomatik olarak yüklenir)
• Xcode 11.0 veya üzeri

ARCore Extensions paketini yükleyin

AR Foundation için ARCore Extensions'ı yüklemek üzere aşağıdaki adımları uygulayın.

Gruplandırılmış bağımlılıklar

1. Geliştirme ortamınızda AR Foundation'ın yüklü ve yapılandırılmış olduğundan emin olun.
2. Yeni bir Unity projesi açın veya oluşturun.
3. İstediğiniz hedef derleme platformunu seçin:
   1. File menüsünden Build Settings öğesini seçin.
   2. İstediğiniz hedef platforma bağlı olarak Android veya iOS seçeneklerinden birini belirleyin.
   3. Switch Platform simgesini tıklayın.

4. En son ARCore Extensions paketini içe aktarın:

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

   2. düğmesini tıklayıp açılır menüden Add package from git URL... seçeneğini belirleyin.
      

   3. Metin alanına aşağıdaki URL'yi yapıştırın:

      https://github.com/google-ar/arcore-unity-extensions.git
      

   4. Add simgesini tıklayın.

EDM4U olmadan

ARCore Uzantıları varsayılan olarak ek bağımlılıklarla paket hâlinde sunulur. Unity için Harici Bağımlılık Yöneticisi'nin farklı bir sürümünü kullanan diğer kitaplıkları (ör. Firebase Analytics) kullanırken tanımlanmamış davranış oluşabilir ve bağımlılar düzgün çalışmayabilir.

Kitaplık sürümü çakışmalarını önlemek için ARCore Uzantılarını paketlenmiş bağımlılıklar olmadan yükleyin:

1. EDM4U sürümünü içermeyen ARCore Uzantılarını ve com.google.external-dependency-manager'i indirin.
2. .tgz dosyalı UPM paketlerini içe aktarma ve paketleri aşağıdaki sırayla yükleme ile ilgili talimatları uygulayın:
   1. com.google.external-dependency-manager,
   2. ARCore Uzantıları (EDM4U olmadan).

ARCore Extensions yüklenirken Unity gerekli bağımlılıkların uygun bir sürümünü de otomatik olarak yükler:

• AR Foundation
• ARCore XR Plugin (Android hedeflenirken kullanılır)
• ARKit XR Plugin (iOS hedeflenirken kullanılır)

Bu bağımlılıklar Package Manager > Package: In project görünümünde görünmeyebilir. Ancak paketler Packages altındaki Project penceresinde görülebilir.

ARCore Uzantılarını ayarlama

AR Foundation 4.x

1. Hierarchy bölmesinde, sağ tıklayın ve aşağıdaki oyun nesnelerini ekleyin (önceden eklenmemişse):

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. Hierarchy bölmesinde ARCore Extensions paketini seçin.

3. Inspector bölmesinde, aşağıdaki alanların her biri için hedef düğmesini tıklayın ve her alanı aşağıdaki şekilde karşılık gelen oyun nesnesine bağlayın:

   • Session: Sahnenizin AR Session özelliğini kullanın.
   • AR Session Origin: Sahnenizin AR Session Origin özelliğini kullanın.
   • Camera Manager: Sahnenizin AR Camera özelliğini kullanın.

4. İsteğe bağlı olarak, Cloud Anchor'lar ve kamera yapılandırma filtreleri için aşağıdaki öğeleri oluşturup bağlayın.

   1. Project > Assets bölmesinde, sağ tıklayın ve Create > XR > ARCore Extensions Config seçeneğini belirleyin.

   2. Project > Assets bölmesinde, sağ tıklayın ve Create > XR > Camera Config Filter seçeneğini belirleyin.

   3. Hierarchy bölmesinde ARCore Extensions paketini seçin.

   4. Inspector bölmesinin ARCore Extensions Config alanında hedef düğmesini tıklayın ve ARCoreExtensionsConfig öğesine bağlanın.

   5. Inspector bölmesinin Camera Config Filter alanında hedef düğmesini tıklayın ve ARCoreExtensionsCameraConfigFilter öğesine bağlanın.

      Daha fazla bilgi için Cloud Anchor geliştirici kılavuzuna ve Kamerayı yapılandırma kılavuzuna bakın.

   6. 2020.3'ten daha eski bir Unity sürümü kullanıyorsanız:

      • Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme bölümünde Özel Gradle Özellikleri Şablonu'nu seçin.

Yukarıdaki ARCore Uzantıları alanlarının tümü uygun bir şekilde bağlandığında, ARCore Uzantıları Inspector bölmeniz şuna benzer:

AR Foundation 5.x

1. Hierarchy bölmesinde, sağ tıklayın ve aşağıdaki oyun nesnelerini ekleyin (önceden eklenmemişse):

   • XR > AR Session
   • XR > XR Origin (Mobile AR)
   • XR > ARCore Extensions

2. Hierarchy bölmesinde ARCore Extensions paketini seçin.

3. Inspector bölmesinde, aşağıdaki alanların her biri için hedef düğmesini tıklayın ve her alanı aşağıdaki şekilde karşılık gelen oyun nesnesine bağlayın:

   • Session: Sahnenizin AR Session özelliğini kullanın.
   • XR Origin: Sahnenizin XR Origin özelliğini kullanın.
   • Camera Manager: Sahnenizin AR Camera özelliğini kullanın.

4. İsteğe bağlı olarak, Cloud Anchor'lar ve kamera yapılandırma filtreleri için aşağıdaki öğeleri oluşturup bağlayın.

   1. Project > Assets bölmesinde, sağ tıklayın ve Create > XR > ARCore Extensions Config seçeneğini belirleyin.

   2. Project > Assets bölmesinde, sağ tıklayın ve Create > XR > Camera Config Filter seçeneğini belirleyin.

   3. Hierarchy bölmesinde ARCore Extensions paketini seçin.

   4. Inspector bölmesinin ARCore Extensions Config alanında hedef düğmesini tıklayın ve ARCoreExtensionsConfig öğesine bağlanın.

   5. Inspector bölmesinin Camera Config Filter alanında hedef düğmesini tıklayın ve ARCoreExtensionsCameraConfigFilter öğesine bağlanın.

      Daha fazla bilgi için Cloud Anchor geliştirici kılavuzuna ve Kamerayı yapılandırma kılavuzuna bakın.

   6. 2020.3'ten daha eski bir Unity sürümü kullanıyorsanız:

      • Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme bölümünde Özel Gradle Özellikleri Şablonu'nu seçin.

Yukarıdaki ARCore Uzantıları alanlarının tümü uygun bir şekilde bağlandığında, ARCore Uzantıları Inspector bölmeniz şuna benzer:

Mülkleri ayarlama hakkında daha fazla bilgi için Unity'nin mülkleri düzenleme kılavuzuna bakın.

Örnek projeler

AR Foundation için ARCore Uzantıları ile paket halinde sunulan örnek projeler, kendi projelerinizi oluşturmaya başlarken kullanabilirsiniz.

1. Window menüsünden Package Manager uygulamasını açıp ARCore Extensions paketini seçin.

2. Samples altında, aşağıda açıklanan örnek proje için Import seçeneğini tıklayın.

Aşağıdaki örnek projeler GitHub deposundan içe aktarılır:

• Coğrafi mekansal (yalnızca Android) - Küresel ölçekte AR deneyimleri oluşturun ve Google Street View kapsamındaki tüm alanlara uzaktan içerik ekleyin. Daha fazla bilgi için Geospatial API'ye giriş bölümüne bakın.

• PersistentCloudAnchors (Android ve iOS) - Gerçek konumlara dayalı etkileşimli dijital bilgi katmanlarıyla gerçek dünyada kalıcı AR deneyimleri ve zaman içinde birçok farklı cihazda birden fazla kişi tarafından paylaşılabilen tasarım deneyimleri oluşturun. Daha fazla bilgi için Cloud Anchor'a giriş başlıklı makaleyi inceleyin.

Sırada ne var?

AR Foundation için ARCore Uzantıları ile artık uygulamalarınızda Bulut Sabitlemeleri ve kamera yapılandırmalarını kullanabilirsiniz.

• Cloud Anchor geliştirici kılavuzu
• Kamera yapılandırma rehberi