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 trybie AR lub opcjonalnie 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 automatycznie aktualizowana 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ę obsługującą funkcje AR można skonfigurować na 2 sposoby: Wymagana AR i Opcjonalny AR. To oznaczenie określa sposób interakcji aplikacji z aplikacją Usługi 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.

  • W Sklepie Google Play będą dostępne tylko aplikacje wymagane przez AR na urządzeniach, które obsługują ARCore.
  • Gdy użytkownik zainstaluje aplikację wymagającą AR, Sklep Google Play automatycznie zainstaluje na ich urządzeniach Usługi Google Play dla AR. Aplikacja musi jednak nadal przeprowadzić dodatkowe kontrole w czasie działania, jeśli Usługi Google Play dla AR są nieaktualne lub zostały odinstalowane ręcznie.

Aplikacja opcjonalnie AR używa ARCore do rozszerzania istniejących funkcji. Zawiera 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.

  • Opcjonalne aplikacje AR można instalować i uruchamiać na urządzeniach, które nie obsługują ARCore.
  • Gdy użytkownik zainstaluje opcjonalną aplikację AR, Sklep Google Play nie zainstaluje na urządzeniu automatycznie Usług Google Play dla AR.
Wymagana weryfikacja ARAR – opcjonalna
Wykorzystanie funkcji AR Podstawowa funkcjonalność aplikacji wymaga ARCore. ARCore zwiększa możliwości aplikacji. Aplikacja może działać bez obsługi ARCore.
Widoczność w Sklepie Play Aplikacja jest widoczna 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 razem z Twoją aplikacją. Aplikacja używa współprogram ARSession.Install() , by pobrać i zainstalować ARCore.
Wymagania dotyczące Androida minSdkVersion Android 7.0 (poziom API 24) Android 4.4 (poziom interfejsu API 19), choć uruchomienie wszelkich funkcji AR wymaga Androida w wersji 7.0 lub nowszej (poziom interfejsu API 24)
Aby sprawdzić stan obsługi i instalacji ARCore, musisz używać usługi ARSession.state
Musi używać współprogram ARSession.Install() aby zainstalować Usługi Google Play dla AR

Ustaw aplikację jako wymaganą AR

Android

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

  2. Kliknij Edit > Project Settings > Player i wybierz kartę z Androidem .

  3. W polu Other Settings > Identification wpisz Minimum API Level o wartości 24 lub wyższej.

iOS

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

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

  3. W polu Other Settings > Configuration podaj Target minimum iOS Version.

Ustawianie aplikacji jako AR jako opcjonalnej

Android

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

  2. Z menu Requirement wybierz Optional. aby ustawić w aplikacji tryb AR jako opcjonalny.

  3. Kliknij Edit > Project Settings > Player i wybierz kartę z Androidem .

  4. W polu Other Settings > Identification wpisz Minimum API Level o wartości 24 lub wyższej.

iOS

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

  2. Z menu Requirement wybierz Optional. aby ustawić w aplikacji tryb AR (opcjonalnie).

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

  4. W polu Other Settings > Configuration podaj Target minimum iOS Version.

Sprawdzaj czas działania

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

Zarówno aplikacje wymagane, jak i opcjonalne AR muszą używać współprogram ARSession.Install() .

W czasie działania aplikacje wymagane przez AR będą automatycznie sprawdzać upewnij się, że urządzenie docelowe:

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

Ustaw ARSession.attemptUpdate na false, aby wyłączyć te sprawdzanie domyślne. Twoja aplikacja powinien 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 lub Dane profilu urządzenia ARCore nie są zainstalowane lub nieaktualne. prosi użytkownika o zainstalowanie lub zaktualizowanie aplikacji Google Play Services for AR lub Dane profilu urządzenia ARCore przez połączenie ARSession.Install()
Urządzenie obsługuje ARCore oraz Google Play Services for AR i Dane profilu urządzenia ARCore są zainstalowane i aktualne. Tworzy zasób ARCore Session i zaczyna używać ARCore.

Możesz też sprawdzić ARSession.state, aby sprawdzić stany instalacji i wsparcia.

Zgodność z wymaganiami dotyczącymi prywatności użytkownika

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

Co dalej?