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:
Android Studio 3.1 lub nowszy
Emulator Androida 27.2.9 lub nowszy.
Pobierz Android Studio i narzędzia SDK dla ARCore
Zainstaluj Android Studio 3.1 lub nowszą wersję.
W Android Studio przejdź do Preferences > Appearance and Behavior > System Settings > Android SDK.
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.Wybierz kartę SDK Tools i dodaj Android Emulator w wersji 27.2.9 lub nowszej.
Kliknij OK, aby zainstalować wybrane pakiety i narzędzia.
Ponownie kliknij OK, aby potwierdzić zmiany.
Accept umowę licencyjną na instalatora komponentów.
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)
W Android Studio otwórz Menedżera urządzeń, klikając Tools > Device Manager.
Kliknij Create Device u góry panelu Menedżer urządzeń.
Wybierz lub utwórz odpowiedni profil sprzętowy telefonu i kliknij Next.
Wybierz obraz systemu
x86
lubx86_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
iarmeabi-v7
, nie są obecnie obsługiwane.
Sprawdź, czy urządzenie wirtualne jest prawidłowo skonfigurowane:
Kliknij Show Advanced Settings.
Sprawdź, czy Camera Back ma wartość VirtualScene.
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:
Pobierz najnowszy plik Google_Play_Services_for_AR_1.44.0_x86_for_emulator.apk ze strony wersji w GitHubie.
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.