Aby rozpocząć korzystanie z ARCore na Androidzie, możesz uruchomić przykładową aplikację hello_ar_kotlin lub hello_ar_java załączoną w pakiecie SDK ARCore. Te przykładowe aplikacje korzystają z OpenGL – interfejsu programowania do renderowania grafiki wektorowej 2D i 3D. Aplikacje wyświetlają wszystkie wykryte samoloty, a użytkownik może dotknąć samolotu, aby umieścić model 3D.
Konfigurowanie środowiska programistycznego
Zainstaluj Android Studio w wersji 3.1 lub nowszej z pakietem Android SDK Platform w wersji 7.0 (poziom interfejsu API 24) lub nowszym.
Jeśli dopiero zaczynasz korzystać z Androida, zapoznaj się z artykułem Tworzenie pierwszej aplikacji na Androida.
Otwieranie przykładowego projektu
W Android Studio skopiuj repozytorium ARCore SDK na GitHubie.
Możesz to zrobić na kilka sposobów:
W przypadku istniejącej instalacji Android Studio:
- Z menu Git wybierz Clone.
- Z menu Version control wybierz Git jako system kontroli wersji.
W polu URL wpisz ten adres URL repozytorium ARCore GitHub:
https://github.com/google-ar/arcore-android-sdk.git
Możesz też otworzyć plik Terminal i wykonać polecenie
git clone
w ten sposób:git clone https://github.com/google-ar/arcore-android-sdk.git
Otwórz jeden z przykładowych projektów w ten sposób (aby skompilować i uruchomić projekt, musisz go otworzyć bezpośrednio).
- Z menu File wybierz Open.
- W folderze arcore-android-sdk/samples wybierz folder hello_ar_kotlin lub hello_ar_java i kliknij Open.
Przygotowanie urządzenia lub emulatora
Aplikacje AR możesz uruchomić na obsługiwanym urządzeniu lub w emulatorze Androida. Przed uruchomieniem aplikacji musisz zaktualizować Usługi Google Play dla AR w emulatorze. Więcej informacji znajdziesz w artykule Uruchamianie aplikacji AR w emulatorze Androida .
Uruchamianie przykładu
Upewnij się, że urządzenie z Androidem jest połączone z komputerem, a następnie kliknij Run w Android Studio.
Android Studio kompiluje projekt do możliwego do debugowania pliku APK, instaluje go i uruchamia aplikację na urządzeniu. Więcej informacji znajdziesz w artykule o tworzeniu i uruchamianiu aplikacji.
Możesz otrzymać prośbę o zainstalowanie lub zaktualizowanie Usług Google Play dla AR, jeśli ich brakuje lub są nieaktualne. Wybierz CONTINUE, aby zainstalować tę aplikację ze Sklepu Google Play, lub zaktualizować ją ręcznie zgodnie z opisem w artykule Aktualizowanie Usług Google Play dla AR.
Aplikacja hello_ar_java umożliwia umieszczenie trójwymiarowego zastawu ARCore na wykrytych powierzchniach AR. Jest zaimplementowany za pomocą interfejsu Android GL SurfaceView, który służy do renderowania podglądu z kamery i podstawowych obiektów AR, takich jak Planes i Anchors. Przykładową platformę renderowania hello_ar_java znajdziesz w com/google/ar/core/examples/java/common/samplerender
.
Użyj błyskawicznego miejsca docelowego
Interfejs Instant Placement API pozwala umieścić obiekt AR na ekranie bez konieczności czekania, aż ARCore wykryje geometrię powierzchni. Pozycja obiektu jest udoskonalana w czasie rzeczywistym, w miarę jak użytkownik porusza się dalej w środowisku.
Kliknij ekran, aby umieścić obiekt. Po zobaczeniu na ekranie pojawienia się obiektu holograficznego nadal poruszaj się urządzeniem, aby aplikacja ARCore mogła uzyskać wystarczającą ilość danych o otoczeniu, aby dokładnie zakotwiczyć wirtualny obiekt.
Gdy ARCore wykryje geometrię powierzchni i utworzy możliwość śledzenia w regionie, w którym znajduje się obiekt, jego położenie jest automatycznie aktualizowane pod kątem dokładności.
Na Rysunku 1 błyskawiczne miejsce docelowe jest wyłączone, a geometria powierzchni jest niezdefiniowana. Przedmioty umieszczone na podłodze na prawo od stołu (4 małe niebieskie kropki) są przewracane, a ich pozycje są nieokreślone.
Na ilustracji 2 ta funkcja jest włączona w menu wyświetlanym po kliknięciu ikony koła zębatego.
Na Rysunku 3, gdy włączone jest dynamiczne umieszczanie w witrynie, w scenie umieszczany jest nowy obiekt. Wyświetlana jest w skali szarości, a nie w kolorze, co oznacza, że nie została jeszcze poprawiona z prawidłową pozycją.
Na Rysunku 4 nowy obiekt staje się kolorowy, a jego pozycja jest dokładna, gdy zostaje wykryta geometria powierzchni (opisana przez linie siatki możliwe do śledzenia).
Użyj głębi
Gdy włączona jest opcja Głębokość, ARCore bierze pod uwagę geometrię i lokalizację obiektów w scenie oraz oblicza ich położenie względem pozostałych obiektów. Umożliwia to zasłanianie umieszczonych obiektów przez obiekty w scenie, co zwiększa realizm aplikacji.
Na Rysunku 1 Głębia jest wyłączona. Obiekt jest umieszczany pod tabelą bilardową.
Na ilustracji 2. gdy urządzenie porusza się po stole bilardowym, obiekt wydaje się podążać za urządzeniem niezależnie od znajdujących się na nim obiektów.
Na ilustracji 3 funkcja Głębia jest włączona.
Na Rysunku 4 obiekt jest obecnie zasłaniany przez stół bilardowy, w miarę jak urządzenie porusza się po scenie.
Dalsze kroki
- Utwórz i uruchom inne przykładowe projekty w pakiecie ARCore SDK.
- Zajrzyj do ćwiczeń z programowania w rzeczywistości rozszerzonej, w których znajdziesz więcej przykładowych aplikacji, które możesz tworzyć i uruchamiać.
- Dowiedz się, jak włączyć ARCore w swojej aplikacji.
- Zapoznaj się z artykułem Uwagi na temat środowiska wykonawczego.
- Zapoznaj się ze wskazówkami dotyczącymi projektowania.