Utiliser l'API ARCore sur Google Cloud

Sélectionnez une plate-forme: <ph type="x-smartling-placeholder"></ph> Android Unity (Fondation de la RA) iOS

des fonctionnalités ARCore telles que l'API Geospatial API et Cloud Anchors utilisent API ARCore hébergée sur Google Cloud. Lorsque vous utilisez ces fonctionnalités, votre application utilise des identifiants pour accéder au service de l'API ARCore.

Ce guide de démarrage rapide explique comment configurer votre application pour qu'elle puisse communiquer avec le service d'API ARCore hébergé sur Google Cloud.

Créer un projet Google Cloud ou utiliser un projet existant

Si vous en avez déjà un, sélectionnez-le.

Accéder au sélecteur de projet

Si vous ne disposez d'aucun projet Google Cloud, créez-en un.

Créer un projet

Activer l'API ARCore

Pour utiliser l'API ARCore, vous devez l'activer dans votre projet.

Activer l'API ARCore

Configurer une méthode d'autorisation

Une application Android peut communiquer avec l'API ARCore par le biais de deux méthodes méthodes d'autorisation: l'autorisation sans clé (OAuth 2.0), qui est la méthode recommandée et l'autorisation via des clés API:

• L'autorisation sans clé utilise une combinaison du nom de package de l'application et l'empreinte de la clé de signature pour autoriser votre application.
• Une clé API est une chaîne qui identifie un projet Google Cloud. Les clés API sont généralement pas considérés comme sécurisés car ils sont généralement accessibles aux clients. Envisagez d'utiliser l'autorisation sans clé pour communiquer avec l'API ARCore.

CléClé API

Pour autoriser votre application à l'aide de l'authentification sans clé, créez un client OAuth 2.0. ID.

Déterminer les empreintes d'une clé de signature

Un ID client OAuth 2.0 utilise l'empreinte de la clé de signature de votre application pour identifier votre l'application.

Important :Il est courant de signer votre application avec différentes clés de signature. Vous devez créer un ID client pour chaque clé de signature que vous prévoyez d'utiliser. En général, cette est une signature de débogage clé et clé(s) de signature de libération.

Obtenir l'empreinte de votre signature de débogage

Lors de l'exécution ou du débogage de votre projet, les outils Android SDK signent automatiquement votre application avec un certificat de débogage généré.

• Dans Android Studio, ouvrez le volet des outils Gradle.
• Accédez à project-name > Liste de tâches > Android.
• Exécutez la tâche signingReport.

  

• Copiez l'empreinte SHA-1 de la variante debug.

Obtenir une empreinte de signature à partir d'un keystore

Si vous disposez d'un fichier keystore, utilisez l'utilitaire keytool pour déterminer l'empreinte.

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

L'utilitaire keytool affiche ensuite l'empreinte sur le terminal. Exemple :

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

Obtenir la clé de signature de votre application auprès du service Signature d'application Play

Si vous utilisez le service Signature d'application Play, Google gère la clé de signature de votre application et l'utilise pour signer vos APK. Cette clé doit être utilisée pour l'empreinte digitale de signature.

1. Sur la page Signature d'application de la Google Play Console, faites défiler la page jusqu'à Certificat de la clé de signature d'application.
2. Utilisez l'empreinte du certificat SHA-1.

Créer des ID client OAuth 2.0

Pour chaque clé de signature applicable obtenue aux étapes précédentes, créez un ID client OAuth 2.0 dans votre Identifiants du projet Google Cloud.

• Dans Google Cloud, ouvrez la page "Identifiants".

  Identifiants

• Cliquez sur Créer des identifiants, puis sélectionnez ID client OAuth dans le menu.

• Remplissez les champs obligatoires comme suit:

  • Type d'application: sélectionnez Android.
  • Package name (Nom du package) : utilisez le nom du package tel qu'il est déclaré dans le fichier AndroidManifest.xml.
  • Empreinte du certificat SHA-1: utilisez une empreinte obtenue aux étapes précédentes.

• Appuyez sur Créer.

Inclure les bibliothèques requises

1. Incluez com.google.android.gms:play-services-auth:16+ dans les dépendances de votre application.

2. Si vous utilisez la minimisation du code, Ajoutez-le au fichier build.gradle de votre application:

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

3. Ajoutez le code suivant au fichier proguard-rules.pro de votre application:

   -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.** { *; }
   

Votre application est maintenant configurée pour utiliser l'authentification sans clé.

1. Dans Google Cloud, ouvrez la page "Identifiants".
   Identifiants
2. Cliquez sur Créer des identifiants, puis sélectionnez Clé API dans le menu.
   : La boîte de dialogue "Clé API créée" affiche la chaîne de la clé que vous venez de créer.

3. Dans Android Studio, ajoutez la nouvelle clé API à votre projet. Incluez la clé API dans un <meta-data> dans <application> dans le AndroidManifest.xml de votre application:

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

4. Consultez la documentation sur les restrictions de clés API. pour sécuriser votre clé API.

Votre application est maintenant configurée pour utiliser des clés API.

Étape suivante

Une fois l'autorisation configurée, accédez aux fonctionnalités ARCore suivantes qui utilisent comme suit:

• API Geospatial
• API Cloud Anchor