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
Örnek uygulama kodunu almak için GitHub'dan iOS için ARCore SDK'sını klonlayın veya indirin.
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 ankrajları örnek uygulama kodu
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
adresindedir.
Oturum kurulumu
Örnek uygulama, oturum:
GARSession
oluşturmaARSession
oluşturma çalıştırmak içinARSessionDelegate
ayarlanıyor.session:didUpdateFrame:
yöntemindeGARSession
'aARFrame
gönderme.
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:
- Firebase'i uygulamanıza ekleme ile ilgili Firebase talimatlarını uygulayın.
- Firebase'i uygulamanıza ekleme işlemi kapsamında oluşturulan
GoogleService-Info.plist
dosyasını indirin. - 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.
- 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:
- 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.
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
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
Cihazınızda başlatmak için
.xcworkspace
dosyasından örnek uygulamayı derleyip çalıştırın.İ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, 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.
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:
Projenizin
Podfile
dosyasına aşağıdakiplatform
vepod
değerlerini ekleyin:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.46.0'
- 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
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ı ARCore iOS API Referansı'nda inceleyin.