Włączanie AR w aplikacji AR Foundation (tylko na Androidzie)

Włącz AR, aby korzystać z funkcji rzeczywistości rozszerzonej w nowej lub istniejącej aplikacji.

Konfigurowanie aplikacji jako wymaganej w AR lub opcjonalnej w rzeczywistości rozszerzonej

Aby zaoszczędzić miejsce na poszczególnych urządzeniach, wszystkie funkcje AR są przechowywane w aplikacji Usługi Google Play dla AR, która jest aktualizowana oddzielnie przez Sklep Play. Aplikacje na Androida, które używają funkcji AR, komunikują się z Usługami Google Play dla AR za pomocą pakietu ARCore SDK. Aplikację obsługującą funkcje AR można skonfigurować na 2 sposoby: Wymagane AR lub AR opcjonalnie. To oznaczenie określa sposób interakcji aplikacji z Usługami Google Play dla AR.

Aplikacja wymagana AR nie może działać bez ARCore. Wymaga urządzenia obsługującego ARCore, na którym zainstalowano Usługi Google Play dla AR.

  • W Sklepie Google Play aplikacje AR AR będą dostępne tylko na urządzeniach obsługujących ARCore.
  • Gdy użytkownicy zainstalują aplikację z opcją AR, Sklep Google Play automatycznie zainstaluje na nim Usługi Google Play dla AR. Aplikacja musi jednak przeprowadzić dodatkowe kontrole działania, jeśli okaże się, że Usługi Google Play dla AR są nieaktualne lub zostały odinstalowane ręcznie.

Aplikacja AR opcjonalna używa ARCore do ulepszania istniejących funkcji. Zawiera opcjonalne funkcje AR włączone tylko na urządzeniach obsługujących ARCore, na których zainstalowano Usługi Google Play dla AR.

  • Opcjonalne aplikacje AR można instalować i uruchamiać na urządzeniach, które nie obsługują ARCore.
  • Gdy użytkownicy zainstalują opcjonalną aplikację AR, Sklep Google Play nie automatycznie zainstaluje na tym urządzeniu Usług Google Play dla AR.
Wymagane ARTryb AR opcjonalny
Wykorzystanie funkcji AR Twoja aplikacja potrzebuje ARCore do obsługi podstawowych funkcji. ARCore poprawia funkcje aplikacji. Twoja aplikacja może działać bez pomocy ARCore.
Widoczność w Sklepie Play Twoja aplikacja jest dostępna w Sklepie Play tylko na urządzeniach obsługujących ARCore. Aplikacja jest zgodna z zwykłymi procedurami.
Metoda instalacji Usług Google Play dla AR Sklep Play zainstaluje Usługi Google Play dla AR obok Twojej aplikacji. Twoja aplikacja używa ARSession.state do pobrania i zainstalowania ARCore.
Wymagania minSdkVersion w Androidzie Android 7.0 (poziom API 24) Android 4.4 (poziom API 19), chociaż działanie każdej funkcji AR wymaga co najmniej Androida 7.0 (poziom API 24)
Aby sprawdzić obsługę pomocy ARCore i stan instalacji, musisz użyć narzędzia ARSession.state

Wymaganie działania AR w aplikacji

Android

  1. Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore. Requirement jest domyślnie ustawiona na Required.

  2. Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną Androida.

  3. W polu Other Settings > Identification określ wartość Minimum API Level w wysokości 24 lub większej.

iOS

  1. Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit. Requirement jest domyślnie ustawiona na Required.

  2. Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną iOS.

  3. W sekcji Other Settings > Configuration określ Target minimum iOS Version dla swojej aplikacji.

Ustawianie AR jako opcjonalne

Android

  1. Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore.

  2. W menu Requirement wybierz Optional, aby ustawić swoją aplikację jako opcjonalną.

  3. Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną Androida.

  4. W polu Other Settings > Identification określ wartość Minimum API Level w wysokości 24 lub większej.

iOS

  1. Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit.

  2. W menu Requirement wybierz Optional, aby ustawić swoją aplikację na opcjonalną aplikację AR.

  3. Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną iOS.

  4. W sekcji Other Settings > Configuration określ Target minimum iOS Version dla swojej aplikacji.

Sprawdzaj środowisko wykonawcze

Sprawdzanie, czy Usługi Google Play dla AR są zainstalowane

Zarówno aplikacja AR wymagana, jak i opcjonalna aplikacja AR muszą wywołać metodę ARSession.state przed utworzeniem sesji ARCore, aby sprawdzić, czy zainstalowana jest zgodna wersja Usług Google Play dla AR, i upewnić się, że wszystkie wymagane dane profilu urządzenia ARCore zostały pobrane.

W trakcie działania aplikacje AR AR automatycznie sprawdzają środowisko wykonawcze, by upewnić się, że urządzenie docelowe:

  • Obsługuje ARCore
  • Aplikacja Google Play Services for AR została zainstalowana – jeśli nie jest zainstalowana (prawdopodobnie dlatego, że została usunięta przez użytkownika) lub wersja jest za stara, Twoja aplikacja poprosi użytkownika o jej zainstalowanie lub zaktualizowanie.
  • Ma aktualne dane profilu urządzenia ARCore – jeśli są nieaktualne, aplikacja pobierze nowe dane.

Ustaw ARSession.attemptUpdate na false, aby wyłączyć te domyślne kontrole. Aplikacja powinna nadal spełniać te warunki:

Warunek Czynność
Urządzenie nie obsługuje ARCore. Ukrywa funkcje związane z AR.
Urządzenie obsługuje ARCore, ale dane profilu urządzenia Google Play Services for AR lub ARCore nie są zainstalowane lub nieaktualne. Wyświetla użytkownikowi prośbę o zainstalowanie lub zaktualizowanie danych profilu urządzenia Google Play Services for AR lub ARCore przez wywołanie metody ARSession.Install().
Urządzenie obsługuje ARCore oraz Google Play Services for AR i dane profilu urządzenia ARCore są zainstalowane i aktualne. Tworzy ARCore Session i zaczyna korzystać z ARCore.

Informacje o stanie instalacji i pomocy znajdziesz też w sekcji ARSession.state.

Przestrzeganie wymagań dotyczących prywatności użytkownika

Aby opublikować aplikację w Sklepie Play, upewnij się, że jest ona zgodna z wymaganiami dotyczącymi prywatności użytkownika ARCore.

Co dalej?