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 kılavuzda aşağıdakilerin nasıl yapılacağı gösterilmektedir:

  • 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, Google Etiket Yöneticisi'nin sağladığı önemli bilgileri size göstermek için temel görevleri öğrendiniz.

Cloud Anchors örnek uygulamasını edinme

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

  2. Bir Terminal veya Finder penceresi açın ve klonladığınız klasöre gidin SDK'yı indirin.

  3. Örnek uygulama kodunu
    içinde bulabilirsiniz. /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    Kalıcı bulut ankrajları örnek uygulama kodu
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample adresindedir.

Oturum kurulumu

Örnek uygulama, oturum:

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'yi 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ı kullanmanız gerekir.
  4. Xcode'da, GoogleService-Info.plist dosyasını Info.plist.

ARCore API'yi kurma

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 komut dosyası, daha sonra derlemek için kullanacağınız bir .xcworkspace ve uygulamayı çalıştırın.

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.

    Yapı hatalarını önlemek için oluşturma işlemini .xcworkspace temel alınarak yaptığınızdan emin olun dosyasını değil, .xcodeproj dosyasını değil.

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ıp Xcode'da uygulamayı başlatın.

  2. (İsteğe bağlı) Örnek uygulamayı derliyor ve çalıştırıyorsanız aşağıdakilere bakın bölümünü inceleyin.

Örnek uygulamayı deneyin

  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 ve ardından kameranızın önündeki uçakları algılamaya başlar.

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

  4. Bulut sabitini 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 ankrajla eşleşirse ve yerelleştirme başarılı olursa sunucu, ankrajın yerel koordinatlarınızdaki dönüşümünü döndürür.
    • Örnek uygulama, çapayı sahnenize eklemek için dönüşümü kullanır ve sanal nesneleri oluşturabilirsiniz.

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

Kendi uygulamalarınızda da Podfile ARCore SDK'sı ve desteklenen iOS sürüm belirleme. 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.46.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 bağlantıları

Bir Cloud Anchor'u Kalıcı Olarak Barındırma bölümünde açıklandığı gibi, bulut çapasına 365 güne kadar geçerlilik süresi tanıyabilirsiniz. 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