Uruchamianie aplikacji AR w emulatorze Androida

Do testowania scenariuszy AR bez fizycznego urządzenia używaj emulatora Androida. Emulator Androida pozwala uruchamiać aplikacje ARCore w środowisku wirtualnym na emulowanym urządzeniu, nad którym pracujesz.

Konfigurowanie środowiska programistycznego

Wymagania dotyczące oprogramowania:

Pobierz Android Studio i narzędzia SDK dla ARCore

  1. Zainstaluj Android Studio 3.1 lub nowszą wersję.

  2. W Android Studio przejdź do Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. Wybierz kartę SDK Platforms i sprawdź Show Package Details.

    W odpowiedniej wersji Androida wybierz:
    Interfejsy Google APIs 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ą na instalatora komponentów.

  8. Kliknij Finish.

Tworzenie urządzenia wirtualnego z obsługą AR

Więcej informacji znajdziesz w instrukcjach tworzenia urządzenia wirtualnego w Android Studio.

Tworzenie nowego urządzenia wirtualnego z Androidem (AVD)

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

  2. Kliknij Create Device u góry panelu Menedżer urządzeń.

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

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

    • Fizyczne urządzenia ARCore są obsługiwane na poziomie API 24 lub nowszym, ale obsługa emulatora Androida wymaga interfejsu API na poziomie 27 lub nowszym.

    • Obsługiwane są tylko architektury emulatora Androida oparte na procesorach x86. Inne architektury, takie jak arm64-v8a i 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 czas oglądania.

Uruchamianie aplikacji

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

Zaktualizuj Usługi Google Play dla AR

Wersja Usług Google Play dla AR w emulatorze jest prawdopodobnie nieaktualna. Aby go zaktualizować, wykonaj następujące czynności:

  1. Pobierz najnowszy plik Google_Play_Services_for_AR_1.44.0_x86_for_emulator.apk ze strony wersji w GitHubie.

  2. Zainstaluj pobrany plik APK na każdym urządzeniu AVD, którego chcesz użyć:

    Uruchom program AVD, a następnie przeciągnij pobrany plik APK z folderu systemowego (np. Downloads) do uruchomionego emulatora lub zainstaluj go za pomocą adb, gdy urządzenie wirtualne jest uruchomione:

    adb install -r Google_Play_Services_for_AR_1.44.0_x86_for_emulator.apk

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

Sterowanie sceną wirtualną

Gdy aplikacja połączy się z ARCore, pod oknem emulatora pojawi się nakładka opisująca, jak sterować kamerą, oraz pasek stanu.

Przesuń kamerę wirtualną

Naciśnij i przytrzymaj Shift, aby uzyskać dostęp do elementów sterujących ruchem aparatu. Poruszaj kamerą, korzystając z tych elementów sterujących:

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

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

Aby dokładniej pozycjonować urządzenie, użyj karty Virtual Sensors w sekcji Zaawansowane elementy sterujące.

Dodawanie obrazów rozszerzonych do sceny

Wczytuj obrazy do symulowanego środowiska emulatora, aby przetestować obrazy rozszerzone.

Aby dodać lub zmodyfikować Scene images, użyj karty Camera w usłudze Extended controls. Masz 2 lokalizacje zdjęć – jedną na ścianie, a drugą na stole.

Aby zobaczyć lokalizacje tych obrazów na scenie, uruchom emulator, a potem przenieś kamerę do jadalni za pomocą pozycji początkowej.

Rozwiązywanie problemów

  • Jeśli po uruchomieniu aplikacji ARCore pojawi się komunikat „To urządzenie nie obsługuje AR”, sprawdź wersję w obrazie systemu. Sprawdź, czy korzystasz z wersji 4 interfejsu API poziomu 27 lub nowszej.

  • Jeśli Twoja aplikacja ARCore nie uruchomi aparatu po uruchomieniu, sprawdź, czy opcja Camera Back jest ustawiona na VirtualScene, w sposób opisany w krokach konfiguracji powyżej.

  • Jeśli nie uda się otworzyć aplikacji ARCore i wyświetli się komunikat o błędzie „Nie udało się utworzyć sesji AR”, sprawdź dziennik aplikacji. Jeśli znajdziesz plik java.lang.UnsatisfiedLinkError z komunikatem zawierającym /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 APK Usług Google Play dla AR. Utwórz nowe urządzenie wirtualne i zainstaluj wersję x86.