Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.

Włącz ARCore

Na tej stronie opisano, jak włączyć funkcję ARCore w projektach Unity. Aby to zrobić, musisz:

  1. Zaimportuj ARCore SDK dla Unity
  2. Skonfiguruj aplikację tak, aby była Wymagana AR lub Opcjonalna AR
  3. Upewnij się, że Twoja aplikacja jest zgodna z wymaganiami prywatności użytkownika ARCore

Usługi Google Play dla AR

Zestawy SDK ARCore udostępniają funkcje AR na urządzeniach obsługujących ARCore z zainstalowanymi usługami Google Play dla AR (ARCore).

Usługi Google Play dla AR są automatycznie instalowane i aktualizowane na większości obsługiwanych urządzeń.

Przed rozpoczęciem sesji AR aplikacje muszą:

  1. Sprawdź, czy ARCore jest obsługiwany, wywołując CheckApkAvailability .
  2. Sprawdź, czy Usługi Google Play dla AR są zainstalowane i aktualne oraz czy zostały pobrane wymagane dane profilu urządzenia ARCore, wywołując Session.RequestApkInstallation(bool userRequested) .

Zaimportuj ARCore SDK dla Unity

Pobierz ARCore SDK dla Unity i zaimportuj go do swojego projektu, klikając menu Zasoby> Importuj pakiet> Pakiet niestandardowy . (Tylko Unity 2019 : aby naprawić błędy kompilacji, użyj Window> Package Manager, aby zainstalować pakiety Multiplayer HLAPI i XR Legacy Input Helpers .)

W oknie projektu Unity powinieneś zobaczyć zarówno pliki SDK, jak i przykładową aplikację HelloAR w Assets/GoogleARCore/Examples/HelloAR/ .

Skonfiguruj aplikację tak, aby była Wymagana AR lub Opcjonalna AR

Aplikację obsługującą funkcje AR można skonfigurować na dwa sposoby: AR Wymagane i Opcjonalne AR . Jeśli potrzebujesz pomocy w podjęciu decyzji, którą wybrać, zobacz Publikowanie aplikacji AR w sklepie Google Play .

AR Wymagane

Aby można było używać, aplikacja wymagająca AR wymaga urządzenia obsługującego ARCore z zainstalowanymi usługami Google Play dla AR .

  • Sklep Google Play sprawia, że ​​aplikacje wymagające AR są dostępne tylko na urządzeniach obsługujących ARCore .

  • Gdy użytkownicy instalują aplikację wymaganą przez AR, Sklep Google Play automatycznie instaluje Usługi Google Play dla AR . Jednak Twoja aplikacja musi nadal wykonywać dodatkowe testy w czasie wykonywania na wypadek konieczności zaktualizowania Usług Google Play dla AR lub ich ręcznego odinstalowania lub gdy dane profilu urządzenia ARCore są nieaktualne.

Aby uzyskać więcej informacji, zobacz Publikowanie aplikacji AR w sklepie Google Play .

Aby aplikacja była wymagana, upewnij się, że pozycja menu Edycja> Ustawienia projektu> ARCore> Wymagany ARCore jest zaznaczona, jak pokazano poniżej. Jest zaznaczone domyślnie.

Twoja aplikacja automatycznie przeprowadzi testy w czasie wykonywania, aby upewnić się, że urządzenie obsługuje ARCore i ma zainstalowane Usługi Google Play dla AR oraz że dane profilu urządzenia ARCore są aktualne. Jeśli Usługi Google Play dla AR nie są zainstalowane (prawdopodobnie dlatego, że zostały usunięte przez użytkownika) lub wersja jest zbyt stara, Twoja aplikacja poprosi użytkownika o zainstalowanie lub zaktualizowanie. Jeśli dane profilu urządzenia ARCore nie są aktualne, aplikacja pobierze je i zaktualizuje. Jeśli instalacja lub aktualizacja nie powiedzie się (prawdopodobnie z powodu awarii sieci), Session.Status zwróci błąd, a aplikacja powinna go obsłużyć i zakończyć.

AR Opcjonalne

Opcjonalna aplikacja AR ma opcjonalne funkcje AR, które są aktywowane tylko na urządzeniach z zainstalowanymi usługami Google Play dla AR .

  • AR Opcjonalne aplikacje można instalować i uruchamiać na urządzeniach, które nie obsługują ARCore.

  • Gdy użytkownicy zainstalują opcjonalną aplikację AR, Sklep Google Play nie zainstaluje automatycznie Usług Google Play dla AR wraz z aplikacją.

Aby ustawić aplikację jako opcjonalną, usuń zaznaczenie pozycji menu Edycja> Ustawienia projektu> ARCore> Wymagane ARCore .

Wykonaj testy w czasie wykonywania

Po uruchomieniu Twoja aplikacja musi wywołać Session.CheckApkAvailability() aby sprawdzić, czy urządzenie obsługuje ARCore, a jeśli tak, czy usługi Google Play dla AR i ARCore są zainstalowane i aktualne.

Twoja aplikacja powinna obsługiwać te warunki:

Stan: schorzenie Akcja
Urządzenie nie obsługuje ARCore. Ukrywa funkcje związane z AR.
Urządzenie obsługuje ARCore, ale usługi Google Play dla AR i / lub dane profilu urządzenia ARCore nie są zainstalowane lub nieaktualne. Monituje użytkownika o zainstalowanie lub zaktualizowanie Usług Google Play dla danych profilu urządzenia AR i / lub ARCore, wywołując Session.RequestApkInstallation() .
Urządzenie obsługuje ARCore i Usługi Google Play dla AR i dane profilu urządzenia ARCore są zainstalowane i aktualne. Tworzy Session ARCore i zaczyna używać ARCore.

Wymagania dotyczące prywatności użytkownika

Upewnij się, że Twoja aplikacja jest zgodna z wymaganiami prywatności użytkownika ARCore.

Następne kroki

Przeczytaj kod w przykładowej aplikacji i ARCore dla interfejsu API Unity .