iOS'te Cloud Anchor için hızlı başlangıç kılavuzu

ARCore Cloud Anchor API veya ARCore Cloud Anchor hizmeti, iOS uygulamalarınız için bulut ankrajı özellikleri sağlar. Böylece hem iOS hem de Android cihazlardaki kullanıcıların AR deneyimlerini paylaşması mümkün olur.

Bu rehberde aşağıdakiler açıklanmaktadır:

  • Geliştirme ortamınızı Cloud Anchors ile çalışacak şekilde ayarlama
  • Örnek bir uygulamada yer işaretlerini barındırmayı ve çözmeyi deneyin

Ön koşullar

  • Xcode 13.0 veya sonraki sürümler
  • CocoaPods kullanıyorsanız CocoaPods 1.4.0 veya sonraki sürümler
  • iOS 12.0 veya sonraki sürümleri çalıştıran ARKit uyumlu bir Apple cihaz (iOS 12.0 veya sonraki sürümlerin dağıtım hedefi gereklidir)

Cloud Anchors'ı kullanma

Aşağıdaki adımlarda, ARCore Cloud Anchors'ı destekleyen bir uygulamayı yapılandırma ve oluşturma ile ilgili önemli görevleri göstermek için Cloud Anchors örnek uygulaması kullanılmaktadır.

Cloud Anchors örnek uygulamasını indirme

  1. Örnek uygulama kodunu almak için GitHub'dan iOS için ARCore SDK'sını klonlayın veya indirin.

  2. Terminal veya Finder penceresi açıp SDK'yı kopyaladığınız veya indirdiğiniz klasöre gidin.

  3. Örnek uygulama kodunu
    /arcore-ios-sdk-master/Examples/CloudAnchorExample adresinde bulabilirsiniz.

    Kalıcı bulut ankrajları örnek uygulama kodu
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExamplebölümündedir.

Oturum kurulumu

Örnek uygulama, oturumu ayarlama kapsamında aşağıdaki önemli görevleri gerçekleştirir:

Cloud Anchor kimliği paylaşımını ayarlama

Cloud Anchors örnek uygulaması, Cloud Anchor kimliklerini cihazlar arasında paylaşmak için Firebase'i kullanır. Kendi uygulamalarınızda farklı bir çözüm kullanabilirsiniz.

Örnek uygulamada Firebase veritabanını ayarlamak için:

  1. Firebase'i uygulamanıza ekleme ile ilgili Firebase talimatlarını uygulayın.
  2. Firebase'i uygulamanıza ekleme işlemi kapsamında oluşturulan GoogleService-Info.plist dosyasını indirin.
  3. Sana Özel için Firebase Storage'ı etkinleştirin:
    • Firebase konsoluna gidip örnek uygulama için ayarladığınız projeyi seçin.
    • Database panelini seçin.
    • Realtime Database seçeneğinde Get Started'i tıklayın.
    • Security rules for Realtime Database menüsü açılır.
      • Örneği çalıştırmak için Start in test mode simgesini seçin.
      • Yayınlamayı planladığınız bir uygulama için Firebase kullanıyorsanız daha kısıtlayıcı güvenlik kuralları uygulamanız gerektiğini unutmayın.
  4. Xcode'da, GoogleService-Info.plist dosyasını uygulamanıza Info.plist'ün yanına ekleyin.

ARCore API'yi ayarlama

Cloud Anchors'ı kullanmak için önce uygulamanız için ARCore API'yi ayarlamanız gerekir.

Kapsül güncellemesi çalıştırma

CloudAnchorExample uygulaması, ARCore SDK'sı ve ihtiyacınız olan iOS sürümleriyle önceden yapılandırılmış bir Podfile ile birlikte gönderilir. Bu bağımlılıkları yüklemek için:

  1. Bir Terminal penceresi açın ve Xcode projesinin bulunduğu klasörden pod update'yi çalıştırın.
    Bu işlem, daha sonra uygulamayı derleyip çalıştırmak için kullanacağınız bir .xcworkspace dosyası oluşturur.

