Krótkie wprowadzenie do kotwic w chmurze w iOS

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

  1. Skopiuj lub pobierz pakiet ARCore SDK na iOS z GitHuba aby uzyskać kod przykładowej aplikacji.

  2. Otwórz okno terminala lub programu Finder i przejdź do folderu, w którym znajduje się sklonowany plik. lub pobrano pakiet SDK.

  3. 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:

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:

  1. Wykonaj instrukcje Firebase, by dodać Firebase do aplikacji.
  2. Pobierz plik GoogleService-Info.plist wygenerowany w ramach dodawania z Firebase do aplikacji.
  3. 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ń.
  4. W Xcode dodaj plik GoogleService-Info.plist do swojej aplikacji obok pola Info.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:

  1. 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.

  1. 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

  1. Podłącz urządzenie i uruchom aplikację w Xcode.

  2. (Opcjonalnie) Jeśli kompilujesz i uruchamiasz przykładową aplikację, zapoznaj się z poniższymi instrukcjami .

Wypróbuj przykładową aplikację

  1. Aby uruchomić aplikację, skompiluj i uruchom przykładową aplikację z pliku .xcworkspace go na swoim urządzeniu.

  2. W razie potrzeby przyznaj aplikacji uprawnienia do korzystania z aparatu. Następnie ARKit zacznie wykrywać samoloty przed kamerą.

  3. 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.

  4. 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.

  5. 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ć:

  1. Dodaj platform i pod do: Podfile projektu:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
.
  1. 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