Uruchamianie aplikacji AR w emulatorze Androida

Użyj emulatora Androida, aby przetestować scenariusze AR bez fizycznego urządzenia. Emulator Androida pozwala uruchamiać aplikacje ARCore w środowisku wirtualnym z emulowanym urządzeniem, które kontrolujesz.

Konfigurowanie środowiska programistycznego

Wymagania dotyczące oprogramowania:

Pobierz narzędzia Android Studio i SDK dla ARCore

  1. Zainstaluj Android Studio 3.1 lub nowsze.

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

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

    W odpowiedniej wersji Androida wybierz:
    Interfejs API Google API Intel x86 Atom System Image API na poziomie 27 lub nowszym.

  4. Wybierz kartę SDK Tools i dodaj Android Emulator w wersji 27.2.9 lub nowszej.

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

  6. Ponownie kliknij OK, aby potwierdzić zmiany.

  7. Accept umowę licencyjną dotyczącą instalatora komponentów.

  8. Kliknij Finish.

Utwórz urządzenie wirtualne z obsługą AR

Więcej informacji znajdziesz w artykule Android Studio na temat tworzenia urządzenia wirtualnego.

Tworzenie nowego wirtualnego urządzenia z Androidem (AVD)

  1. W Android Studio otwórz Menedżera urządzeń, klikając Tools > Device Manager.

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

  3. Wybierz lub utwórz odpowiedni profil sprzętu Telefonu i wybierz Next.

  4. Wybierz obraz systemu x86 lub x86_64 z interfejsem API na poziomie 27 lub nowszym i wybierz Next.

    • Chociaż fizyczne urządzenia ARCore są obsługiwane przez interfejs API na poziomie 24 lub nowszym, emulator Androida wymaga interfejsu API na poziomie 27 lub nowszym.

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

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

    • Kliknij Show Advanced Settings.

    • Sprawdź, czy Camera Back ma wartość VirtualScene.

  6. Kliknij Finish, aby utworzyć średni plik.

Uruchom aplikację

przetestować aplikację ARCore na urządzeniu wirtualnym obsługującym AR w emulatorze, Aby to zrobić, postępuj zgodnie z instrukcjami uruchamiania aplikacji w emulatorze Androida.

Aktualizowanie Usług Google Play dla AR

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

  1. Pobierz najnowszą wersję Google_Play_Services_for_AR_1.38.0_x86_for_emulator.apk ze strony gier na GitHubie.

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

    Uruchom odpowiedni plik AVD, a następnie przeciągnij pobrany plik APK z folderu systemowego (tj. Downloads) do działającego emulatora lub zainstaluj go za pomocą adb, gdy urządzenie wirtualne jest uruchomione:

    adb install -r Google_Play_Services_for_AR_1.38.0_x86_for_emulator.apk

Powtórz te czynności dla każdego dodatkowego AVD, którego chcesz użyć.

Sterowanie sceną wirtualną

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

Przenoszenie aparatu wirtualnego

Naciśnij i przytrzymaj Shift, aby przejść do sterowania ruchem kamery. Aby przesuwać aparat, użyj tych elementów sterujących:

Działanie Co możesz zrobić
Przesuń w lewo lub w prawo Przytrzymując Shift + naciśnij A lub D
Przesuń w górę lub w górę Przytrzymując Shift + naciśnij Q lub E
W przód lub do tyłu Przytrzymując Shift + naciśnij W lub S
Zmienianie orientacji urządzenia Przytrzymaj Shift + przesuń mysz

Zwolnij Shift, aby wrócić do trybu interaktywnego w emulatorze.

Aby dokładniej określić położenie urządzenia, użyj karty Virtual Sensors w rozszerzonych elementach sterujących.

Dodaj do sceny obrazy rozszerzone

Aby przetestować obrazy rozszerzone, wczytaj obrazy do emulowanego środowiska emulatora.

Użyj karty Camera w aplikacji Extended controls, aby dodać lub zmodyfikować kartę Scene images. Dostępne są 2 lokalizacje obrazów – jedna na ścianie i jedna na stole.

Aby wyświetlić te ujęcia, włącz emulator, a potem przenieś kamerę na jadalnię w drzwiach za drzwiami początkowymi kamery.

Rozwiązywanie problemów

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

  • Jeśli po uruchomieniu aplikacji ARCore nie można uruchomić kamery, sprawdź, czy ustawienie Camera Back jest ustawione na VirtualScene, jak opisano w powyższych krokach konfiguracji.

  • Jeśli nie można otworzyć aplikacji ARCore z komunikatem o błędzie „Nie udało się utworzyć sesji AR”, sprawdź dziennik aplikacji. Jeśli znajdziesz plik java.lang.UnsatisfiedLinkError z wiadomością, która zawiera /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), być może masz zainstalowaną niewłaściwą wersję pakietu Usługi Google Play dla AR. Utwórz nowe urządzenie wirtualne i zainstaluj wersję x86.