Guide de démarrage rapide pour les ancres cloud dans iOS

L'API ARCore Cloud Anchor, ou service ARCore Cloud Anchor, fournit des fonctionnalités d'ancre cloud pour vos applications iOS, ce qui en fait permet aux utilisateurs d'appareils iOS et Android de partager des expériences de RA.

Ce guide vous explique comment:

  • Configurer votre environnement de développement pour qu'il fonctionne avec des ancres cloud
  • Essayer d'héberger et de résoudre des ancres dans une application exemple

Prérequis

  • Xcode version 13.0 ou ultérieure
  • CocoaPods 1.4.0 ou version ultérieure si vous utilisez CocoaPods
  • Un appareil Apple compatible avec ARKit fonctionnant sous iOS 12.0 ou version ultérieure (cible de déploiement d'iOS 12.0 ou version ultérieure requise)

Utiliser des ancres cloud

Dans les étapes suivantes, nous utilisons l'application exemple Cloud Anchors pour vous présenter de configuration et de création d'une application compatible avec ARCore Cloud Anchors.

Obtenir l'application exemple Cloud Anchors

  1. Clonez ou téléchargez le SDK ARCore pour iOS à partir de GitHub. pour obtenir le code de l'application exemple.

  2. Ouvrez une fenêtre de terminal ou du Finder et accédez au dossier dans lequel vous avez cloné. ou téléchargé le SDK.

  3. Vous trouverez l'exemple de code de l'application dans
    /arcore-ios-sdk-master/Examples/CloudAnchorExample

    L'exemple de code d'application d'ancres cloud persistantes est dans
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample

Configuration de la session

L'application exemple effectue les tâches importantes suivantes lors de la configuration session:

Configurer le partage des ID d'ancre cloud

L'application exemple Cloud Anchors utilise Firebase pour partager les ID d'ancre cloud entre appareils. Vous pouvez utiliser une autre solution dans vos propres applications.

Pour configurer la base de données Firebase dans l'application exemple:

  1. Suivez les instructions de Firebase pour ajouter Firebase à votre application.
  2. Télécharger le fichier GoogleService-Info.plist généré lors de l'ajout Firebase à votre application.
  3. Activez Firebase Storage pour l'exemple:
    • Accédez à la console Firebase, puis sélectionnez le projet pour lequel vous avez configuré. l'application exemple.
    • Sélectionnez le panneau Database.
    • Sur l'option Realtime Database, cliquez sur Get Started.
    • Le menu Security rules for Realtime Database s'ouvre.
      • Pour exécuter l'exemple, sélectionnez Start in test mode.
      • Notez que si vous utilisez Firebase pour une application que vous prévoyez de publier, vous devez utiliser des règles de sécurité plus restrictives.
  4. Dans Xcode, ajoutez le fichier GoogleService-Info.plist à votre application, à côté de Info.plist

Configurer l'API ARCore

Pour utiliser Cloud Anchors, vous devez d'abord configurer API ARCore pour votre application.

Exécuter la mise à jour du pod

L'application CloudAnchorExample est fournie avec un Podfile préconfiguré avec le paramètre SDK ARCore et versions d'iOS nécessaires. Pour installer ces dépendances:

  1. Ouvrez une fenêtre de terminal et exécutez pod update à partir du dossier dans lequel se trouve Le projet Xcode existe.
    Cela génère un fichier .xcworkspace que vous utiliserez plus tard pour créer et exécuter l'application.

Consultez Ajouter le SDK ARCore à votre application. pour savoir comment configurer Podfile dans vos propres applications.

  1. Ouvrez le fichier .xcworkspace du projet dans Xcode.

    Pour éviter les erreurs de compilation, assurez-vous de compiler à partir de .xcworkspace et non le fichier .xcodeproj.

Modifier l'ID de l'app bundle

Dans Xcode, modifiez l'ID du bundle de l'application afin de pouvoir la signer avec votre équipe.

Créer et exécuter l'application

  1. Connectez votre appareil et lancez l'application dans Xcode.

  2. (Facultatif) Si vous compilez et exécutez l'application exemple, consultez les ressources suivantes : pour découvrir comment utiliser l'application pour héberger et résoudre des ancres cloud.

Essayer l'application exemple

  1. Créer et exécuter l'application exemple à partir du fichier .xcworkspace pour la lancer sur votre appareil.

  2. Si vous y êtes invité, accordez à l'application l'autorisation d'accéder à l'appareil photo. ARKit, puis commence à détecter les surfaces planes devant votre caméra.

  3. Appuyez sur HOST pour passer en mode d'hébergement. Un code de salle permettant de partager des ancres hébergées est généré et apparaît sur votre écran.

  4. Appuyez sur un avion pour commencer à y héberger une ancre nuageuse.

    • L'application place un objet Android Andy dans l'avion et attache une ancre. avec lui.
    • Une requête d'hôte est envoyée au point de terminaison cloud de l'API ARCore. L'organisateur la requête inclut des données représentant la position de l'ancre par rapport à des éléments visuels à proximité.
    • Une fois l'ancre hébergée, elle obtient un ID utilisé pour résoudre les problèmes dans cet espace.

  5. Appuyez sur RESOLVE et saisissez un code de salle auquel vous souhaitez accéder précédemment hébergées sur le même appareil ou sur un autre appareil.

    • Une requête de résolution est envoyée au point de terminaison cloud de l'API ARCore.
    • La requête de résolution inclut un ID d'ancre cloud. Si l'ID correspond à ancre hébergée et que la localisation aboutit, le serveur renvoie la transformation de l'ancre en vos coordonnées locales.
    • L'application exemple utilise la transformation pour ajouter l'ancre à votre scène et pour afficher les objets virtuels qui lui sont associés.

Ajouter le SDK ARCore à vos applications

Dans vos propres applications, vous devrez mettre à jour votre Podfile pour y inclure le SDK ARCore et gestion des versions iOS compatible. Pour ce faire :

  1. Ajoutez les éléments platform et pod suivants à votre Podfile du projet:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
  1. Ouvrez une fenêtre de terminal et exécutez pod update à partir du dossier dans lequel si votre projet Xcode existe.
    Cela génère un fichier .xcworkspace que vous utilisez pour compiler et exécuter l'application.

Ancres cloud persistantes

Comme décrit dans la section Héberger une ancre cloud avec persistance, vous pouvez lui appliquer une valeur TTL (Time To Live) pouvant atteindre 365 jours. Exemple de code pour à l'aide d'ancres cloud persistantes est disponible dans /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample du SDK ARCore pour iOS depuis GitHub.

Étapes suivantes