Krótkie wprowadzenie do Androida

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

Otwieranie przykładowego projektu

  1. 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
  2. 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.

Szybkie miejsce docelowe

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.

Szybkie miejsce docelowe

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