Découvrez comment utiliser Cloud Anchors dans vos propres applications.
Conditions préalables
Avant de continuer, assurez-vous de comprendre les concepts fondamentaux de la RA et la configuration d'une session ARCore.
Si vous débutez avec les ancres cloud, assurez-vous de bien comprendre le fonctionnement des ancres et des ancres cloud.
Activer les ancres cloud dans votre application
Les ancres cloud sont désactivées par défaut dans ARCore. L'exemple d'application est fourni avec des ancres cloud activées à des fins de démonstration uniquement. Avant d'utiliser des ancres cloud dans votre application, vous devez activer l'API ARCore dans un projet Google Cloud Platform nouveau ou existant. Ce service est responsable de l'hébergement, du stockage et de la résolution des ancres cloud.
Vous devez également activer les fonctionnalités d'ancre cloud dans la configuration de session de RA de votre application afin qu'elle puisse communiquer avec l'API ARCore:
- Activez les fonctionnalités d'ancre cloud dans la configuration de votre session de RA.
- Reprenez la session de RA.
Authentifier votre application avec l'API ARCore
Vous devez authentifier l'API ARCore dans votre application pour qu'elle puisse héberger et résoudre les ancres cloud. Unity propose les options d'authentification Keyless et API Key pour le ciblage sur Android. Les applications qui hébergent et résolvent des ancres cloud avec un délai TTL supérieur à 1 jour doivent utiliser l'authentification sans clé.
La stratégie d'authentification par défaut pour les nouveaux projets Unity créés avec ARCore v1.24 ou une version ultérieure est DoNotUse. Cela permet d'empêcher la création d'applications avec des bibliothèques inutiles. Si votre application utilise Cloud Anchors et a été créée à l'aide d'ARCore v1.24 ou d'une version ultérieure, vous devez activer manuellement l'authentification dans les paramètres du projet Unity.
Authentification sans clé
Utilisez l'authentification sans clé pour héberger et ancrer des ancres cloud avec des valeurs TTL entre 1 et 365 jours.
- Sélectionnez Clé sans clé pour effacer toute clé API stockée à l'ancien paramètre Cloud Anchors, et ajouter les dépendances et les exceptions ProGuard nécessaires. Si vous avez déjà utilisé une clé API et que vous n'en avez plus besoin, nous vous conseillons de la supprimer dans la console Google Cloud Platform et de la supprimer de votre application après avoir migré les utilisateurs vers la dernière version.
- Créez un client OAuth pour votre application Android dans Google Developers Console, à l'aide de l'ID de l'application et de l'empreinte du certificat de signature. Cela permet d'associer l'ID d'application Android à votre projet Google Cloud Platform.
Authentification par clé API
Utilisez l'authentification par clé API pour héberger et ancrer des ancres cloud avec des valeurs TTL (Time To Live) jusqu'à 24 heures (1 jour).
- Consultez le Centre d'aide de la console Google Cloud Platform pour obtenir une clé API.
- Accédez à Modifier > Paramètres du projet > Paramètres du projet ARCore, puis ajoutez votre clé API au champ Clés API Cloud Anchor afin d'ajouter la nouvelle clé API à votre projet.
Vérifier la qualité de mappage des points de caractéristiques
FeatureMapQuality indique la qualité des points de caractéristiques observés par ARCore au cours des dernières secondes d'une position de caméra donnée. Les ancres cloud hébergées à l'aide de fonctionnalités de meilleure qualité sont généralement résolues avec plus de précision.
| Value | Description |
|---|---|
Insufficient |
La qualité des points de caractéristiques identifiés dans la position au cours des dernières secondes est faible. Cet état indique que ARCore aura probablement plus de difficultés à résoudre l'ancre cloud. Encouragez l'utilisateur à déplacer l'appareil de sorte que la position souhaitée de l'ancre cloud qu'il souhaite héberger soit vue sous différents angles. |
Sufficient |
La qualité des points de caractéristiques identifiés dans la pose au cours des dernières secondes est probablement suffisante pour ARCore à résoudre une ancre cloud, bien que la précision de la pose résolue soit probablement réduite. Encouragez l'utilisateur à déplacer l'appareil de sorte que la position souhaitée de l'ancre cloud qu'il souhaite héberger soit vue sous différents angles. |
Good |
La qualité des points de caractéristiques identifiés lors de la pose au cours des dernières secondes suffit probablement à résoudre ARCore avec la plus grande précision possible pour une ancre cloud. |
Quotas d'API pour les requêtes d'hôte et de résolution
Les quotas de bande passante des requêtes pour l'API ARCore sont les suivants:
| Type de quota | Maximum | Durée | Applies to |
|---|---|---|---|
| Nombre d'ancres | unlimited | N/A | projet |
| Requêtes host ancrées | 30 | minute | Adresse IP et projet |
| Requêtes d'ancrage resolve | 300 | minute | Adresse IP et projet |
Bonnes pratiques pour une expérience utilisateur de qualité
Demandez aux utilisateurs d'effectuer les actions suivantes pour garantir une bonne expérience utilisateur dans votre application:
- Attendez quelques secondes après le début de la session avant d'essayer d'héberger une ancre. Le suivi peut ainsi se stabiliser.
- Lorsque vous sélectionnez un emplacement pour héberger l'ancre, essayez de trouver une zone dont les caractéristiques visuelles se distinguent facilement. Pour de meilleurs résultats, évitez les surfaces réfléchissantes ou dépourvues de caractéristiques visuelles, comme des murs blancs vierges.
Maintenez la caméra au centre de l'intérêt et déplacez-la pour cartographier l'environnement sous différents angles, en conservant à peu près la même distance physique. Cela peut prendre jusqu'à 30 secondes. Vous pourrez ainsi collecter plus de données visuelles et rendre la résolution plus fiable.
Assurez-vous que l'éclairage est suffisant dans l'environnement réel lors de l'hébergement et de la résolution des ancres cloud.
Règlement relatif aux abandons
- Les applications créées avec la version 1.12.0 ou ultérieure du SDK ARCore sont soumises au Règlement relatif aux abandons de l'API Cloud Anchor.
- Les applications créées avec ARCore SDK 1.11.0 ou une version antérieure ne peuvent pas héberger ni résoudre d'ancres cloud, car une API obsolète d'ARCore a été utilisée.
Étapes suivantes
- Consultez la documentation de référence ARCore pour Unity pour découvrir d'autres façons d'utiliser ARCore dans votre application.