Para comenzar a usar ARCore con Android, puedes ejecutar la app de ejemplo hello_ar_kotlin o hello_ar_java incluida con el SDK de ARCore. Estas apps de ejemplo usan OpenGL, una interfaz de programación para renderizar gráficos vectoriales 2D y 3D. Las apps muestran los planos detectados y le permiten al usuario presionar un plano para colocar un modelo 3D.
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.
Si es la primera vez que usas Android, consulta Cómo compilar tu primera app para Android.
Cómo abrir un proyecto de muestra
En Android Studio, clona el repositorio de GitHub del SDK de ARCore.
Hay muchas formas de hacerlo:
Para una instalación ya establecida de Android Studio:
- En el menú Git, selecciona Clone.
- En el menú desplegable Version control, selecciona Git como sistema de control de versión.
En el campo URL, ingresa la siguiente URL al repositorio de GitHub de ARCore:
https://github.com/google-ar/arcore-android-sdk.git
También puedes abrir un Terminal y ejecutar el comando
git clonede la siguiente manera:git clone https://github.com/google-ar/arcore-android-sdk.git
Abre uno de los proyectos de muestra de la siguiente manera (debes abrir un proyecto de forma explícita para compilar y ejecutar).
- En el menú File, selecciona Open.
- En la carpeta arcore-android-sdk/samples, selecciona la carpeta hello_ar_kotlin o hello_ar_java, y haz clic en Open.
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.
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.
Es posible que se te solicite que instales o actualices los Servicios de Google Play para RA si no están o están desactualizados. Selecciona CONTINUE para instalarlo desde Google Play Store o actualízalo de forma manual como se describe en Cómo actualizar los Servicios de Google Play para RA.
La app hello_ar_java te permite colocar un peón tridimensional de ARCore en superficies de planos de RA detectadas. Se implementa con Android GL SurfaceView, que se usa para renderizar la vista previa de la cámara y objetos de RA básicos, como planos y anclas. El framework de renderización de muestra de hello_ar_java se encuentra en com/google/ar/core/examples/java/common/samplerender.
Utilizar la Posición instantánea
La API de Instant Placement le 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 colocación de objetos se define mejor en tiempo real a medida que el usuario se mueve más allá del entorno.
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.
Una vez que ARCore detecta la geometría de la superficie y establece un objeto rastreable en la región en la que se coloca el objeto, su pose se actualiza automáticamente para mejorar su precisión.
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
- Intenta compilar y ejecutar otros proyectos de muestra en el SDK de ARCore.
- Consulta los codelabs de realidad aumentada para obtener más apps de ejemplo que puedes compilar y ejecutar.
- Descubre cómo habilitar ARCore en tu app.
- Revisa las Consideraciones de tiempo de ejecución.
- Revisa los lineamientos de diseño.