Uruchamianie aplikacji AR w emulatorze Androida

Za pomocą emulatora Androida możesz testować scenariusze AR bez fizycznego urządzenia. Emulator Androida pozwala uruchamiać aplikacje ARCore w środowisku wirtualnym na emulowanym urządzeniu, którym sterujesz.

Konfigurowanie środowiska programistycznego

Wymagania dotyczące oprogramowania:

Pobierz Android Studio i narzędzia SDK dla ARCore

  1. Zainstaluj Android Studio w wersji 3.1 lub nowszej.

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

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

    Pod odpowiednią wersją Androida wybierz:
    Interfejsy Google APIs Intel x86 Atom System Image API poziomu 27 lub nowszego.

  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.

Utwórz nowe urządzenie wirtualne z Androidem

  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 profil sprzętu Telefon, a następnie wybierz Next.

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

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

    • Obsługiwane są tylko architektury emulatora Androida x86. Inne architektury, np. arm64-v8a i armeabi-v7, nie są obecnie obsługiwane.

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

    • Kliknij Show Advanced Settings.

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

  6. Kliknij Finish, aby utworzyć średni czas oglądania.

Uruchom aplikację

Przetestuj aplikację ARCore na urządzeniu wirtualnym z obsługą AR w emulatorze. Możesz to zrobić, postępując zgodnie z instrukcjami w Android Studio dotyczącymi 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 go zaktualizować:

  1. Pobierz najnowszą wersję Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk ze strony wersji w GitHubie.

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

    Uruchom odpowiedni program AVD, a następnie przeciągnij pobrany plik APK z folderu systemowego (np. Downloads) w uruchomionym emulatorze lub zainstaluj go za pomocą narzędzia adb, gdy urządzenie wirtualne jest uruchomione: 

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

Powtórz te kroki dla wszystkich dodatkowych formatów AVD, których chcesz użyć.

Sterowanie sceną wirtualną

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

Przesuwanie kamery wirtualnej

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

Działanie Co możesz 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
Zmień orientację urządzenia Przytrzymaj Shift i poruszaj 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 sekcji Rozszerzone elementy sterujące.

Dodawanie do sceny obrazów rozszerzonych

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

Na karcie Camera w usłudze Extended controls możesz dodawać i modyfikować elementy Scene images. Obrazy będą umieszczone w dwóch lokalizacjach: na ścianie, a drugie na stole.

Aby wyświetlić te lokalizacje obrazów w scenie, uruchom emulator, a następnie przenieś kamerę do jadalni w drzwiach, które znajdują się za pozycją początkową kamery.

Rozwiązywanie problemów

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

  • Jeśli aplikacja ARCore nie otwiera aparatu po uruchomieniu, sprawdź, czy zasada Camera Back ma wartość VirtualScene, zgodnie z opisem w krokach konfiguracji powyżej.

  • Jeśli nie udało się 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 komunikatem zawierającym słowo /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.