Cómo configurar tu entorno de desarrollo
Instala la versión 3.1 o una posterior de Android Studio con la versión 7.0 de la plataforma del SDK de Android (nivel de API 24) o una posterior.
Prepara Android Studio para el desarrollo nativo mediante la instalación del kit de desarrollo nativo (NDK) de Android y CMake con SDK Manager. Para obtener más información, consulta Cómo comenzar a usar el NDK.
Deberás obtener el SDK de ARCore para Android. Tienes varias opciones:
Descarga el SDK de ARCore para Android y extráelo.
O bien:
Usa el siguiente comando para clonar el repositorio:
git clone https://github.com/google-ar/arcore-android-sdk.git
Cómo preparar tu dispositivo o emulador
Puedes ejecutar apps de RA en un dispositivo compatible o en Android Emulator. Debes actualizar los Servicios de Google Play para RA en el emulador antes de ejecutar la app. Consulta Cómo ejecutar apps de RA en Android Emulator para obtener más información.
Abre el proyecto de muestra
En Android Studio, abre el proyecto de ejemplo hello_ar_c en <ARCore SDK Folder>/samples/hello_ar_c
.
El proyecto de ejemplo tiene dependencias de compilación en ciertas versiones de software, como Gradle y el SDK de Android. Si no están instaladas las dependencias necesarias, Android Studio te pedirá permiso para descargarlas e instalarlas en tu equipo.
Ejecutar la muestra
Asegúrate de que tu dispositivo Android esté conectado a la máquina de desarrollo y haz clic en Run en Android Studio.
Android Studio compilará tu proyecto en un APK depurable, lo instalará y, luego, ejecutará la app en tu dispositivo. Para obtener más información, consulta Cómo compilar y ejecutar tu app.
A medida que mueves el dispositivo, la app detecta automáticamente superficies planas y dibuja una cuadrícula de diamante. Presiona la cuadrícula para colocar un peón de ARCore tridimensional en la superficie.
Utilizar la Posición instantánea
La API de Instant Placement permite al usuario colocar un objeto de RA en la pantalla sin tener que esperar a que ARCore detecte la geometría de la superficie. La posición de los objetos se define mejor en tiempo real a medida que el usuario se mueve más allá del entorno. Una vez que ARCore detecte la pose correcta en la región donde se ubica el objeto de RA, el objeto se actualizará automáticamente para que tenga precisión de poses.
Presiona la pantalla para colocar un objeto. Asegúrate de seguir moviendo el dispositivo después de ver aparecer el objeto holográfico en la pantalla, de modo que ARCore pueda obtener suficientes datos sobre tu entorno para fijar con precisión el objeto virtual.
En la Figura 1, la función Instant Placement está inhabilitada y la geometría de superficie no está definida. Los objetos colocados en el suelo a la derecha de la mesa de billar (cuatro puntos azules pequeños) parecen derribados y sus poses no están definidas.
En la Figura 2, la Posición instantánea se habilita en el menú ubicado debajo del ícono de ajustes.
En la Figura 3, con la Posición instantánea habilitada, se coloca un nuevo objeto en la escena. Aparece en escala de grises, en lugar de coloreado, para indicar que aún no se corrigió para una pose precisa.
En la Figura 4, el nuevo objeto se vuelve coloreado, y su posición es precisa cuando se detecta la geometría de superficie (descrita por las líneas de cuadrícula que se pueden rastrear).
Usa profundidad
Cuando se habilita Depth, ARCore toma en cuenta la geometría y la ubicación de los objetos de la escena y calcula la ubicación de los objetos ubicados en la escena en relación con otros objetos presentes en ella. Permite que los objetos en la escena ocluyan los objetos colocados y le otorga realismo a tu app.
En la Figura 1, se inhabilitó la profundidad. Se coloca un objeto debajo de una mesa de billar.
En la Figura 2, a medida que el dispositivo se mueve por la mesa de billar, parece que el objeto sigue al dispositivo, independientemente de los objetos de la escena.
En la Figura 3, se habilitó la profundidad.
En la Figura 4, el objeto ahora aparece ocluido por la mesa de billar a medida que el dispositivo se mueve por la escena.
Próximos pasos
- Descubre cómo habilitar ARCore en tu app.
- Usa imágenes aumentadas para compilar apps que puedan responder a imágenes en 2D, como pósteres o logotipos, en el entorno del usuario.
- Usa Cloud Anchors
- Usa la API de Depth para garantizar una profundidad precisa y brindar experiencias del usuario envolventes y realistas.
- Usa Posición instantánea para colocar rápidamente objetos de RA en la pantalla.
- Revisa las consideraciones de tiempo de ejecución.
- Revisa los lineamientos de diseño.