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 AR | AR (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
Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore. Requirement ma domyślnie wartość Required.
Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną Androida.
W polu Other Settings > Identification podaj wartość Minimum API Level o wartości
24
lub większej.
iOS
Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit. Requirement ma domyślnie wartość Required.
Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną iOS.
W polu Other Settings > Configuration określ Target minimum iOS Version swojej aplikacji.
Ustawianie trybu AR w aplikacji jako opcjonalnej
Android
Wejdź na Edit > Project Settings > XR Plug-in Management > ARCore.
Z menu Requirement wybierz Optional, aby ustawić aplikację jako opcjonalną w rzeczywistości rozszerzonej.
Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną Androida.
W polu Other Settings > Identification podaj wartość Minimum API Level o wartości
24
lub większej.
iOS
Wejdź na Edit > Project Settings > XR Plug-in Management > ARKit.
W menu Requirement wybierz Optional, aby ustawić aplikację jako opcjonalną w AR.
Kliknij Edit > Project Settings > Player i wybierz kartę z ikoną iOS.
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?
- Dowiedz się, jak skonfigurować sesję ARCore.