Uruchamianie aplikacji AR w emulatorze Androida

Użyj Android Emulator, aby przetestować scenariusze AR bez fizycznego urządzenia. Emulator Androida umożliwia uruchamianie aplikacji ARCore w środowisku wirtualnym na emulowanym urządzeniu, które możesz kontrolować.

Konfigurowanie środowiska programistycznego

Wymagania dotyczące oprogramowania:

Pobieranie narzędzi Android Studio i SDK dla ARCore

  1. Zainstaluj Android Studio w wersji 3.1 lub nowszej.

  2. W Android Studio otwórz Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. Kliknij kartę SDK Platforms i zaznacz Show Package Details.

    W przypadku odpowiedniej wersji Androida wybierz:
    Interfejsy Google API dla obrazów systemu Intel x86 Atom – poziom interfejsu API 27 lub nowszy.

  4. Wybierz kartę SDK Tools i dodaj Android Emulator 27.2.9 lub nowszą.

  5. Aby zainstalować wybrane pakiety i narzędzia, kliknij OK.

  6. Aby potwierdzić zmiany, ponownie kliknij OK.

  7. Accept Umowa licencyjna dla Instalatora komponentów.

  8. Kliknij Finish.

Tworzenie urządzenia wirtualnego obsługującego AR

Więcej informacji znajdziesz w instrukcji Tworzenie urządzenia wirtualnego w Android Studio.

Tworzenie nowego urządzenia wirtualnego z Androidem (AVD)

  1. W Android Studio kliknij Tools > Device Manager, aby otworzyć Menedżera urządzeń.

  2. U góry panelu Menedżer urządzeń kliknij Create Device.

  3. Wybierz lub utwórz profil sprzętowy Telefon i kliknij Next.

  4. Wybierz obraz systemu x86 lub x86_64 z poziomem interfejsu API 27 lub nowszym i kliknij Next.

    • Chociaż fizyczne urządzenia ARCore są obsługiwane na poziomie interfejsu API 24 lub nowszym, obsługa emulatora Androida wymaga poziomu interfejsu API 27 lub nowszego.

    • Obsługiwane są tylko architektury emulatora Androida oparte na procesorach x86. Inne architektury, takie jak arm64-v8a czy armeabi-v7, nie są obecnie obsługiwane.

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

    • Kliknij Show Advanced Settings.

    • Upewnij się, że Camera Back ma wartość VirtualScene.

  6. Aby utworzyć AVD, kliknij Finish.

Uruchamianie aplikacji

przetestować aplikację ARCore na urządzeniu wirtualnym obsługującym AR w emulatorze; Aby to zrobić, wykonaj instrukcje dotyczące uruchamiania aplikacji w emulatorze Androida w Android Studio.

.

Aktualizowanie Usług Google Play dla AR

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

  1. Pobierz najnowszą wersję Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk ze strony wersji w GitHub.

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

    Uruchom wybrane urządzenie AVD, a potem przeciągnij pobrany plik APK z folderu systemowego (np. Downloads) na uruchomionym emulatorze lub zainstaluj go za pomocą adb, gdy wirtualne urządzenie jest uruchomione: 

    adb install -r Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk

Powtórz te czynności w przypadku wszystkich dodatkowych usług płatnych, których chcesz użyć.

Sterowanie wirtualną sceną

Gdy aplikacja połączy się z ARCore, zobaczysz nakładkę z opisem sposobu sterowania aparatem oraz pasek stanu pod oknem emulatora.

Przesuwanie wirtualnej kamery

Naciśnij i przytrzymaj Shift, aby uzyskać dostęp do elementów sterujących ruchem kamery. Aby przesuwać kamerę, użyj tych elementów sterujących:

Działanie Co zrobić
Przenieś w lewo lub w prawo. Przytrzymaj Shift i naciśnij A lub D
Przenieś w dół lub w górę Przytrzymaj Shift i naciśnij Q lub E
W przód lub do tyłu Przytrzymaj Shift i naciśnij W lub S.
Zmiana orientacji urządzenia Przytrzymaj Shift + porusz myszką

Puść przycisk Shift, aby wrócić do trybu interaktywnego w emulatorze.

Aby dokładniej ustawić urządzenie, użyj karty Virtual Sensors w sekcji Rozszerzone ustawienia.

Dodawanie obrazów rozszerzonej rzeczywistości do sceny

Załaduj obrazy do symulowanego środowiska emulatora, aby przetestować obrazy rozszerzonej rzeczywistości.

Aby dodać lub zmodyfikować Scene images, użyj karty Camera w sekcji Extended controls. Są 2 lokalizacje obrazów: jedna na ścianie, a druga na stole.

Aby wyświetlić te lokalizacje obrazów w scenie, uruchom emulator, a następnie przemieść kamerę do jadalni przez drzwi za początkową pozycją kamery.

Rozwiązywanie problemów

  • Jeśli po uruchomieniu aplikacji ARCore pojawi się komunikat „To urządzenie nie obsługuje AR”, sprawdź wersję pliku obrazu systemu. Upewnij się, że używasz poziomu interfejsu API 27 w wersji 4 lub nowszej.

  • Jeśli po uruchomieniu aplikacja ARCore nie otworzy aparatu, sprawdź, czy opcja Camera Back jest ustawiona na VirtualScene. Aby to zrobić, wykonaj powyższe czynności konfiguracyjne.

  • Jeśli aplikacja ARCore nie otwiera się i wyświetla komunikat o błędzie „Nie udało się utworzyć sesji AR”, sprawdź dziennik aplikacji. Jeśli znajdziesz java.lang.UnsatisfiedLinkError z komunikatem /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), być może masz zainstalowaną nieprawidłową wersję pliku APK Usług Google Play dla AR. Utwórz nowe urządzenie wirtualne i zainstaluj wersję x86.