Podfile'yi kendi uygulamalarınızda yapılandırma hakkında ayrıntılı bilgi için ARCore SDK'sını uygulamanıza ekleme başlıklı makaleyi inceleyin.

  1. Xcode'da projenin .xcworkspace dosyasını açın.

    Derleme hatalarını önlemek için .xcodeproj dosyasından değil, .xcworkspace dosyasından derlediğinizden emin olun.

Uygulama paketi kimliğini değiştirme

Uygulamayı ekibinizle imzalayabilmek için Xcode'da uygulamanın paket kimliğini değiştirin.

Uygulamayı derleyip çalıştırma

  1. Cihazınızı bağlayın ve uygulamayı Xcode'da başlatın.

  2. (İsteğe bağlı) Örnek uygulamayı oluşturup çalıştırıyorsanız Cloud Anchor'ları barındırmak ve çözmek için uygulamayı kullanmayla ilgili ayrıntılar için aşağıdaki bölüme bakın.

Örnek uygulamayı deneme

  1. Cihazınızda başlatmak için .xcworkspace dosyasından örnek uygulamayı derleyip çalıştırın.

  2. İstenirse uygulamaya kamera izinleri verin. ARKit, kameranızın önündeki düzlemleri algılamaya başlar.

  3. Barındırma moduna girmek için HOST simgesine dokunun. Barındırılan sabit noktaları paylaşmak için bir oda kodu oluşturulur ve ekranınızda gösterilir.

  4. Bulut ankrajı barındırmaya başlamak için bir uçağa dokunun.

    • Uygulama, düzleme bir Andy Android nesnesi yerleştirir ve buna bir ankraj ekler.
    • ARCore API bulut uç noktasına bir ana makine isteği gönderilir. Ana makine isteği, ankrajın yakınındaki görsel özelliklere göre konumunu temsil eden verileri içerir.
    • Yerleştirilen ankraj, bu alandaki bulut ankrajlarını çözmek için kullanılan bir kimlik alır.

  5. Aynı veya farklı bir cihaz kullanarak bu oda için daha önce barındırılan Cloud Anchor'lara erişmek üzere RESOLVE simgesine dokunup oda kodu girin.

    • ARCore API bulut uç noktasına bir çözüm isteği gönderilir.
    • Çözüm isteği bir bulut ankrajı kimliği içerir. Kimlik, barındırılan bir anktarla eşleşirse ve yerelleştirme başarılı olursa sunucu, ankörün yerel koordinatlarınızdaki dönüşümünü döndürür.
    • Örnek uygulama, sahnenize ankraj eklemek ve ona bağlı sanal nesneleri oluşturmak için dönüşümü kullanır.

ARCore SDK'sını uygulamalarınıza ekleme

Kendi uygulamalarınızda, Podfile dosyanızı ARCore SDK'sını ve desteklenen iOS sürümlerini içerecek şekilde güncellemeniz gerekir. Bunun için:

  1. Projenizin Podfile dosyasına aşağıdaki platform ve pod değerlerini ekleyin:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.48.0'
  1. Bir Terminal penceresi açın ve Xcode projenizin bulunduğu klasörden pod update dosyasını çalıştırın.
    Bu işlem, uygulamayı derlemek ve çalıştırmak için kullanacağınız bir .xcworkspace dosyası oluşturur.

Kalıcı bulut sabitlemeleri

Kalıcılık özelliğine sahip bir Cloud Anchor barındırma bölümünde açıklandığı gibi, bulut ankrajına 365 güne kadar geçerlilik süresi verebilirsiniz. Kalıcı bulut ankrajlarını kullanmaya yönelik örnek kod, GitHub'daki iOS için ARCore SDK'sındaki /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample dizininde bulunabilir.

Sonraki adımlar