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 bulutta bağlantı özellikleri sağlayarak hem iOS hem de Android cihaz kullanıcılarının artırılmış gerçeklik (AR) deneyimlerini paylaşmalarını sağlar.

Bu kılavuzda aşağıdakilerin nasıl yapılacağı gösterilmektedir:

  • Geliştirme ortamınızı Cloud Anchors ile çalışacak şekilde ayarlama
  • Bağlayıcıları örnek bir uygulamada barındırmayı ve çözümlemeyi deneyin

Ön koşullar

  • Xcode 13.0 veya sonraki sürümler
  • Cocoapods kullanıyorsanız Cocoapods 1.4.0 veya üzeri
  • 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)
ziyaret edin.

Cloud Anchor'ları 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ı indirin

  1. GitHub'dan iOS için ARCore SDK'sını klonlayın veya indirin ifadesini girin.

  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 bağlantıları örnek uygulama kodu:
    içinde /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Oturum kurulumu

Örnek uygulama, oturum:

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

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

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

  1. Uygulamanıza Firebase'i ekleme ile ilgili Firebase talimatlarını uygulayın.
  2. Ekleme işleminin bir parçası olarak oluşturulan GoogleService-Info.plist dosyasını indirin Firebase'i uygulamanıza ekleyin.
  3. Örnek için Firebase depolama alanını etkinleştirin:
    • Firebase konsoluna gidin ve ayarladığınız projeyi seçin örnek uygulamaya gidin.
    • 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 seçeneğini belirleyin.
      • 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 Anchor'ları kullanmak için önce Uygulamanız için ARCore API.

Kapsül güncellemesini çalıştır

CloudAnchorExample uygulaması,Podfile İhtiyacınız olan ARCore SDK ve iOS sürümleri. Bu bağımlılıkları yüklemek için:

  1. Bir Terminal penceresi açın ve şu klasörden pod update komutunu çalıştırın: Xcode projesi mevcut.
    . Bu komut dosyası, daha sonra derlemek için kullanacağınız bir .xcworkspace ve uygulamayı çalıştırın.

ARCore SDK'sını uygulamanıza ekleme konusuna bakın inceleyebilirsiniz.Podfile

  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ı derleme ve ç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. Başlatmak için .xcworkspace dosyasından örnek uygulama derleyip çalıştırın cihazınıza indirin.

  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, uçağa bir Andy Android nesnesi yerleştirir ve bir çapa ekler. .
    • ARCore API bulut uç noktasına bir ana makine isteği gönderilir. Ev sahibi istek, çapanın konumunu görsel özellikler bulunur.
    • Bağlayıcı barındırıldıktan sonra, bulutu çözümlemek için kullanılan bir kimlik alır sabitler.

  5. Daha önce erişmek için RESOLVE seçeneğine dokunup bir oda kodu girin aynı veya farklı bir cihaz kullanılarak bu oda için Cloud Anchor'lar tarafından barındırılmıştır.

    • ARCore API bulut uç noktasına bir çözüm isteği gönderilir.
    • Çözümleme isteği bir bulut bağlayıcı kimliği içerir. Kimlik, barındırılan bağlantı ve yerelleştirme başarılı olursa sunucu, dönüşümünü yerel koordinatlarınıza alabilirsiniz.
    • Örnek uygulama, çapayı sahnenize eklemek için dönüşümü kullanır ve sanal nesneleri oluşturabilirsiniz.

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

Kendi uygulamalarınızda da Podfile ARCore SDK'sı ve desteklenen iOS sürüm belirleme. Bunun için:

  1. Aşağıdaki platform ve pod öğelerini ekleyin projenin Podfile:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
ziyaret edin.
  1. Bir Terminal penceresi açın ve şu klasörden pod update komutunu çalıştırın: Xcode projeniz var.
    . Bu, derleme ve derleme için kullanacağınız bir .xcworkspace dosyası ve uygulamayı çalıştırın.

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. Şunun için örnek kod: /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample üzerinden kalıcı bulut bağlantıları kullanılabilir. dizin: GitHub'daki iOS için ARCore SDK'sı

Sonraki adımlar