Запускайте приложения дополненной реальности в эмуляторе Android

Используйте эмулятор Android для тестирования сценариев дополненной реальности без физического устройства. Эмулятор Android позволяет запускать приложения ARCore в виртуальной среде на эмулируемом устройстве, которым вы управляете.

Настройте среду разработки

Требования к программному обеспечению:

• Android Studio 3.1 или более поздней версии.

• Эмулятор Android 27.2.9 или более поздней версии.

Получите инструменты Android Studio и SDK для ARCore

1. Установите Android Studio 3.1 или более позднюю версию.

2. В Android Studio перейдите в Preferences > Appearance and Behavior > System Settings > Android SDK .

3. Выберите вкладку « SDK Platforms » и установите флажок « Show Package Details .

   Под соответствующей версией Android выберите:
   API-интерфейсы Google Intel x86 Atom System Image API уровня 27 или более поздней версии.

4. Выберите вкладку SDK Tools и добавьте Android Emulator 27.2.9 или более позднюю версию.

5. Нажмите OK , чтобы установить выбранные пакеты и инструменты.

6. Нажмите OK еще раз, чтобы подтвердить изменения.

7. Accept лицензионное соглашение для установщика компонентов.

8. Нажмите Finish .

Создайте виртуальное устройство с поддержкой AR

Дополнительные сведения см. в инструкциях Android Studio по созданию виртуального устройства .

Создайте новое виртуальное устройство Android (AVD)

1. В Android Studio откройте AVD Manager , щелкнув Tools > AVD Manager .

2. Нажмите « Create Virtual Device » в нижней части диалогового окна AVD Manager .

3. Выберите или создайте желаемый аппаратный профиль телефона и нажмите Next .

4. Выберите образ системы x86 или x86_64 с API уровня 27 или более поздней версии и нажмите Next .
   

   • В то время как физические устройства ARCore поддерживаются на уровне API 24 или выше, для поддержки эмулятора Android требуется API уровня 27 или выше.

   • Поддерживаются только архитектуры эмулятора Android на базе x86. Другие архитектуры, такие как arm64-v8a , armeabi-v7 , в настоящее время не поддерживаются.

5. Убедитесь, что ваше виртуальное устройство настроено правильно:

   • Щелкните Show Advanced Settings .

   • Убедитесь, что для Camera Back установлено значение VirtualScene .

6. Нажмите Finish , чтобы создать AVD.

Запустите свое приложение

Протестируйте приложение ARCore на виртуальном устройстве с поддержкой AR в эмуляторе. Для этого вы можете следовать инструкциям Android Studio, чтобы запустить приложение в эмуляторе Android .

Примечание. Чтобы запускать приложения с компонентами NDK в эмуляторе Android, ваше приложение должно быть создано с использованием ABI x86 . Пример см. в примере приложения ARCore HelloAR C.

Обновите сервисы Google Play для дополненной реальности

Версия сервисов Google Play для дополненной реальности на эмуляторе, скорее всего, устарела. Следуйте этим инструкциям, чтобы обновить его:

1. Загрузите последнюю версию Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk со страницы выпусков GitHub.

2. Установите загруженный APK в каждый AVD, который вы хотите использовать:

   Запустите нужный AVD, затем перетащите загруженный APK из вашей системной папки (например, Downloads ) на работающий эмулятор или установите его с помощью adb во время работы виртуального устройства:

   adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

Повторите эти шаги для любых дополнительных AVD, которые вы хотите использовать.

Управляйте виртуальной сценой

Когда ваше приложение подключается к ARCore, вы увидите наложение, описывающее, как управлять камерой, и строку состояния под окном эмулятора.

Переместить виртуальную камеру

Нажмите и удерживайте Option (macOS) или Alt (Linux или Windows), чтобы получить доступ к элементам управления движением камеры. Используйте следующие элементы управления для перемещения камеры:

Платформа	Действие	Что делать
macOS	Двигаться влево или вправо	Удерживайте Option + нажмите A или D
	Вниз или вверх	Удерживайте Option + нажмите Q или E
	Двигаться вперед или назад	Удерживайте Option + нажмите W или S
	Изменить ориентацию устройства	Удерживать Option + двигать мышь
линукс или винда	Двигаться влево или вправо	Удерживая Alt + нажмите A или D
	Вниз или вверх	Удерживая Alt + нажмите Q или E
	Двигаться вперед или назад	Удерживая Alt + нажмите W или S
	Изменить ориентацию устройства	Удерживая Alt + двигая мышь

Отпустите Option или Alt , чтобы вернуться в интерактивный режим в эмуляторе.

Используйте вкладку « Virtual Sensors » в расширенных элементах управления для более точного позиционирования устройства.

Добавьте в сцену дополненные изображения

Загрузите изображения в смоделированную среду эмулятора, чтобы протестировать дополненные изображения .

Используйте вкладку « Camera » в Extended controls для добавления или изменения Scene images . Есть два места для изображений, одно на стене и одно на столе.

Чтобы просмотреть эти местоположения изображений в сцене, запустите эмулятор, затем переместите камеру в столовую через дверь за исходной позицией камеры.

Советы по устранению неполадок

• Если ваше приложение ARCore запускается и вы видите сообщение «Это устройство не поддерживает AR», проверьте версию образа вашей системы. Убедитесь, что вы используете API уровня 27 версии 4 или выше .

• Если вашему приложению ARCore не удается открыть камеру при запуске, убедитесь, что для параметра Camera Back установлено значение VirtualScene , как описано в шагах настройки выше .

• Если ваше приложение ARCore не открывается с сообщением об ошибке «Не удалось создать сеанс AR», проверьте журнал приложения. Если вы обнаружите ошибку java.lang.UnsatisfiedLinkError с сообщением, содержащим /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) , возможно, вы установили неправильную версию Служб Google Play для AR . apk Создайте новое виртуальное устройство и установите версию x86.