Guía de inicio rápido para el NDK de Android

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.

Posición instantánea

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.

Posición instantánea

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