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)
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
GitHub'dan iOS için ARCore SDK'sını klonlayın veya indirin ifadesini girin.
Bir Terminal veya Finder penceresi açın ve klonladığınız klasöre gidin SDK'yı indirin.
Ö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:
GARSession
oluşturmaARSession
oluşturma çalıştırmak içinARSessionDelegate
ayarlanıyor.- Geçme
ARFrame
sn.session:didUpdateFrame:
yöntemindeGARSession
öğesine gönderilir.
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:
- Uygulamanıza Firebase'i ekleme ile ilgili Firebase talimatlarını uygulayın.
- Ekleme işleminin bir parçası olarak oluşturulan
GoogleService-Info.plist
dosyasını indirin Firebase'i uygulamanıza ekleyin. - Ö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.
- 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:
- 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
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
Cihazınızı bağlayıp Xcode'da uygulamayı başlatın.
(İ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
Başlatmak için
.xcworkspace
dosyasından örnek uygulama derleyip çalıştırın cihazınıza indirin.İstenirse uygulamaya kamera izinleri verin. ARKit ve ardından kameranızın önündeki uçakları algılamaya başlar.
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.
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.
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:
Aşağıdaki
platform
vepod
öğelerini ekleyin projeninPodfile
:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.45.0'
- 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
iOS için Cloud Anchors Geliştirici Kılavuzu'na bakın inceleyin ve örnek uygulama kodunu inceleyin ve Cloud Anchors ile çalışma hakkında daha fazla bilgi edinin. inceleyebilirsiniz.
Ayrıntılar için ARCore iOS API Referansı'nı inceleyin.