Guide de démarrage rapide de Cloud Anchors pour Android

Essayez d'héberger et de résoudre des ancres cloud dans les applications exemples cloud_anchor_java et persistent_cloud_anchor_java.

Quelle application exemple devez-vous utiliser ?

Les ancres cloud sont des ancres hébergées sur le point de terminaison cloud de l'API ARCore. Cette API permet aux utilisateurs de partager des expériences dans la même application. Les ancres cloud persistantes sont des ancres cloud qui peuvent être hébergées pendant plus de 24 heures.

  • persistent_cloud_anchor_java est une implémentation d'un cas d'utilisation de projet collaboratif. Il utilise une autorisation sans clé pour autoriser les appels d'API ARCore. Comme il n'utilise pas de backend Firebase pour partager les ID d'ancre cloud entre les appareils, il est beaucoup plus facile d'être opérationnel.
  • cloud_anchor_java est une implémentation d'un cas d'utilisation multijoueur. Il utilise une clé API pour autoriser les appels d'API ARCore.

Prérequis

Conditions requises

Matériel

Logiciels

  • Android Studio version 3.0 ou ultérieure avec Android SDK Platform version 7.0 (niveau d'API 24) ou ultérieure
  • Le SDK ARCore pour Android, que vous pouvez obtenir de l'une des deux manières suivantes :
    • Téléchargez-le sur GitHub et extrayez-le sur votre ordinateur.
    • Clonez le dépôt à l'aide de la commande suivante : 
      git clone https://github.com/google-ar/arcore-android-sdk.git

Ouvrir l'application exemple dans Android Studio

Le SDK ARCore fournit les exemples d'applications cloud_anchor_java et persistent_cloud_anchor_java pour illustrer le fonctionnement de Cloud Anchors. Suivez ces étapes pour ouvrir les applications dans Android Studio.

Ancres cloud persistantes

  1. Dans Android Studio, cliquez sur Open (Ouvrir).

  2. Accédez à l'emplacement où le répertoire arcore-android-sdk est stocké sur votre ordinateur. N'ouvrez pas tout le dossier du SDK. Accédez plutôt à samples > persistent_cloud_anchor_java et cliquez sur Open (Ouvrir).

Cloud Anchors

  1. Dans Android Studio, cliquez sur Open (Ouvrir).

  2. Accédez à l'emplacement où le répertoire arcore-android-sdk est stocké sur votre ordinateur. N'ouvrez pas tout le dossier du SDK. Accédez plutôt à samples > cloud_anchor_java, puis cliquez sur Open (Ouvrir).

Configurer le partage des ID d'ancre cloud

Les ID d'ancre cloud sont des chaînes qui identifient les ancres cloud hébergées. Ils permettent de résoudre les objets 3D associés aux ancres hébergées, ou d'afficher ces objets.

Ancres cloud persistantes

Le partage des ID d'ancre cloud est géré localement dans l'application. Aucune action de votre part n'est requise.

Cloud Anchors

L'application exemple cloud_anchor_java utilise les bases de données en temps réel de Firebase pour partager les ID d'ancre cloud entre les appareils. Vous pouvez utiliser une autre solution dans vos propres applications.

  1. Ajoutez manuellement Firebase à votre application. Le nom du package cloud_anchor_java est com.google.ar.core.examples.java.cloudanchor. Vous le trouverez dans main/AndroidManifest.xml.
  2. Téléchargez le fichier google-services.json que vous avez généré lorsque vous avez ajouté Firebase à votre application.
  3. Créez une base de données Realtime Database avec Firebase.
  4. Dans Android Studio, ajoutez le fichier google-services.json au répertoire app de votre projet.

Autoriser les appels d'API ARCore

Autorisez les appels à l'API ARCore pour héberger et résoudre des ancres cloud pour votre application. Suivez les étapes de la section Utiliser l'API ARCore sur Google Cloud et utilisez l'autorisation sans clé pour les ancres cloud persistantes ou l'autorisation par clé API pour les ancres cloud.

Créer et exécuter l'application exemple

Ancres cloud persistantes

Exécuter l'application

  1. Assurez-vous que les options pour les développeurs et le débogage USB sont activées sur votre appareil.
  2. Connectez votre appareil à votre ordinateur de développement via USB.
  3. Dans Android Studio, sélectionnez votre appareil comme cible de déploiement, puis cliquez sur Run (Exécuter).

persistent_cloud_anchor_java devrait se lancer sur votre appareil et demander à ARCore de détecter les avions situés devant la caméra de l'appareil.

Si l'autorisation Google Cloud échoue, consultez la section Procédure de dépannage.

Placer une ancre

  1. Lorsque l'application commence à détecter les surfaces planes, appuyez sur l'écran pour placer une ancre sur l'une des surfaces planes détectées.
  2. Appuyez sur le bouton HÔTE pour héberger l'ancre placée. Cela envoie une requête hôte à l'API ARCore, qui inclut des données représentant la position de l'ancre par rapport aux caractéristiques visuelles à proximité.

Une requête d'hôte réussie établit une ancre à l'emplacement placé et lui attribue un ID d'ancre cloud. Si la demande d'hôte aboutit, l'application doit afficher un code de chambre. Vous pouvez utiliser ce code pour accéder aux ancres précédemment hébergées pour cette salle sur n'importe quel appareil.

Résoudre une ancre

  1. Appuyez sur RÉSOUDRE et saisissez un code de salon précédemment renvoyé pour accéder aux ancres hébergées dans cette salle. Une requête de résolution est alors envoyée à l'API ARCore, qui renvoie les ID de toutes les ancres actuellement hébergées dans la salle. persistent_cloud_anchor_java utilisera ces ID pour afficher les objets 3D associés aux ancres hébergées.

Cloud Anchors

Exécuter l'application

  1. Assurez-vous que les options pour les développeurs et le débogage USB sont activées sur votre appareil.
  2. Connectez votre appareil à votre ordinateur de développement via USB.
  3. Dans Android Studio, sélectionnez votre appareil comme cible de déploiement, puis cliquez sur Run (Exécuter).

cloud_anchor_java devrait se lancer sur votre appareil et demander à ARCore de détecter les avions situés devant la caméra de l'appareil.

Erreur : com.google.firebase.database.DatabaseException: Failed to get FirebaseDatabase instance: Specify DatabaseURL within FirebaseApp or from your getInstance

Si vous rencontrez cette erreur, assurez-vous que la propriété firebase_url est présente dans google-services.json. Pour obtenir la valeur correcte pour cette propriété, assurez-vous que Realtime Database a été créé et téléchargez google-services.json.

Placer une ancre

  1. Lorsque l'application commence à détecter les surfaces planes, appuyez sur l'écran pour placer une ancre sur l'une des surfaces planes détectées.
  2. Appuyez sur le bouton HÔTE pour héberger l'ancre placée. Cela envoie une requête hôte à l'API ARCore, qui inclut des données représentant la position de l'ancre par rapport aux caractéristiques visuelles à proximité.

Une requête d'hôte réussie établit une ancre à l'emplacement placé et lui attribue un ID d'ancres cloud. Si la demande d'hôte aboutit, l'application doit afficher un code de chambre. Vous pouvez utiliser ce code pour accéder aux ancres précédemment hébergées pour cette salle sur n'importe quel appareil.

Résoudre une ancre

  1. Appuyez sur RÉSOUDRE et saisissez un code de salon précédemment renvoyé pour accéder aux ancres hébergées dans cette salle. Une requête de résolution est alors envoyée à l'API ARCore, qui renvoie les ID de toutes les ancres actuellement hébergées dans la salle. cloud_anchor_java utilisera ces ID pour afficher les objets 3D associés aux ancres hébergées.

Et ensuite ?