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 AR | AR – 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
Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore. Requirement ma domyślną wartość Required.
Kliknij Edit > Project Settings > Player i wybierz kartę z Androidem .
W polu Other Settings > Identification wpisz Minimum API Level o wartości
24
lub wyższej.
iOS
Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit. Requirement ma domyślną wartość Required.
Kliknij Edit > Project Settings > Player i wybierz kartę z iOS .
W polu Other Settings > Configuration podaj Target minimum iOS Version.
Ustawianie aplikacji jako AR jako opcjonalnej
Android
Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore.
Z menu Requirement wybierz Optional. aby ustawić w aplikacji tryb AR jako opcjonalny.
Kliknij Edit > Project Settings > Player i wybierz kartę z Androidem .
W polu Other Settings > Identification wpisz Minimum API Level o wartości
24
lub wyższej.
iOS
Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit.
Z menu Requirement wybierz Optional. aby ustawić w aplikacji tryb AR (opcjonalnie).
Kliknij Edit > Project Settings > Player i wybierz kartę z iOS .
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?
- Dowiedz się, jak skonfigurować sesję ARCore.