Usa la API de ARCore en Google Cloud

Selecciona la plataforma: En Android Unity (AR Foundation) iOS

atributos de ARCore, como Geospatial API y Cloud Anchors usan la API de ARCore alojada en Google Cloud. Cuando usas estas funciones, tu aplicación usa credenciales para acceder al servicio de la API de ARCore.

En esta guía de inicio rápido, se describe cómo configurar tu aplicación para que pueda comunicarse con el servicio de la API de ARCore alojado en Google Cloud.

Crea un proyecto de Google Cloud nuevo o usa uno existente

Si ya tienes un proyecto, selecciónalo.

Ir al selector de proyectos

Si no tienes un proyecto de Google Cloud existente, crea uno.

Crear un nuevo proyecto

Habilita la API de ARCore

Para usar la API de ARCore, debes habilitarla en tu proyecto.

Habilitar la API de ARCore

Configura un método de autorización

Una aplicación para Android puede comunicarse con la API de ARCore mediante dos métodos de autorización: la autorización sin clave (OAuth 2.0), que es la el método recomendado y la autorización de la clave de API:

• La autorización sin clave usa una combinación del nombre del paquete de la aplicación y la huella digital de la clave de firma para autorizar tu aplicación.
• Una clave de API es una cadena que identifica un proyecto de Google Cloud. Las claves de API son no suelen considerarse seguras, ya que suelen ser accesibles para los clientes. Considera usar la autorización sin clave para comunicarte con la API de ARCore.

Sin llaveClave de API

Para autorizar tu app con la autenticación sin clave, crea el cliente de OAuth 2.0. de sus IDs.

Cómo determinar las huellas digitales de la clave de firma

El ID de cliente de OAuth 2.0 usa la huella digital de la clave de firma de la app para identificar .

Importante: Es común firmar tu aplicación con diferentes claves de firma. Debes crear un ID de cliente para cada clave de firma que planees usar. Comúnmente, este es una firma de depuración clave y libera las claves de firma.

Cómo obtener tu huella digital de firma de depuración

Cuando ejecutas o depuras tu proyecto, las herramientas del SDK de Android firman automáticamente tu app con un certificado de depuración generado.

• En Android Studio, abre el panel de herramientas de Gradle.
• Navegar a project-name > Tareas > Android.
• Ejecuta la tarea signingReport.

  

• Copia la huella digital SHA-1 para la variante debug.

Cómo obtener una huella digital de firma de un almacén de claves

Si tienes un archivo de almacén de claves, usa la utilidad keytool para determinar la huella digital.

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

Luego, la utilidad keytool imprime la huella digital en la terminal. Por ejemplo:

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

Cómo obtener la clave de firma de tu app desde la firma de apps de Play

Cuando uses la firma de apps de Play, Google administra la clave de firma de tu app y la usa para firmar los APK. Esta clave debe usarse para la huella digital de la firma.

1. En la página Firma de apps de Google Play Console, desplázate hasta Certificado de la clave de firma de la app.
2. Usa la huella digital del certificado SHA-1.

Crear ID de cliente de OAuth 2.0

Para cada clave de firma aplicable de los pasos anteriores, crea un ID de cliente de OAuth 2.0 en tu las credenciales del proyecto de Google Cloud.

• En Google Cloud, abre la página Credenciales.

  Credenciales

• Haz clic en Crear credenciales y, luego, selecciona ID de cliente de OAuth en el menú.

• Completa los campos obligatorios de la siguiente manera:

  • Tipo de aplicación: Elige Android.
  • Nombre del paquete: Usa el nombre del paquete como aparece en el archivo AndroidManifest.xml.
  • Huella digital del certificado SHA-1: Usa una huella digital obtenida en los pasos anteriores.

• Presiona Crear.

Cómo incluir las bibliotecas requeridas

1. Incluye com.google.android.gms:play-services-auth:16+ en las dependencias de tu app.

2. Si usas la reducción de código, haz lo siguiente: agrégala al archivo build.gradle de tu app:

   buildTypes {
     release {
       ...
       proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
     }
   }
   

3. Agrega lo siguiente al archivo proguard-rules.pro de tu app:

   -keep class com.google.android.gms.common.** { *; }
   -keep class com.google.android.gms.location.** { *; }
   -keep class com.google.android.gms.auth.** { *; }
   -keep class com.google.android.gms.tasks.** { *; }
   

Tu app ahora está configurada para usar la autenticación sin clave.

1. En Google Cloud, abre la página Credenciales.
   Credenciales
2. Haz clic en Crear credenciales y, luego, selecciona Clave de API en el menú.
   El En el diálogo Se creó la clave de API, se muestra la string de la clave que acabas de crear.

3. En Android Studio, agrega la nueva clave de API a tu proyecto. Incluye la clave de API en un <meta-data> en la <application> en el AndroidManifest.xml de tu app:

   <meta-data
     android:name="com.google.android.ar.API_KEY"
     android:value="API_KEY"/>
   

4. Revisa la documentación sobre las restricciones de la clave de API. para proteger tu clave de API.

La app ya está configurada para usar claves de API.

¿Qué sigue?

Con la autorización configurada, consulta las siguientes funciones de ARCore que usan de la siguiente manera:

• API de Geospatial
• API de Cloud Anchor