Uruchom aplikacje AR w emulatorze Androida

Użyj Android Emulator do scenariuszy testowych AR bez fizycznego urządzenia. Emulator systemu Android umożliwia uruchamianie aplikacji ARCore w środowisku wirtualnym za pomocą emulowanego urządzenia, którym sterujesz.

Skonfiguruj swoje środowisko programistyczne

Wymagania Systemowe:

Pobierz Android Studio i narzędzia SDK dla ARCore

  1. Zainstalować Android Studio 3.1 lub nowszy.

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

  3. Wybór SDK Platforms kartę i sprawdź Show Package Details .

    Pod odpowiednią wersją Androida wybierz:
    Google API Intel x86 Atom systemu API Obraz Level 27 lub później.

  4. Wybierz SDK Tools kartę i dodać Android Emulator 27.2.9 lub nowszej.

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

  6. Kliknij OK ponownie, aby zmiany zatwierdzić.

  7. Accept umowę licencyjną dla instalatora komponentu.

  8. Kliknij Finish .

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

Aby uzyskać więcej informacji, zobacz instrukcje Android Studio do Tworzenie wirtualnego urządzenia .

Utwórz nowe urządzenie wirtualne z systemem Android (AVD)

  1. W Android Studio otworzyć AVD Manager, klikając Tools > AVD Manager .

  2. Kliknij Create Virtual Device , w dolnej części okna dialogowego AVD Manager.

  3. Wybrać lub utworzyć pożądany profil sprzętowy telefonu i wybierz Next .

  4. Wybierz x86 lub x86_64 obraz systemu z systemem API poziom 27 lub nowszej, a następnie wybierz Next .

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

    • Obsługiwane są tylko architektury emulatorów systemu Android oparte na architekturze x86. Inne architektury takie jak arm64-v8a , armeabi-v7 , nie są obecnie obsługiwane.

  5. Sprawdź, czy urządzenie wirtualne jest poprawnie skonfigurowane:

    • Kliknij Show Advanced Settings .

    • Upewnij się, że Camera Back jest ustawiony na VirtualScene .

  6. Kliknij Finish , aby utworzyć AVD.

Uruchom swoją aplikację

Przetestuj aplikację ARCore na urządzeniu wirtualnym z obsługą AR w emulatorze. Aby to zrobić, można postępować zgodnie z instrukcjami Android studia, aby uruchomić aplikację w Android Emulator .

Zaktualizuj Usługi Google Play dla AR

Wersja Usług Google Play dla AR na emulatorze jest prawdopodobnie nieaktualna. Postępuj zgodnie z tymi instrukcjami, aby go zaktualizować:

  1. Pobierz najnowszą Google_Play_Services_for_AR_1.28.0_x86_for_emulator.apk z GitHub uwalnia stronie.

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

    Zacznij żądaną AVD, a następnie przeciągnij pobrany plik APK z folderu systemowego (tj Downloads ) na uruchomionym emulatorze lub zainstalować go przy użyciu adb gdy urządzenie wirtualna jest uruchomiona:

    adb install -r Google_Play_Services_for_AR_1.28.0_x86_for_emulator.apk

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

Kontroluj wirtualną scenę

Gdy Twoja aplikacja połączy się z ARCore, zobaczysz nakładkę opisującą sposób sterowania kamerą oraz pasek stanu pod oknem emulatora.

Przesuń wirtualną kamerę

Naciśnij i przytrzymaj Option (MacOS) lub Alt (Linux lub Windows) do kontroli ruchu kamery dostępu. Użyj następujących elementów sterujących, aby poruszać kamerą:

Platforma Akcja Co robić
System operacyjny Mac Przesuń w lewo lub w prawo Przytrzymaj Option + naciśnij A lub D
Przesuń w dół lub w górę Chwyt Option klawisz Q lub E
Przejdź do przodu lub do tyłu Chwyt Option naciśnij W lub S
Zmień orientację urządzenia Opcja hold + mysz ruch
Linux lub Windows Przesuń w lewo lub w prawo Przytrzymaj Alt + D Naciśnij a lub
Przesuń w dół lub w górę Trzymając Alt-Q lub E nacisnąć
Przejdź do przodu lub do tyłu Chwyt Alt naciśnij W lub S
Zmień orientację urządzenia Przytrzymaj Alt + ruch myszą

Zwolnić Option lub Alt , aby powrócić do trybu interaktywnego w emulatorze.

Użyj Virtual Sensors kartę w rozszerzonych kontroli dla bardziej precyzyjnego pozycjonowania urządzenia.

Dodaj rozszerzone obrazy do sceny

Załaduj zdjęcia do emulatora symulowane środowisko testowe Augmented obrazy .

Użyj Camera kartę w Extended controls , aby dodać lub modyfikować Scene images . Istnieją dwie lokalizacje obrazów, jedna na ścianie i jedna na stole.

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

Wskazówki dotyczące rozwiązywania problemów

  • Jeśli Twoja aplikacja ARCore uruchomi się i zobaczysz komunikat „To urządzenie nie obsługuje AR”, sprawdź wersję na obrazie systemu. Upewnij się, że używasz API poziom 27 wersja 4 lub nowsza.

  • Jeśli Twoja aplikacja ARCORE nie otwiera się, gdy aparat uruchamia się upewnić, że Camera Back jest ustawiony na VirtualScene , w sposób opisany w krokach konfiguracyjnych powyżej .

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