Uruchamianie aplikacji Sceneform w emulatorze Androida

Użyj emulatora Androida, aby przetestować scenariusze AR bez fizycznego urządzenia. Emulator Androida umożliwia uruchamianie aplikacji ARCore w środowisku wirtualnym z sterowanym emulacją urządzenia.

Skonfiguruj środowisko programistyczne

Wymagania dotyczące oprogramowania:

Wymagania sprzętowe:

  • Do korzystania z aplikacji Sceneform w aplikacji potrzebny jest też programista obsługujący OpenGL ES 3.0 lub wyższy.

Pobierz narzędzia Android Studio i SDK do ARCore

  1. Zainstaluj Android Studio w wersji 3.1 lub nowszej.

  2. W Android Studio otwórz Preferencje i ustawienia; > Ustawienia systemu & Android SDK.

  3. Wybierz kartę Platformy SDK i zaznacz Pokaż szczegóły pakietu.

    W sekcji Android 8.1 (Oreo) wybierz:
    Google APIs Intel x86 Atom System Image API na poziomie 27, wersja 4 lub nowsza.

  4. Wybierz kartę Narzędzia SDK i dodaj emulator Androida 27.2.9 lub nowszy.

  5. Kliknij OK, by zainstalować wybrane pakiety i narzędzia.

  6. Ponownie kliknij OK, by potwierdzić zmiany.

  7. Zaakceptuj umowę licencyjną na instalator komponentu.

  8. Kliknij Zakończ

Tworzenie urządzenia wirtualnego z obsługą AR

Postępuj zgodnie z instrukcjami w Android Studio, aby utworzyć urządzenie wirtualne z obsługą AR.

Skonfiguruj urządzenie wirtualne

  • Wybierz profil sprzętu Pixel lub Pixel 2.
  • Wybierz obraz systemu Oreo: API Level 27: x86: Android 8.1 (Google APIs).

  • Sprawdź, czy urządzenie wirtualne jest prawidłowo skonfigurowane:

    • Otwórz Sprawdź konfigurację > Pokaż ustawienia zaawansowane.
    • Ustaw Aparat tylny na VirtualScene.

Konfigurowanie emulatora pod kątem obsługi Sceneform

Sceneform wymaga systemu OpenGL ES 3.0 lub nowszego.

  1. Sprawdź, czy emulator jest skonfigurowany do używania najnowszej wersji OpenGL ES:

    • Kliknij Więcej na pasku narzędzi emulatora i...
    • Wybierz Settings > Advanced > OpenGL ES API level > Renderer max (do OpenGL OpenGL ES 3.1).
    • Uruchom ponownie emulator. Gdy pojawi się komunikat, nie zapisuj bieżącego stanu.

  2. Po ponownym uruchomieniu emulatora przez krótki czas przeprowadź emulację, a następnie sprawdź, czy używany jest interfejs OpenGL ES 3.0 lub nowszy:

    adb logcat | grep eglMakeCurrent

    Jeśli widzisz wersję ver 3 0 lub wyższą, możesz uruchomić aplikacje Sceneform w emulatorze: 

    … …  …  … D EGL_emulation: eglMakeCurrent: 0xebe63540: ver 3 0 (tinfo 0xd104cb40)

    Jeśli widzisz starszą wersję, oznacza to, że komputerowy GPU nie obsługuje OpenGL ES 3.0. Aby uruchamiać aplikacje Sceneform, musisz użyć fizycznego obsługiwanego urządzenia.

Uruchamianie aplikacji

Przetestuj aplikację ARCore na urządzeniu wirtualnym obsługującym tę technologię w emulatorze. Aby to zrobić, wykonaj instrukcje podane w Android Studio, aby uruchomić aplikację w emulatorze Androida.

Aktualizowanie Usług Google Play dla AR

Wersja Usług Google Play dla AR w emulatorze prawdopodobnie jest nieaktualna. Aby ją zaktualizować, wykonaj te czynności:

  1. Najnowszy plik Google_Play_Services_for_AR_1.15.0_x86_for_emulator.apk pobierz ze strony Wersje GitHuba.

  2. Zainstaluj pobrany plik APK w każdym pliku AVD, którego chcesz używać:

    Uruchom odpowiedni plik AVD, a następnie przeciągnij pobrany pakiet APK do działającego emulatora lub zainstaluj go, korzystając z pakietu adb, gdy urządzenie wirtualne jest uruchomione: 

    adb install -r Google_Play_Services_for_AR_1.15.0_x86_for_emulator.apk

Powtórz te kroki dla wszystkich dodatkowych urządzeń AVD, których chcesz używać.

Sterowanie sceną wirtualną

Gdy aplikacja połączy się z ARCore, zobaczysz nakładkę z informacjami o tym, jak sterować kamerą i pasek stanu pod oknem emulatora.

Przenoszenie kamery wirtualnej

Naciśnij i przytrzymaj Option (macOS) lub Alt (Linux lub Windows), aby uzyskać dostęp do elementów sterujących ruchem kamery. Aby poruszać kamerą, użyj tych elementów sterujących:

Platforma Działanie Co należy zrobić
macOS Przesuń w lewo lub w prawo Naciśnij Opcja + A lub D
Przesuń w dół lub w górę Przytrzymaj Option + Q lub E
W przód lub do tyłu Przytrzymaj Option + W lub S
Zmienianie orientacji urządzenia Przytrzymaj Opcja + przesuń mysz
Linux lub Windows Przesuń w lewo lub w prawo Naciśnij Alt + A lub D
Przesuń w dół lub w górę Przytrzymaj Alt + Q lub E
W przód lub do tyłu Przytrzymując Alt + W lub S
Zmienianie orientacji urządzenia Przytrzymaj Alt + ruch myszy

Naciśnij Option lub Alt, aby wrócić do trybu interaktywnego w emulatorze.

Aby dokładniej określić położenie urządzenia, użyj karty Czujniki wirtualne w Rozszerzonym ustawieniu.

Rozwiązywanie problemów

  • Jeśli po uruchomieniu aplikacji ARCore pojawi się komunikat „&Ryt. AR Core nieobsługiwany”, sprawdź wersję na obrazie systemu. Upewnij się, że używasz interfejsu API na poziomie 27, wersja 4.

  • Jeśli po uruchomieniu aplikacji ARCore nie może otworzyć aparatu, ustaw wartość parametru Kamera z powrotem na VirtualScene zgodnie z opisem w powyższych krokach konfiguracji.