Krótkie wprowadzenie do kotwic w chmurze w iOS

ARCore Cloud Anchor API, czyli usługa ARCore Cloud Anchor, zapewnia możliwość kotwicy w chmurze w aplikacjach na iOS, umożliwiając użytkownikom urządzeń z iOS i Androidem wspólne korzystanie z rzeczywistości AR.

Z tego przewodnika dowiesz się, jak:

  • Konfigurowanie środowiska programistycznego do pracy z kotwicami w Google Cloud
  • Możliwość hostowania i rozwiązywania problemów z kotwicami 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
  • zgodne z ARKit urządzenie Apple z systemem iOS 12.0 lub nowszym (wymagane jest wdrożenie w systemie iOS 12.0 lub nowszym).

Korzystanie z kotwic w chmurze

Poniżej znajdziesz instrukcje, jak za pomocą przykładowej aplikacji Cloud Anchors wyświetlić najważniejsze zadania związane z konfigurowaniem i tworzeniem aplikacji obsługującej ARCore Cloud Anchors.

Pobieranie przykładowej aplikacji Cloud Anchors

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

  2. Otwórz okno Terminal lub Findera i przejdź do folderu, w którym sklonowano lub pobrałeś pakiet SDK.

  3. Przykładowy kod aplikacji znajdziesz tutaj:
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    Przykładowy kod aplikacji z trwałymi kotwicami w chmurze znajduje się w
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Konfiguracja sesji

Podczas konfigurowania sesji przykładowa aplikacja wykonuje te ważne zadania:

Skonfiguruj udostępnianie identyfikatora kotwicy Cloud

Przykładowa aplikacja Cloud Anchors korzysta z Firebase do udostępniania identyfikatorów Cloud Anchors między urządzeniami. W swoich aplikacjach możesz używać innego rozwiązania.

Aby skonfigurować bazę danych Firebase w przykładowej aplikacji:

  1. Postępuj zgodnie z instrukcjami dodawania Firebase do aplikacji.
  2. Pobierz plik GoogleService-Info.plist wygenerowany podczas dodawania Firebase do aplikacji.
  3. Włącz pamięć Firebase dla przykładu:
    • Otwórz konsolę Firebase i wybierz projekt skonfigurowany na potrzeby przykładowej aplikacji.
    • Wybierz panel Database.
    • Na karcie Realtime Database kliknij Get Started.
    • Otworzy się menu Security rules for Realtime Database.
      • Aby uruchomić przykład, wybierz Start in test mode.
      • Pamiętaj, że jeśli używasz Firebase z aplikacją, którą chcesz opublikować, musisz zastosować bardziej restrykcyjne reguły zabezpieczeń.
  4. W Xcode dodaj do aplikacji plik GoogleService-Info.plist obok pola Info.plist.

Dodaj klucz interfejsu API

Aby używać kotwic w chmurze, musisz dodać do aplikacji klucz interfejsu API.

  1. uzyskać klucz interfejsu API, Jeśli dopiero zaczynasz korzystać z kluczy interfejsu API, przeczytaj artykuł Konfigurowanie kluczy interfejsu API w Centrum pomocy konsoli Google Cloud Platform.

  2. Włącz ARCore API w projekcie Google Cloud Platform.

  3. W Xcode dodaj do aplikacji swój klucz interfejsu API. Aby to zrobić, dodaj klucz do tego kodu w CloudAnchorManager.m:

    self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                 bundleIdentifier:nil
                                            error:nil];
    

Uruchom aktualizację poda

Aplikacja CloudAnchorExample ma wstępnie skonfigurowany pakiet Podfile zawierający potrzebne Ci wersje pakietu SDK ARCore SDK oraz iOS. Aby zainstalować te zależności:

  1. Otwórz okno terminala i uruchom pod update z folderu, w którym znajduje się projekt Xcode.
    Spowoduje to wygenerowanie pliku .xcworkspace, którego później użyjesz do skompilowania i uruchomienia aplikacji.

Szczegółowe informacje o konfigurowaniu Podfile we własnych aplikacjach znajdziesz w artykule Dodawanie pakietu SDK ARCore do aplikacji.

  1. Otwórz plik .xcworkspace projektu w Xcode.

    Aby uniknąć błędów kompilacji, upewnij się, że tworzysz kompilację z pliku .xcworkspace, a nie z pliku .xcodeproj.

Zmiana identyfikatora pakietu aplikacji

W Xcode zmień identyfikator pakietu aplikacji, aby móc podpisać aplikację zespołowi.

Tworzenie i uruchamianie aplikacji

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

  2. (Opcjonalnie) Jeśli tworzysz i uruchamiasz przykładową aplikację, przeczytaj sekcję poniżej, aby uzyskać szczegółowe informacje o używaniu aplikacji do hostowania i rozstrzygania kotwic Cloud.

Wypróbuj przykładową aplikację

  1. Skompiluj i uruchom przykładową aplikację z pliku .xcworkspace, aby uruchomić ją na urządzeniu.

  2. Gdy pojawi się prośba, przyznaj aplikacji uprawnienia do korzystania z aparatu. ARKit zacznie wtedy wykrywać samoloty przed kamerą.

  3. Kliknij HOST, aby włączyć tryb hostingu. Kod pokoju do udostępniania hostowanych kotwic zostanie wygenerowany i pojawi się na ekranie.

  4. Kliknij samolot, aby zacząć hostować w nim kotwicę w chmurze.

    • Aplikacja umieszcza obiekt Andy'ego Android na płaszczyźnie i łączy do niego kotwicę.
    • Żądanie hosta jest wysyłane do punktu końcowego interfejsu ARCore API w chmurze. Żądanie hosta zawiera dane reprezentujące położenie kotwicy w stosunku do pobliskich obiektów wizualnych.
    • Po hostowaniu kotwica otrzymuje identyfikator, który jest używany do rozwiązywania problemów z kotwicami w chmurze w tym pokoju.
  5. Kliknij RESOLVE i wpisz kod sali, aby uzyskać dostęp do kotwic w chmurze, które były wcześniej hostowane dla tej sali na tym samym lub innym urządzeniu.

    • Żądanie rozwiązania jest wysyłane do punktu końcowego interfejsu ARCore API w chmurze.
    • Żądanie rozwiązania zawiera identyfikator kotwicy w chmurze. Jeśli identyfikator pasuje do hostowanej kotwicy i lokalizacja się powiedzie, serwer zwraca przekształcenie kotwicy we współrzędnych lokalnych.
    • Przykładowa aplikacja korzysta z przekształcenia, aby dodać kotwicę do sceny i renderować powiązane z nią obiekty wirtualne.

Dodaj pakiet SDK ARCore do swoich aplikacji

We własnych aplikacjach musisz zaktualizować Podfile, aby obejmował pakiet SDK ARCore i obsługiwaną wersję systemu iOS. Aby to zrobić:

  1. Dodaj te platform i pod do Podfile swojego projektu:

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.40.0'
    
  1. Otwórz okno terminala i uruchom pod update z folderu, w którym znajduje się Twój projekt Xcode.
    Spowoduje to wygenerowanie pliku .xcworkspace, którego możesz użyć do skompilowania i uruchomienia aplikacji.

Stałe kotwice w chmurze

Zgodnie z opisem w sekcji Hostowanie kotwicy w chmurze o trwałości możesz przyznać usłudze kotwicy w chmurze czas życia do 365 dni. Przykładowy kod do korzystania z trwałych kotwic w chmurze jest dostępny w katalogu /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample w ARCore SDK na iOS na GitHubie.

Dalsze kroki