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 wymagającej lub opcjonalnej pod względem AR

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 korzystają z funkcji AR, komunikują się z Usługami Google Play dla AR za pomocą ARCore SDK. Aplikację obsługującą funkcje AR można skonfigurować na 2 sposoby: wymagająca AR i opcjonalna pod względem AR. To oznaczenie określa, jak aplikacja AR współdziała z aplikacją Usługi Google Play dla AR.

Aplikacja wymagająca 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ępni aplikacje wymagające AR tylko na urządzeniach obsługujących ARCore.
  • Gdy użytkownicy zainstalują aplikację wymagającą AR, Sklep Google Play automatycznie zainstaluje na ich urządzeniu Usługi Google Play dla AR. Twoja aplikacja musi jednak nadal przeprowadzać dodatkowe kontrole w czasie działania na wypadek, gdyby Usługi Google Play dla AR były nieaktualne lub zostały ręcznie odinstalowane.

Aplikacja opcjonalna pod względem AR używa ARCore do ulepszania dotychczasowych funkcji. Ma opcjonalne funkcje AR, które są aktywowane tylko na urządzeniach obsługujących ARCore, na których są zainstalowane Usługi Google Play dla AR.

  • Aplikacje opcjonalne pod względem AR można instalować i uruchamiać na urządzeniach, które nie obsługują ARCore.
  • Gdy użytkownicy zainstalują aplikację opcjonalną pod względem AR, Sklep Google Play nie zainstaluje automatycznie na urządzeniu Usług Google Play dla AR.
Wymagająca AROpcjonalna pod względem AR
Korzystanie z funkcji AR Twoja aplikacja potrzebuje ARCore do podstawowych funkcji. ARCore rozszerza funkcje aplikacji. Twoja aplikacja może działać bez obsługi ARCore.
Widoczność w Sklepie Play Twoja aplikacja jest widoczna w Sklepie Play tylko na urządzeniach obsługujących ARCore. Twoja aplikacja jest zgodna ze standardowymi procedurami dotyczącymi informacji o aplikacji.
Metoda instalacji Usług Google Play dla AR Sklep Play instaluje Usługi Google Play dla AR razem z Twoją aplikacją. Twoja aplikacja używa korutyny ARSession.Install() , aby pobrać i zainstalować ARCore.
Wymagania dotyczące minSdkVersion w Androidzie Android 7.0 (poziom 24 interfejsu API) Android 4.4 (poziom 19 interfejsu API), chociaż uruchomienie dowolnej funkcji AR wymaga co najmniej Androida 7.0 (poziom 24 interfejsu API)
Aby sprawdzić obsługę ARCore i stan instalacji, musisz użyć ARSession.state
Aby zainstalować Usługi Google Play dla AR, musisz użyć współprogramu ARSession.Install()

Ustawianie aplikacji jako wymagającej AR

Android

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

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

  3. W sekcji Other Settings > Identification określ a Minimum API Level na poziomie 24 lub wyższym.

iOS

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

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

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

Ustawianie aplikacji jako opcjonalnej pod względem AR

Android

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

  2. W menu Requirement wybierz Optional, aby ustawić aplikację jako opcjonalną pod względem AR.

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

  4. W sekcji Other Settings > Identification określ a Minimum API Level na poziomie 24 lub wyższym.

iOS

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

  2. W menu Requirement wybierz Optional, aby ustawić aplikację jako opcjonalną pod względem AR.

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

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

Przeprowadzanie kontroli w czasie działania

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

Zarówno aplikacje wymagające AR, jak i opcjonalne pod względem AR muszą przed utworzeniem sesji ARCore użyć korutyny ARSession.Install() , aby sprawdzić, czy zgodna wersja Usług Google Play dla AR jest (nadal) zainstalowana, oraz aby mieć pewność, że pobrano wszystkie wymagane dane profilu urządzenia ARCore.

W czasie działania aplikacje wymagające AR będą automatycznie przeprowadzać kontrole w czasie działania, aby mieć pewność, że urządzenie docelowe:

  • obsługuje ARCore;
  • ma zainstalowane Google Play Services for AR – jeśli nie są one zainstalowane (np. dlatego, że zostały usunięte przez użytkownika) lub ich wersja jest zbyt stara, Twoja aplikacja poprosi użytkownika o ich zainstalowanie lub zaktualizowanie;
  • ma aktualne dane profilu urządzenia ARCore – jeśli są one nieaktualne, aplikacja pobierze nowe dane.

Aby wyłączyć te domyślne kontrole, ustaw ARSession.attemptUpdate na false. Twoja aplikacja powinna nadal obsługiwać te warunki:

Warunek Działanie
Urządzenie nie obsługuje ARCore. Ukrywa funkcje związane z AR.
Urządzenie obsługuje ARCore, ale Google Play Services for AR i/lub dane profilu urządzenia ARCore nie są zainstalowane lub są nieaktualne. Prosi użytkownika o zainstalowanie lub zaktualizowanie Google Play Services for AR lub danych profilu urządzenia ARCore, wywołując ARSession.Install().
Urządzenie obsługuje ARCore, a Google Play Services for AR i dane profilu urządzenia ARCore są zainstalowane i aktualne. Tworzy sesję ARCore Session i zaczyna korzystać z ARCore.

Możesz też sprawdzić ARSession.state, aby poznać stan instalacji i obsługi.

Zapewnianie zgodności z wymaganiami dotyczącymi ochrony prywatności użytkowników

Aby opublikować aplikację w Sklepie Play, upewnij się, że jest ona zgodna z wymaganiami dotyczącymi ochrony prywatności użytkowników ARCore's User Privacy Requirements.

Co dalej?