Abilita l'API Geospatial per la tua app Unity (AR Foundation) che ha come target Android

Configura le impostazioni della tua app in modo che possa utilizzare l'API Geospatial.

Prerequisiti

Assicurati di comprendere i concetti fondamentali della realtà aumentata e su come configurare una sessione ARCore prima di procedere.

Consulta le Introduzione all'API Geospatial per ulteriori informazioni informazioni sull'API Geospatial.

Se non hai familiarità con lo sviluppo di ARCore, consulta la Guida introduttiva. per informazioni su requisiti software e hardware, prerequisiti e e altre informazioni specifiche per le piattaforme utilizzate.

Per usare l'API ARCore Geospatial, il tuo progetto deve supportare Elementi di base AR e le ARCore Extensions per AR Foundation.

Abilita l'API ARCore

Prima di utilizzare il sistema di posizionamento visivo (VPS) nella tua app, devi Abilitare l'API ARCore in un progetto Google Cloud nuovo o esistente. Questo servizio è responsabile l'hosting, l'archiviazione e la risoluzione degli ancoraggi geospaziali.

È preferibile l'autorizzazione senza chiave, ma è supportata anche l'autorizzazione delle chiavi API.

Aggiungi le librerie richieste alla tua app

Dopo aver autorizzato l'app a chiamare l'API ARCore, devi aggiungere librerie a attivare le funzionalità geospaziali nella tua app.

  1. Vai a Modifica > Impostazioni progetto > Gestione dei plug-in XR > Estensioni ARCore.
  2. In Funzionalità facoltative, seleziona Geospaziale.

Attiva le funzionalità geospaziali nella configurazione della sessione

Una volta attivata la funzionalità geospaziale nell'app, attivala nella configurazione della sessione AR dell'app, in modo che possa comunicare con l'API ARCore:

  1. Assicurati che la cartella Assets del progetto contenga un oggetto eseguibile tramite script ARCoreextensionsConfig. Per crearne uno, fai clic con il tasto destro del mouse sul riquadro Asset e seleziona Crea > XR > Configurazione delle estensioni ARCore.

  2. Seleziona l'oggetto scriptabile ARCoreExtensionsConfig nella cartella ARCoreExtensionsConfig e imposta la ARCoreExtensionsConfig su ARCoreExtensionsConfig.

  3. Configura l'oggetto di gioco ARCore Extensions in modo da utilizzare la configurazione ARCoreextensionsConfig. Nel riquadro Gerarchia, individua l'oggetto di gioco ARCore Extensions creato durante la configurazione iniziale di ARCore Extensions e collega il campo ARCore Extensions Config all'oggetto scriptable ARCore ExtensionsConfig nella cartella Asset.

Chiedi all'utente di consentire l'utilizzo dei dati del dispositivo

Le app che utilizzano l'API ARCore Geospatial devono presentare all'utente una richiesta di riconoscono e consentono l'utilizzo dei dati provenienti dal loro dispositivo. Consulta Requisiti di privacy dell'utente per ulteriori informazioni. informazioni.

Verifica la compatibilità del dispositivo

Non tutti i dispositivi che supportano ARCore supportano anche l'API Geospatial. Per verificare il dispositivo dell'utente per verificare la compatibilità, chiama AREarthManager.IsGeospatialModeSupported() Se restituisce FeatureSupported.Unsupported, non tentare di configurare durante la sessione.

Chiedi all'utente le autorizzazioni di accesso alla posizione in fase di runtime

ARCore Extensions richiede automaticamente le autorizzazioni di accesso alla posizione appropriate quando la modalità geospaziale è attiva in ARCoreExtensions.Update(). Se l'utente non concede l'autorizzazione di accesso alla posizione esatta, la sessione non viene ripresa e "autorizzazione non concessa" viene generato un errore. Questa è una chiusura e richiede un riavvio per attivare di nuovo la richiesta di autorizzazione.

Verificare la disponibilità geospaziale nella posizione attuale del dispositivo

Poiché l'API Geospaziale utilizza una combinazione di VPS e GPS per determinare una posa geospaziale, l'API può essere utilizzata purché il dispositivo sia in grado di determinare la propria posizione. Nelle aree con una scarsa precisione GPS, come gli spazi interni e gli ambienti urbani ad alta densità, l'API si baserà sulla copertura VPS per generare pose ad alta precisione. In condizioni tipiche, la precisione di posizionamento dei VPS è di circa 5 metri e una precisione di rotazione di 5 gradi. Utilizza AREarthManager.CheckVpsAvailability() per determinare se una determinata località ha una copertura VPS.

L'API Geospatial può essere utilizzata anche in aree che non hanno una copertura VPS. In ambienti esterni con poche ostruzioni dall'alto o nessuna, il GPS può essere sufficiente per generare una posa con un'elevata precisione.

Passaggi successivi