Przewodnik dla programistów aplikacji zakotwiczonych na temat Cloud Anchors na Androida

Dowiedz się, jak używać zakotwiczeń w chmurze we własnych aplikacjach.

Wymagania wstępne

Zanim przejdziesz dalej, przeczytaj podstawowe zagadnienia dotyczące AR i skonfiguruj sesję ARCore.

Jeśli dopiero zaczynasz korzystać z zakotwiczeń w chmurze, upewnij się, że wiesz, jak działają kotwice i kotwiska Cloud.

Włączanie w aplikacji kotwicy w chmurze

Kotwice chmury są domyślnie wyłączone w ARCore. Przykładowa aplikacja jest dostarczana z włączonymi kotwicami Cloud. Zanim zaczniesz korzystać z kotwic Cloud w swojej aplikacji, musisz włączyć ARARCore API w nowym lub istniejącym projekcie Google Cloud Platform. Ta usługa odpowiada za hostowanie, przechowywanie i rozwiązywanie problemów z kotwicami Cloud.

Musisz też włączyć funkcje Cloud Anchor w konfiguracji sesji AR aplikacji, aby mogła ona komunikować się z interfejsem ARCore API:

  1. Włącz funkcje Cloud Anchor w konfiguracji sesji AR.
  2. Wznów sesję AR.

Uwierzytelnianie aplikacji za pomocą interfejsu ARCore API

Musisz uwierzytelnić interfejs ARCore API w aplikacji, aby hostować i rozwiązywać problemy z zakotwiczeniami w chmurze. Gdy kierujesz reklamy na Androida, Unity oferuje opcje uwierzytelniania bez klucza i klucz interfejsu API. Aplikacje, które hostują i usuwają kotwice Cloud z TTL przez ponad 1 dzień, muszą używać uwierzytelniania bez klucza.

Domyślna strategia uwierzytelniania w nowych projektach Unity utworzonych w ARCore w wersji 1.24 lub nowszej to DoNotUse. Ma to na celu uniemożliwienie tworzenia aplikacji przy użyciu niepotrzebnych bibliotek. Jeśli Twoja aplikacja korzysta z kotwic w chmurze i została utworzona w ARCore w wersji 1.24 lub nowszej, musisz ręcznie włączyć uwierzytelnianie w ustawieniach projektu Unity.

Uwierzytelnianie bez kluczy

Użyj uwierzytelniania bez klucza, aby przechowywać i rozwiązywać problemy z kotwicami Cloud z wartością TTL między 1 a 365 dni.

  1. Wybierz Bez klucza, aby usunąć klucz interfejsu API zapisany w poprzednim ustawieniu kotwicy Cloud oraz dodać niezbędne zależności i wyjątki ProGuard. Jeśli zdarzyło Ci się już używać klucza interfejsu API, którego już nie potrzebujesz, zalecamy usunięcie go w Google Cloud Platform Console i usunięcie go z aplikacji po przeniesieniu użytkowników do najnowszej wersji.
  2. W Google Developers Console utwórz klient OAuth dla aplikacji na Androida, używając identyfikatora aplikacji i odcisku cyfrowego certyfikatu podpisywania. Powiąże to identyfikator aplikacji na Androida z projektem Google Cloud Platform.

Uwierzytelnianie klucza interfejsu API

Użyj uwierzytelniania klucza interfejsu API, aby hostować i rozwiązywać problemy z kotwicami Cloud z wartością TTL do 24 godzin (1 dzień).

  1. Aby uzyskać klucz interfejsu API, odwiedź Centrum pomocy konsoli Google Cloud Platform.
  2. Kliknij Edycja > Ustawienia projektu > Ustawienia projektu ARCore i dodaj klucz interfejsu API w polu Cloud Anchor API Keys, aby dodać nowy klucz interfejsu API do projektu.

Sprawdź jakość mapowania punktów cech

FeatureMapQuality wskazuje jakość punktów pomiarowych odtworzonych przez ARCore w ciągu ostatnich kilku sekund od danego położenia kamery. Zasadniczo kotwice Cloud hostowane za pomocą funkcji wyższej jakości są zwykle bardziej precyzyjnie rozwiązywane.

Wartość Opis
Insufficient Jakość punktów cech określonych na podstawie pozycji w ciągu ostatnich kilku sekund jest niska. Ten stan wskazuje, że ARCore prawdopodobnie będzie mieć trudniejszy dostęp do Cloud Anchor. Zachęć użytkownika do przeniesienia urządzenia, tak aby pożądana lokalizacja kotwicy Cloud, którą chce hostować, była widoczna pod różnymi kątami.
Sufficient Jakość punktów cech określonych na podstawie pozycji w ciągu ostatnich kilku sekund prawdopodobnie wystarczy, aby ARCore rozwiązać problem z Cloud Anchor, chociaż dokładność podawanej pozycji będzie prawdopodobnie mniejsza. Zachęć użytkownika do przeniesienia urządzenia, tak aby pożądana lokalizacja kotwicy Cloud, którą chce hostować, była widoczna pod różnymi kątami.
Good Jakość punktów cech zidentyfikowanych na podstawie pozycji w ciągu ostatnich kilku sekund prawdopodobnie wystarczy, aby ARCore udało się rozwiązać zadanie Cloud Anchor z dużą dokładnością.

Limity interfejsów API dla żądań hosta i rozstrzygania żądań

Interfejs ARCore API ma następujące limity przepustowości żądań:

Typ limitu Maksimum Czas trwania Dotyczy:
Liczba kotwic bez ograniczeń – projekt
Żądania kotwicy host 30 minuty Adres IP i projekt
Żądania zakotwiczenia kotwicy 300 minuty Adres IP i projekt

Sprawdzone metody zapewniania dobrych wrażeń użytkownikom

Aby zapewnić użytkownikom dobre wrażenia z aplikacją, wykonaj te czynności:

  • Zanim spróbujesz hostować kotwicę, poczekaj kilka sekund po rozpoczęciu sesji. Dzięki temu śledzenie ma czas na stabilizację.
  • Wybierając lokalizację na potrzeby kotwicy, znajdź obszar z funkcjami wizualnymi, które można łatwo odróżnić od siebie. Aby uzyskać jak najlepsze wyniki, unikaj powierzchni odblaskowych i powierzchni, które nie mają cech wizualnych, takich jak puste białe ściany.

  • Trzymaj aparat wytrenowany w środku zainteresowania i poruszaj urządzeniem, aby zmapować otoczenie pod różnymi kątami z zachowaniem zbliżonej odległości fizycznej. Zrób to przez maksymalnie 30 sekund. Dzięki temu będzie można rejestrować więcej danych wizualnych i rozwiązywać problemy.

  • Zadbaj o dobre oświetlenie świata rzeczywistego podczas hostowania i rozwiązywania problemów z zakotwiczeniami w chmurze.

Zasada wycofywania

  • Aplikacje utworzone przy użyciu pakietu SDK ARCore w wersji 1.12.0 lub nowszej podlegają zasadom wycofywania interfejsu Cloud Anchor API.
  • Aplikacje utworzone przy użyciu ARCore SDK w wersji 1.11.0 lub starszej nie mogą hostować ani rozwiązywać problemów z kotwiskami Cloud w wyniku korzystania ze starszej wersji interfejsu API ARCore.

Co dalej?