Usa Android Emulator para probar situaciones de RA sin un dispositivo físico. Android Emulator te permite ejecutar apps de ARCore en un entorno virtual con un dispositivo emulado que controlas.
Configure el entorno de desarrollo
Requisitos de software:
Android Studio 3.1 o una versión posterior
Android Emulator 27.2.9 o versiones posteriores.
Cómo obtener Android Studio y herramientas del SDK para ARCore
Instala Android Studio 3.1 o una versión posterior.
En Android Studio, ve a Preferences > Appearance and Behavior > System Settings > Android SDK.
Selecciona la pestaña SDK Platforms y marca la casilla Show Package Details.
En la versión de Android adecuada, selecciona:
Google API Intel x86 Atom System Image nivel de API 27 o versiones posteriores.Selecciona la pestaña SDK Tools y agrega Android Emulator 27.2.9 o una versión posterior.
Haz clic en OK para instalar los paquetes y las herramientas seleccionados.
Vuelve a hacer clic en OK para confirmar los cambios.
Accept el contrato de licencia para el instalador de componentes
Haz clic en Finish.
Cómo crear un dispositivo virtual compatible con RA
Para obtener más información, consulta las instrucciones de Android Studio sobre cómo crear un dispositivo virtual.
Cómo crear un nuevo dispositivo virtual de Android (AVD)
En Android Studio, haz clic en Tools > AVD Manager para abrir el Administrador de AVD.
Haz clic en Create Virtual Device, en la parte inferior del diálogo AVD Manager.
Selecciona o crea el perfil de hardware de Teléfono que deseas y selecciona Next.
Selecciona una imagen del sistema
x86
ox86_64
que ejecute API nivel 27 o posterior y, luego, Next.Si bien los dispositivos físicos de ARCore son compatibles con el nivel de API 24 o posterior, la compatibilidad de Android Emulator requiere el nivel de API 27 o posterior.
Solo se admiten las arquitecturas de Android Emulator basadas en x86. En este momento, no se admiten otras arquitecturas, como
arm64-v8a
yarmeabi-v7
.
Verifica que tu dispositivo virtual esté configurado correctamente:
Haz clic en Show Advanced Settings.
Asegúrate de que Camera Back esté configurado como VirtualScene.
Haz clic en Finish para crear el AVD.
Cómo ejecutar tu app
Prueba una app de ARCore en un dispositivo virtual compatible con RA en el emulador. Para ello, puedes seguir las instrucciones de Android Studio sobre Cómo ejecutar una app en Android Emulator.
Actualiza Servicios de Google Play para RA
Es probable que la versión de Servicios de Google Play para RA en el emulador esté desactualizada. Sigue estas instrucciones para actualizarla:
Descarga las versiones más recientes de Google_Play_Services_for_AR_1.31.0_x86_for_emulator.apk desde la página de versiones de GitHub.
Instala el APK descargado en cada AVD que quieras usar:
Inicia el AVD deseado y, luego, arrastra el APK descargado de la carpeta del sistema (es decir, Downloads) en el emulador en ejecución, o instálalo mediante
adb
mientras se ejecuta el dispositivo virtual:adb install -r Google_Play_Services_for_AR_1.31.0_x86_for_emulator.apk
Repite estos pasos para cualquier AVD adicional que quieras usar.
Controla la escena virtual
Cuando se conecte la app a ARCore, verás una superposición que describe cómo controlar la cámara y una barra de estado debajo de la ventana del emulador.
Cómo mover la cámara virtual
Mantén presionado Option (macOS) o Alt (Linux o Windows) para acceder a los controles de movimiento de la cámara. Usa los siguientes controles para mover la cámara:
Plataforma | Acción | Qué hacer |
---|---|---|
macOS | Mover a la izquierda o a la derecha | Mantén presionada la tecla Opción y presiona A o D. |
Moverse hacia abajo o hacia arriba | Mantén presionada la tecla Opción y presiona Q o E. | |
Avanzar o retroceder | Mantén presionada la tecla Opción y presiona W o S. | |
Cambiar la orientación del dispositivo | Mantén presionada la opción Opción y mueve el mouse | |
Linux o Windows | Mover a la izquierda o a la derecha | Mantén presionada la tecla Alt + presiona A o D |
Moverse hacia abajo o hacia arriba | Mantén presionada la tecla Alt + presiona Q o E | |
Avanzar o retroceder | Mantén presionada la tecla Alt + presiona W o S | |
Cambiar la orientación del dispositivo | Mantén presionada la tecla Alt y mueve el mouse |
Lanza Option o Alt para volver al modo interactivo en el emulador.
Usa la pestaña Virtual Sensors en la sección Extended controls para obtener un posicionamiento más preciso del dispositivo.
Cómo agregar imágenes aumentadas a la escena
Carga las imágenes en el entorno simulado del emulador para probar las imágenes aumentadas.
Usa la pestaña Camera en Extended controls para agregar o modificar Scene images. Hay dos ubicaciones de imágenes: una en la pared y otra en la mesa.
Para ver las ubicaciones de las imágenes en la escena, inicia el emulador y mueve la cámara al área del comedor por la puerta detrás de la posición inicial.
Sugerencias para solucionar problemas
Si se inicia tu app de ARCore y ves un mensaje de "Este dispositivo no es compatible con RA", verifica la revisión en tu imagen del sistema. Asegúrate de usar la Revisión 4 del nivel de API 27 o una posterior.
Si la app de ARCore no puede abrir la cámara cuando se inicia, asegúrate de que Camera Back esté configurado como VirtualScene, como se describe en los pasos de configuración anteriores.
Si no se puede abrir tu app de ARCore con el mensaje de error "No se pudo crear la sesión de RA", revisa el registro de la app. Si encuentras un
java.lang.UnsatisfiedLinkError
con un mensaje que contiene/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)
, es posible que hayas instalado la versión incorrecta del APK de Servicios de Google Play para RA. Crea un dispositivo virtual nuevo y, luego, instala la versión x86.