Krótkie wprowadzenie do Androida

Aby zacząć korzystać z ARCore w Androidzie, możesz uruchomić przykładową aplikację hello_ar_kotlin lub hello_ar_java dołączoną do pakietu SDK ARCore. Te przykładowe aplikacje korzystają z OpenGL, czyli interfejsu programistycznego do renderowania grafiki wektorowej 2D i 3D. Aplikacje wyświetlają wszystkie wykryte samoloty i umożliwiają użytkownikowi dotknięcie samolotu, aby umieścić model 3D.

Konfigurowanie środowiska programistycznego

Otwieranie przykładowego projektu

  1. W Android Studio skopiuj repozytorium ARCore SDK GitHub.

    Możesz to zrobić na kilka sposobów:

    • Jeśli masz już zainstalowaną aplikację Android Studio:

      • W menu Git wybierz Clone.
      • W 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 (w języku angielskim)

    • Możesz też otworzyć Terminal i wydać 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 (musisz go jednoznacznie otworzyć, aby go utworzyć i uruchomić).

    • W menu File wybierz Open.
    • W folderze arcore-android-sdk/samples wybierz folder hello_ar_kotlin lub hello_ar_java i kliknij Open.

Przygotowywanie urządzenia lub emulatora

Aplikacje AR możesz uruchamiać na obsługiwanym urządzeniu lub w emulatorze Androida. Zanim uruchomisz aplikację, musisz zaktualizować Usługi Google Play dla AR w emulatorze. Więcej informacji znajdziesz w artykule Uruchamianie AR w emulatorze Androida .

Uruchom przykład

Upewnij się, że Twoje urządzenie z Androidem jest podłączone do komputera, z którego korzystasz, i kliknij Run w Android Studio.

Android Studio utworzy projekt w pliku APK z możliwością debugowania, zainstaluje plik, a następnie uruchomi aplikację na urządzeniu. Więcej informacji znajdziesz w artykule Tworzenie i uruchamianie aplikacji.

Jeśli nie ma jej lub jest nieaktualna, możesz zobaczyć prośbę o zainstalowanie lub zaktualizowanie Usług Google Play dla AR. Wybierz CONTINUE, aby zainstalować aplikację ze Sklepu Google Play, lub zaktualizuj ją ręcznie w sposób opisany w artykule Aktualizowanie Usług Google Play dla AR.

Aplikacja hello_ar_java pozwala umieścić trójwymiarowy zastaw ARCore na wykrytych powierzchniach AR. Jest ona zaimplementowana za pomocą Android GL SurfaceView, która służy do renderowania podglądu kamery i podstawowych obiektów AR, takich jak samoloty i zakotwiczenia. Przykładową platformę renderowania hello_ar_java znajdziesz w com/google/ar/core/examples/java/common/samplerender.

Użyj błyskawicznego miejsca docelowego

Interfejs Default Placement API pozwala użytkownikowi umieścić obiekt AR na ekranie bez konieczności czekania, aż ARCore wykryje geometrię powierzchni. Rozmieszczanie obiektów jest dopracowywane w czasie rzeczywistym, gdy użytkownik porusza się dalej po środowisku.

Dotknij ekranu, aby umieścić obiekt. Pamiętaj, aby nadal obserwować urządzenie na ekranie.

Gdy ARCore wykryje geometrię powierzchni i ustawi śledzenie w regionie, w którym znajduje się obiekt, położenie obiektu jest aktualizowane automatycznie pod kątem dokładności.

Szybkie miejsce docelowe

Na rysunku 1 natychmiastowe miejsce docelowe jest wyłączone, a geometria powierzchni jest niezdefiniowana. Obiekty umieszczone na podłodze po prawej stronie tabeli bilardowej (4 niewielkie niebieskie kropki) wyglądają na wygięte, ustawione pozycje są niezdefiniowane.

Na rysunku 2 opcja Natychmiastowe miejsce docelowe jest włączona w menu pod ikoną koła zębatego.

Na rysunku 3 po włączeniu funkcji dynamicznego miejsca docelowego w scenie pojawia się nowy obiekt. Jest ona wyświetlana w skali szarości zamiast w kolorze, co wskazuje, że nie została jeszcze poprawiona pod kątem prawidłowej pozycji.

Na rysunku 4 nowy obiekt zostaje kolorowany, a jego pozycja jest prawidłowa, gdy zostanie wykryta geometria powierzchni (zgodnie z liniami śledzącej).

Użyj głębokości

Gdy funkcja Głębokość jest włączona, ARCore uwzględnia geometrię i lokalizację obiektów w scenie i oblicza położenie obiektów w scenie względem innych obiektów w scenie. Umożliwia zasłanianie obiektów przez obiekty w scenie, co zwiększa realizm aplikacji.

Szybkie miejsce docelowe

Na rysunku 1 głębokość jest wyłączona. Obiekt znajduje się pod tabelą puli.

Na rysunku 2 urządzenie porusza się po tabeli puli, więc obiekt ten przylega do urządzenia niezależnie od obiektów w danej scenie.

Na rysunku 3 włączona jest głębokość.

Na rysunku 4 obiekt jest teraz pusty przez tabelę bilardową, gdy urządzenie porusza się po scenie.

Dalsze kroki