Interfejs ARCore Cloud Anchor API lub ARCore Cloud Anchor zapewnia funkcje kotwicy w chmurze w aplikacjach na iOS, zarówno na urządzeniach z iOS, jak i Androidem.
Z tego przewodnika dowiesz się, jak:
- Konfigurowanie środowiska programistycznego do pracy z Cloud Anchors
- Wypróbuj hosting i rozwiązywanie kotwic w przykładowej aplikacji
Wymagania wstępne
- Xcode w wersji 13.0 lub nowszej,
- Cocoapods w wersji 1.4.0 lub nowszej, jeśli używasz Cocoapods,
- urządzenie Apple z systemem iOS 12.0 lub nowszym zgodne z ARKit, (wymagane jest miejsce docelowe wdrożenia na iOS w wersji 12.0 lub nowszej)
Korzystanie z Cloud Anchors
Opisane poniżej czynności skorzystały z przykładowej aplikacji Cloud Anchors, która pokazuje kluczowe informacje o zadania związane z konfigurowaniem i tworzeniem aplikacji obsługującej ARCore Cloud Anchors.
Pobierz przykładową aplikację Cloud Anchors
Skopiuj lub pobierz pakiet ARCore SDK na iOS z GitHuba aby uzyskać kod przykładowej aplikacji.
Otwórz okno terminala lub programu Finder i przejdź do folderu, w którym znajduje się sklonowany plik. lub pobrano pakiet SDK.
Przykładowy kod aplikacji znajdziesz tutaj:
/arcore-ios-sdk-master/Examples/CloudAnchorExample
Kod przykładowej aplikacji trwałych kotwic w chmurze to za
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
Konfiguracja sesji
Przykładowa aplikacja wykonuje te ważne zadania w ramach konfiguracji sesja:
- Tworzenie
GARSession
- Tworzę
ARSession
i jego uruchamiania. - Ustawiam
ARSessionDelegate
. - Zaliczenie
ARFrame
s doGARSession
w metodziesession:didUpdateFrame:
.
Konfigurowanie udostępniania identyfikatora Cloud Anchor
Przykładowa aplikacja Cloud Anchors używa Firebase do udostępniania identyfikatorów Cloud Anchor urządzenia. W swoich aplikacjach możesz użyć innego rozwiązania.
Aby skonfigurować bazę danych Firebase w przykładowej aplikacji:
- Wykonaj instrukcje Firebase, by dodać Firebase do aplikacji.
- Pobierz plik
GoogleService-Info.plist
wygenerowany w ramach dodawania z Firebase do aplikacji. - Włącz pamięć Firebase dla przykładu:
- Otwórz konsolę Firebase i wybierz projekt, dla którego skonfigurujesz skonfigurowany projekt. z przykładowej aplikacji.
- Kliknij panel Database.
- Przy opcji Realtime Database kliknij Get Started.
- Otworzy się menu Security rules for Realtime Database.
- Do uruchomienia próbki wybierz Start in test mode.
- Pamiętaj, że jeśli używasz Firebase na potrzeby aplikacji, którą planujesz opublikować, należy użyć bardziej restrykcyjnych reguł zabezpieczeń.
- W Xcode dodaj plik
GoogleService-Info.plist
do swojej aplikacji obok polaInfo.plist
Konfigurowanie interfejsu ARCore API
Aby używać Cloud Anchors, musisz skonfigurować ARCore API dla Twojej aplikacji.
Uruchom aktualizację poda
Aplikacja CloudAnchorExample jest wysyłana ze wstępnie skonfigurowanym parametrem Podfile
ARCore SDK i wersje iOS, których potrzebujesz. Aby zainstalować te zależności:
- Otwórz okno terminala i uruchom
pod update
z folderu, w którym Projekt Xcode już istnieje.
Spowoduje to wygenerowanie pliku.xcworkspace
, którego użyjesz później do skompilowania uruchom aplikację.
Zapoznaj się z sekcją Dodawanie pakietu ARCore SDK do aplikacji.
, aby dowiedzieć się, jak skonfigurować Podfile
we własnych aplikacjach.
Otwórz plik
.xcworkspace
projektu w Xcode.Aby uniknąć błędów kompilacji, używaj
.xcworkspace
a nie.xcodeproj
.
Zmiana identyfikatora pakietu aplikacji
W Xcode zmień identyfikator pakietu aplikacji, aby móc podpisać aplikację ze swoim zespołem.
Kompilowanie i uruchamianie aplikacji
Podłącz urządzenie i uruchom aplikację w Xcode.
(Opcjonalnie) Jeśli kompilujesz i uruchamiasz przykładową aplikację, zapoznaj się z poniższymi instrukcjami .
Wypróbuj przykładową aplikację
Aby uruchomić aplikację, skompiluj i uruchom przykładową aplikację z pliku
.xcworkspace
go na swoim urządzeniu.W razie potrzeby przyznaj aplikacji uprawnienia do korzystania z aparatu. Następnie ARKit zacznie wykrywać samoloty przed kamerą.
Kliknij HOST, aby włączyć tryb hostingu. Kod pokoju służący do udostępniania hostowanych reklam zakotwiczonych jest generowany i wyświetla się na ekranie.
Kliknij samolot, aby zacząć hostować w nim kotwicę chmury.
- Aplikacja umieszcza w samolocie obiekt Andy’ego Androida i dołącza do niego kotwicę .
- Żądanie hosta jest wysyłane do punktu końcowego chmury ARCore API. Gospodarz żądanie zawiera dane reprezentujące pozycję kotwicy w stosunku do parametru funkcje wizualne w pobliżu.
- Po hostowaniu kotwica otrzymuje identyfikator służący do rozpoznawania chmury reklam zakotwiczonych w tym obszarze.
Kliknij RESOLVE i wpisz kod pokoju, aby wcześniej uzyskać dostęp hostowane są kotwice Cloud do tej sali przy użyciu tego samego lub innego urządzenia.
- Żądanie rozwiązania jest wysyłane do punktu końcowego chmury interfejsu ARCore API.
- Żądanie rozwiązania zawiera identyfikator kotwicy Cloud. Jeśli identyfikator pasuje do jeśli hostowana kotwica i lokalizacja działają poprawnie, serwer zwraca od kotwicy zgodnie z lokalnymi współrzędnymi.
- Przykładowa aplikacja używa przekształcenia, aby dodać do sceny reklamę kotwicy, które będzie można renderować.
Dodaj pakiet ARCore SDK do swoich aplikacji
Musisz zaktualizować w swoich aplikacjach Podfile
, by zawierał parametr
Pakiet ARCore SDK i obsługiwana obsługa wersji iOS. Aby to zrobić:
Dodaj
platform
ipod
do:Podfile
projektu:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.45.0'
- Otwórz okno terminala i uruchom
pod update
z folderu, w którym Twój projekt Xcode już istnieje.
Spowoduje to wygenerowanie pliku.xcworkspace
, który służy do tworzenia uruchom aplikację.
Trwałe kotwice w chmurze
Jak opisano w artykule Hostowanie kotwicy w Cloud z zachowaniem trwałości,
możesz zapewnić czasowi życia kotwicy chmury, który wynosi maksymalnie 365 dni. Przykładowy kod dla
przy użyciu trwałych kotwic w chmurze jest dostępne w /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
w ARCore SDK na iOS z GitHuba.
Dalsze kroki
Zobacz przewodnik dla programistów Cloud Anchors dla iOS. aby zapoznać się z przykładowym kodem aplikacji i dowiedzieć się więcej o pracy z Cloud Anchors we własnych aplikacjach.
Szczegóły znajdziesz w dokumentacji interfejsu ARCore iOS API.