Guida rapida per Cloud Anchor in iOS

L'API ARCore Cloud Anchor, o servizio ARCore Cloud Anchor, fornisce funzionalità di ancoraggio al cloud per le tue app per iOS, consentendole di che consentono agli utenti di dispositivi iOS e Android di condividere esperienze AR.

Questa guida spiega come:

  • Configura l'ambiente di sviluppo in modo che funzioni con gli ancoraggi Cloud
  • Prova l'hosting e la risoluzione degli ancoraggi in un'app di esempio

Prerequisiti

  • Xcode 13.0 o versioni successive
  • Cocoapods 1.4.0 o versione successiva se utilizzi Cocoapods
  • Un dispositivo Apple compatibile con ARKit con iOS 12.0 o versioni successive (è richiesta la destinazione del deployment di iOS 12.0 o versioni successive)

Utilizzo dei cloud anchor

Nei passaggi seguenti viene utilizzata l'app di esempio Cloud Anchors per mostrarti le per configurare e creare un'app che supporti gli ancoraggi Cloud ARCore.

Ottieni l'app di esempio Cloud Anchors

  1. Clona o scarica l'SDK ARCore per iOS da GitHub. per ottenere il codice dell'app di esempio.

  2. Apri una finestra Terminale o Finder e passa alla cartella in cui hai clonato o scaricato l'SDK.

  3. Puoi trovare il codice dell'app di esempio in
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    Il codice dell'app di esempio per gli ancoraggi cloud permanenti è tra
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Configurazione della sessione

L'app di esempio esegue le seguenti attività importanti durante la configurazione sessione:

Configura la condivisione dell'ID ancoraggio Cloud

L'app di esempio Cloud Anchors utilizza Firebase per condividere gli ID degli ancoraggi Cloud tra dispositivi mobili. Puoi usare una soluzione diversa nelle tue app.

Per configurare il database Firebase nell'app di esempio:

  1. Segui le istruzioni di Firebase per aggiungere Firebase all'app.
  2. Scarica il file GoogleService-Info.plist generato durante l'aggiunta Firebase alla tua app.
  3. Attiva Firebase Storage per l'esempio:
    • Vai alla console di Firebase e seleziona il progetto per cui hai configurato l'app di esempio.
    • Seleziona il riquadro Database.
    • Nell'opzione Realtime Database, fai clic su Get Started.
    • Si apre il menu Security rules for Realtime Database.
      • Per eseguire l'esempio, seleziona Start in test mode.
      • Tieni presente che se utilizzi Firebase per un'app che prevedi di pubblicare, è necessario utilizzare regole di sicurezza più restrittive.
  4. In Xcode, aggiungi il file GoogleService-Info.plist alla tua app, accanto a Info.plist.

Configurare l'API ARCore

Per utilizzare gli ancoraggi Cloud, devi prima configurare il API ARCore per la tua applicazione.

Esegui aggiornamento pod

L'app CloudAnchorExample viene fornita con un Podfile preconfigurato con L'SDK ARCore e le versioni di iOS necessarie. Per installare queste dipendenze:

  1. Apri una finestra Terminale ed esegui pod update dalla cartella in cui Il progetto Xcode esiste.
    Viene generato un file .xcworkspace che utilizzerai in seguito per creare e eseguire l'app.

Vedi Aggiungere l'SDK ARCore all'app per informazioni dettagliate sulla configurazione di Podfile nelle tue app.

  1. Apri il file .xcworkspace del progetto in Xcode.

    Per evitare errori di generazione, assicurati di creare da .xcworkspace e non il file .xcodeproj.

Modificare l'ID dell'app bundle

In Xcode, modifica l'ID pacchetto dell'app in modo da poter firmare l'app con il tuo team.

Crea ed esegui l'app

  1. Collega il dispositivo e avvia l'app in Xcode.

  2. (Facoltativo) Se crei ed esegui l'app di esempio, vedi quanto segue per maggiori dettagli sull'uso dell'app per ospitare e risolvere gli ancoraggi Cloud.

Prova l'app di esempio

  1. Crea ed esegui l'app di esempio dal file .xcworkspace per avviarla sul tuo dispositivo.

  2. Se richiesto, concedi le autorizzazioni di accesso alla fotocamera all'app. ARKit quindi inizia a rilevare gli aerei davanti alla videocamera.

  3. Tocca HOST per attivare la modalità hosting. Un codice stanza per la condivisione degli ancoraggi ospitati viene generato e visualizzato sullo schermo.

  4. Tocca un aereo per iniziare a ospitare un cloud anchor lì.

    • L'app posiziona un oggetto Andy Android sull'aereo e fissa un ancoraggio che le sono assegnati.
    • Viene inviata una richiesta di host all'endpoint cloud dell'API ARCore. L'organizzatore include i dati che rappresentano la posizione dell'ancoraggio rispetto caratteristiche visive nelle vicinanze.
    • Una volta ospitato, l'anchor riceve un ID utilizzato per risolvere i problemi del cloud ancorati in questo spazio.

  5. Tocca RESOLVE e inserisci un codice stanza per accedere in precedenza ha ospitato gli ancoraggi Cloud per questa stanza utilizzando lo stesso dispositivo o uno diverso.

    • Viene inviata una richiesta di risoluzione all'endpoint cloud dell'API ARCore.
    • La richiesta di risoluzione include un ID Cloud anchor. Se l'ID corrisponde a un l'ancoraggio ospitato e la localizzazione hanno esito positivo, il server restituisce trasformata dell'ancoraggio nelle coordinate locali.
    • L'app di esempio utilizza la trasformazione per aggiungere l'ancoraggio alla scena e eseguire il rendering di oggetti virtuali collegati.

Aggiungi l'SDK ARCore alle tue app

Nelle tue app dovrai aggiornare Podfile per includere le SDK ARCore e controllo delle versioni di iOS supportato. Per:

  1. Aggiungi i seguenti platform e pod al tuo Podfile del progetto:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
  1. Apri una finestra Terminale ed esegui pod update dalla cartella in cui che il tuo progetto Xcode esista.
    Viene generato un file .xcworkspace che puoi utilizzare per creare e eseguire l'app.

Ancoraggi al cloud permanenti

Come descritto in Ospitare un ancoraggio cloud con persistenza, puoi dare all'ancoraggio cloud una durata fino a 365 giorni. Codice campione per l'utilizzo di anchor cloud permanenti è disponibile in /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample nell'SDK ARCore per iOS da GitHub.

Passaggi successivi