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

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

Konfigurowanie aplikacji jako wymaganej lub opcjonalnej AR

Aby zaoszczędzić miejsce na poszczególnych urządzeniach, wszystkie funkcje AR są przechowywane w aplikacji o nazwie 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 SDK ARCore. Aplikację, która obsługuje funkcje AR, można skonfigurować na 2 sposoby: Wymagana rzeczywistość rozszerzona i opcjonalna AR. 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 są zainstalowane Usługi Google Play dla AR.

  • Sklep Google Play udostępnia aplikacje wymagane w rzeczywistości rozszerzonej tylko na urządzeniach, które obsługują ARCore.
  • Gdy użytkownicy zainstalują aplikację wymagającą AR, Sklep Google Play automatycznie zainstaluje Usługi Google Play dla AR na ich urządzeniach. Aplikacja nadal musi jednak przeprowadzać dodatkowe kontrole w czasie działania na wypadek, gdyby Usługi Google Play dla AR były nieaktualne lub zostały odinstalowane ręcznie.

Aplikacja opcjonalna AR używa ARCore do ulepszenia dotychczasowych funkcji. Zawiera opcjonalne funkcje AR, które są aktywowane tylko na urządzeniach obsługujących ARCore, na których zainstalowano Usługi Google Play dla AR.

  • Aplikacje opcjonalne w rzeczywistości rozszerzonej można instalować i uruchamiać na urządzeniach, które nie obsługują ARCore.
  • Gdy użytkownicy zainstalują aplikację opcjonalną AR, Sklep Google Play nie zainstaluje automatycznie Usług Google Play dla AR na urządzeniu.
Wymagana jest ARAR (opcjonalnie)
Wykorzystanie funkcji AR Twoja aplikacja potrzebuje ARCore do obsługi podstawowych funkcji. ARCore zwiększa funkcjonalność Twojej aplikacji. Twoja aplikacja może działać bez obsługi ARCore.
Widoczność w Sklepie Play Aplikacja jest dostępna w Sklepie Play tylko na urządzeniach obsługujących ARCore. Aplikacja jest zgodna z standardowymi procedurami dotyczącymi zamieszczania informacji.
Metoda instalacji Usług Google Play dla AR Sklep Play instaluje Usługi Google Play dla AR obok Twojej aplikacji. Twoja aplikacja używa usługi ARSession.state do pobierania i instalowania ARCore.
Wymagania Androida minSdkVersion Android 7.0 (poziom API 24) Android 4.4 (poziom interfejsu API 19), choć uruchomienie dowolnej funkcji AR wymaga Androida w wersji co najmniej 7.0 (poziom API 24).
Aby sprawdzić obsługę ARCore i stan instalacji, musi użyć: ARSession.state

Wymaganie stosowania trybu AR w aplikacji

Android

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

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

  3. W polu Other Settings > Identification podaj wartość Minimum API Level o wartości 24 lub większej.

iOS

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

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

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

Ustawianie trybu AR w aplikacji jako opcjonalnej

Android

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

  2. Z menu Requirement wybierz Optional, aby ustawić aplikację jako opcjonalną w rzeczywistości rozszerzonej.

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

  4. W polu Other Settings > Identification podaj wartość Minimum API Level o wartoś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ć aplikację jako opcjonalną w AR.

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

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

Sprawdzanie w czasie działania

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

Przed utworzeniem sesji ARCore zarówno aplikacje wymagane, jak i opcjonalne AR muszą wywołać metodę ARSession.state, aby sprawdzić, czy zainstalowano (nadal) zgodną wersję Usług Google Play dla AR i upewnić się, że wszystkie wymagane dane z profilu urządzenia ARCore zostały pobrane.

W czasie działania aplikacje wymagane przez AR automatycznie sprawdzają w czasie działania, czy urządzenie docelowe:

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

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

Warunek Działanie
Urządzenie nie obsługuje ARCore. Ukrywa funkcje związane z AR.
Urządzenie obsługuje ARCore, ale dane profilowe 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 ARSession.Install().
Urządzenie obsługuje ARCore oraz zainstalowane i aktualne dane z profilu urządzenia Google Play Services for AR oraz ARCore. Tworzy Session ARCore i zaczyna korzystać z ARCore.

Możesz też sprawdzić stan instalacji i pomocy w ARSession.state.

Przestrzegaj 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 opracowanymi przez ARCore.

Co dalej?