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.
Si no tienes un proyecto de Google Cloud existente, crea uno.
Habilita la API de ARCore
Para usar la API de ARCore, debes habilitarla en tu proyecto.
Configura un método de autorización
Una aplicación para Unity puede comunicarse con la API de ARCore mediante dos métodos de autorización: la autorización sin clave, que es la el método recomendado y la autorización de la clave de API:
En Android, la autorización sin clave usa una combinación del nombre de paquete de la aplicación y la huella digital de la clave de firma para autorizar tu aplicación.
En iOS, la autorización sin clave usa un token firmado para controlar el acceso a la API. Esta requiere un servidor de tu propiedad para firmar tokens y controlar el acceso a la API.
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 llave
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 .
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.
Usa el siguiente comando para obtener la huella digital del certificado de depuración.keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore
keytool -list -v -alias androiddebugkey -keystore %USERPROFILE%\.android\debug.keystore
La utilidad keytool te solicita que ingreses una contraseña para el almacén de claves. El
La contraseña predeterminada del almacén de claves de depuración es android. Luego, la utilidad keytool
imprime la huella digital en la terminal. Por ejemplo:
Certificate fingerprint: SHA1: <strong>DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
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.
- En la página Firma de apps de Google Play Console, desplázate hasta Certificado de la clave de firma de la app.
- 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.
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
- Incluye
com.google.android.gms:play-services-auth:16+en las dependencias de tu app. Si usas la reducción de código, haz lo siguiente: agrégala al archivo
build.gradlede tu app:buildTypes { release { ... proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } }Agrega lo siguiente al archivo
proguard-rules.prode 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.
Sin llave
ARCore admite la autorización de llamadas a la API en iOS usando un archivo (JSON Web token). El token debe tener la firma de un Cuenta de servicio.
Si quieres generar tokens para iOS, debes tener un extremo en tu servidor que cumpla con los siguientes requisitos:
Tu propio mecanismo de autorización debe proteger el extremo.
El extremo debe generar un token nuevo cada vez para que ocurra lo siguiente:
- Cada usuario obtiene un token único.
- Los tokens no vencen de inmediato.
Crea una cuenta de servicio y una clave de firma
Sigue estos pasos para crear una cuenta de servicio de Google y una clave de firma:
- En Google Cloud, abre la página Credenciales.
Credenciales - Haz clic en Crear credenciales > Cuenta de servicio
- En Detalles de la cuenta de servicio, escribe un nombre para la cuenta nueva y, luego, haz clic en Crear.
- En la página Permisos de la cuenta de servicio, ve al menú desplegable Selecciona un rol. Selecciona Cuentas de servicio > Creador de tokens de cuenta de servicio y, luego, haz clic en Continuar.
- En la página Otorgar a los usuarios acceso a esta cuenta de servicio, haz clic en Listo.
- En Credenciales, buscar la sección Cuentas de servicio y hacer clic en el nombre de la cuenta que acabas de crear.
- En la página Detalles de la cuenta de servicio, desplázate hacia abajo hasta la sección Claves y selecciona Agregar clave > Crea una clave nueva.
Selecciona JSON como el tipo de clave y haz clic en Crear.
Se descargará a tu máquina un archivo JSON que contiene la clave privada. Tienda el archivo de claves JSON descargado en una ubicación segura.
Crea tokens en tu servidor
Para crear nuevos tokens (JWT) en tu servidor, utiliza el token JWT estándar bibliotecas y el archivo JSON que descargaste de forma segura de tu nueva cuenta de servicio.
Crea tokens en tu máquina de desarrollo
Para generar JWT en tu máquina de desarrollo, usa el siguiente comando:
Comando oauth2l:
oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"
Es necesario especificar una ubicación de caché vacía con la marca --cache para lo siguiente:
asegurarse de que se produzca un token diferente cada vez. Asegúrate de cortar
cadena resultante. Los espacios adicionales o los caracteres de línea nueva provocarán que la API
rechazar el token.
Firma el token
Debes usar el algoritmo RS256 y las siguientes reclamaciones para firmar el JWT:
iss: Es la dirección de correo electrónico de la cuenta de servicio.sub: Es la dirección de correo electrónico de la cuenta de servicio.iat: Es el tiempo Unix en el que se generó el token, en segundos.exp:iat+3600(1 hora) El tiempo Unix cuando vence el token en segundos.aud: Es el público. Se debe configurar enhttps://arcore.googleapis.com/
No se requieren reclamaciones no estándar en la carga útil de JWT, aunque puedes encontrar la
La reclamación de uid es útil para identificar al usuario correspondiente.
Si usas un enfoque diferente para generar tus JWT, como un en un entorno administrado por Google, asegúrate de firmar tus JWT con las reclamaciones en esta sección. Sobre todo, asegúrate de que el público sea correcto.
Pasa el token en la sesión de ARCore
- Asegúrate de que la Estrategia de autenticación de iOS esté configurada como AuthenticationToken. En Unity, ve a Editar > Configuración del proyecto > Administración de complementos XR > Extensiones de ARCore En el menú desplegable Estrategia de autenticación de iOS selecciona la opción Token de autenticación.
Cuando obtengas un token, pásalo a tu sesión de ARCore mediante
ARAnchorManager.SetAuthToken():// Designate the token to authorize ARCore API calls // on the iOS platform. This should be called each time the application's token is refreshed. ARAnchorManager.SetAuthToken(authToken);
Tu app ahora está configurada para usar la autenticación sin clave.
Ten en cuenta lo siguiente cuando pases un token a la sesión:
Si usaste una clave de API para crear la sesión, ARCore ignorará token correcto y registrar un error.
Si ya no necesitas la clave de API, bórrala en la página de Google Developers Console y quítala de tu .
ARCore ignora los tokens que contienen espacios o caracteres especiales.
Los tokens suelen vencer después de una hora. Si existe la posibilidad de que tu cuando el token venza mientras esté en uso, obtén un token nuevo y pásalo a la API.
Clave de API
- En Google Cloud, abre la página Credenciales.
Credenciales - 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. En Unity, ve a Editar > Configuración del proyecto > Administración de complementos XR > Extensiones de ARCore Para cada plataforma de segmentación (Android, iOS), en su En el menú desplegable Estrategia de autenticación, selecciona la opción Clave de API. Luego, ingresa tu clave de API en los campos de clave de API.
- 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: