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

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

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

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

Получите инструменты 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 API 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 откройте Диспетчер устройств , нажав Tools > Device Manager .

  2. Нажмите Create Device в верхней части панели «Диспетчер устройств» .

  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 .

Обновите сервисы Google Play для AR

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk

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

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

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

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

Нажмите и удерживайте Shift , чтобы получить доступ к элементам управления движением камеры. Для перемещения камеры используйте следующие элементы управления:

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

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

Используйте вкладку 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.

,

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

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

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

Получите инструменты 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 API 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 откройте Диспетчер устройств , нажав Tools > Device Manager .

  2. Нажмите Create Device в верхней части панели «Диспетчер устройств» .

  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 .

Обновите сервисы Google Play для AR

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk

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

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

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

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

Нажмите и удерживайте Shift , чтобы получить доступ к элементам управления движением камеры. Для перемещения камеры используйте следующие элементы управления:

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

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

Используйте вкладку 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.