Para comenzar a usar ARCore con Android, puedes ejecutar la app de muestra hello_ar_kotlin o hello_ar_java incluida en el SDK de ARCore. Estas apps de muestra utilizan OpenGL, una interfaz de programación para renderizar gráficos vectoriales 2D y 3D. Las apps muestran los planos detectados y permiten que el usuario presione un plano para colocar un modelo 3D.
Cómo configurar tu entorno de desarrollo
Instala la versión 3.1 o 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.
Abre 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 establecida de Android Studio:
- En el menú Git, selecciona Clone.
- En el menú desplegable Version control, selecciona Git como el sistema de control de versión.
En el campo URL, ingresa la siguiente URL en el repositorio de GitHub de ARCore:
https://github.com/google-ar/arcore-android-sdk.git.
También puedes abrir un Terminal y emitir 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 de manera explícita un proyecto para poder compilarlo y ejecutarlo).
- En el menú File, selecciona Open.
- En la carpeta arcore-android-sdk/samples, selecciona 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 compila tu proyecto en un APK depurable, lo instala y, luego, ejecuta la app en tu dispositivo. Para obtener más información, consulta Cómo compilar y ejecutar una app.
Es posible que se te solicite instalar o actualizar los Servicios de Google Play para RA si falta o está desactualizado. 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 de ARCore tridimensional en las superficies del plano de RA detectadas. Se implementa con Android GL SurfaceView, que se usa para procesar la vista previa de la cámara y los objetos básicos de RA, como planos y anclas. El framework de renderización de muestra de hello_ar_java se puede encontrar en com/google/ar/core/examples/java/common/samplerender.
Utilizar 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 ubicación de objetos se define mejor en tiempo real a medida que el usuario se mueve más por el entorno.
Presiona la pantalla para colocar un objeto. Asegúrate de seguir moviendo el dispositivo una vez que aparezca el objeto holográfico en la pantalla, de modo que ARCore pueda obtener datos suficientes sobre el entorno para anclar el objeto virtual con precisión.
Una vez que ARCore detecta la geometría de la superficie y establece un área rastreable en la región donde se coloca el objeto, la pose del objeto se actualiza automáticamente para mayor precisión.
En la figura 1, la ubicación instantánea está inhabilitada y la geometría de la superficie no está definida. Los objetos ubicados en el piso a la derecha de la mesa de billar (cuatro puntos azules pequeños) aparecen derriba, sus poses son indefinidas.
En la figura 2, la ubicación instantánea se habilita desde el menú debajo del ícono de ajustes.
En la figura 3, con la ubicación instantánea habilitada, se coloca un objeto nuevo en la escena. Aparece en escala de grises, en lugar de color, para indicar que aún no se corrigió para una pose exacta.
En la Figura 4, el objeto nuevo se vuelve de un color y su pose es precisa, cuando se detecta la geometría de la superficie (descrita por las líneas de cuadrícula que se pueden rastrear).
Usar profundidad
Cuando la profundidad está habilitada, ARCore tiene 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 de la escena. Permite que objetos en la escena ocluyan los objetos colocados y le da realismo a la app.
En la figura 1, la profundidad está inhabilitada. Se coloca un objeto debajo de la tabla de billar.
En la figura 2, a medida que el dispositivo se mueve por la tabla de billar, el objeto parece seguir al dispositivo, independientemente de la escena.
En la figura 3, la profundidad está habilitada.
En la Figura 4, el objeto ahora aparece ocluido por la tabla de billar mientras 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 ejemplos de apps que puedes compilar y ejecutar.
- Obtén información para habilitar ARCore en tu app.
- Revisa las consideraciones sobre el tiempo de ejecución.
- Revisa los Lineamientos de Diseño.