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
Zainstaluj Android Studio w wersji 3.1 lub nowszej przy użyciu platformy Android SDK Platform w wersji 7.0 (poziom interfejsu API 24) lub nowszej.
Jeśli dopiero zaczynasz korzystać z Androida, przeczytaj artykuł Tworzenie pierwszej aplikacji na Androida.
Otwieranie przykładowego projektu
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
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.
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.
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
- Spróbuj utworzyć i uruchomić inne przykładowe projekty w pakiecie ARCore SDK.
- Więcej przykładowych aplikacji, które możesz tworzyć i uruchamiać, znajdziesz w Ćwiczeniach z rzeczywistości rozszerzonej.
- Dowiedz się, jak włączyć ARCore w aplikacji.
- Zapoznaj się z artykułem Uwagi o środowisku wykonawczym.
- Zapoznaj się z wytycznymi dotyczącymi projektowania.