Attivare l'AR nell'app AR Foundation (solo Android)

Attiva l'AR per usare le funzionalità di realtà aumentata nella tua app nuova o esistente.

Configura l'app in modo che sia richiesta AR o AR opzionale

Per risparmiare spazio sui singoli dispositivi, tutte le funzionalità AR vengono memorizzate in un'app denominata Google Play Services per AR che viene aggiornata separatamente dal Play Store. Le app Android che utilizzano funzionalità AR comunicano con Google Play Services per AR tramite l'SDK ARCore. Un'app che supporta le funzionalità AR può essere configurata in due modi: AR obbligatorio e AR opzionale. Questa designazione determina il modo in cui l'app interagisce con Google Play Services per l'app AR.

Un'app Richiesta AR non può funzionare senza ARCore. Richiede un dispositivo supportato da ARCore su cui sia installato Google Play Services per AR.

  • Il Google Play Store renderà disponibili solo le app AR richieste sui dispositivi che supportano ARCore.
  • Quando gli utenti installano un'app AR richiesta, il Google Play Store installa automaticamente Google Play Services per AR sul loro dispositivo. Tuttavia, l'app deve comunque eseguire controlli di runtime aggiuntivi nel caso in cui Google Play Services per AR non sia aggiornato o sia stato disinstallato manualmente.

Un'app AR facoltativa utilizza ARCore per migliorare le funzionalità esistenti. Dispone di funzionalità AR facoltative che vengono attivate soltanto sui dispositivi supportati da ARCore su cui è installato Google Play Services per AR.

  • Le app AR facoltative possono essere installate ed eseguite su dispositivi che non supportano ARCore.
  • Quando gli utenti installano un'app AR facoltativa, il Google Play Store non installerà automaticamente Google Play Services per AR sul dispositivo.
AR richiestaAR (facoltativo)
Utilizzo della funzionalità AR Per le funzionalità di base dell'app è necessario ARCore. ARCore migliora la funzionalità della tua app. L'app può essere eseguita senza il supporto ARCore.
Visibilità sul Play Store La tua app è elencata nel Play Store soltanto sui dispositivi che supportano ARCore. La tua app segue le normali procedure di creazione delle schede.
Metodo di installazione di Google Play Services per AR Il Play Store installa Google Play Services per AR insieme alla tua app. L'app utilizza la coroutine ARSession.Install() per scaricare e installare ARCore.
Requisiti Android minSdkVersion Android 7.0 (livello API 24) Android 4.4 (livello API 19), sebbene l'esecuzione di funzionalità AR richieda almeno Android 7.0 (livello API 24)
Devi utilizzare ARSession.state per verificare il supporto di ARCore e lo stato dell'installazione
Deve utilizzare la coroutine ARSession.Install() per installare Google Play Services per AR

Rendere richiesta l'AR per l'app

Android

  1. Vai a Edit > Project Settings > XR Plug-in Management > ARCore. L'opzione Requirement è impostata su Required per impostazione predefinita.

  2. Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'icona di Android.

  3. Nel campo Other Settings > Identification, specifica un valore Minimum API Level di 24 o superiore.

iOS

  1. Vai a Edit > Project Settings > XR Plug-in Management > ARKit. L'opzione Requirement è impostata su Required per impostazione predefinita.

  2. Fai clic su Edit > Project Settings > Player e seleziona la scheda con l'icona iOS.

  3. Sotto Other Settings > Configuration, specifica il Target minimum iOS Version per la tua app.

Rendi facoltativa l'app AR

Android

  1. Vai a Edit > Project Settings > XR Plug-in Management > ARCore.

  2. Dal menu a discesa Requirement, seleziona Optional per impostare l'app su AR facoltativa.

  3. Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'icona di Android.

  4. Nel campo Other Settings > Identification, specifica un valore Minimum API Level di 24 o superiore.

iOS

  1. Vai a Edit > Project Settings > XR Plug-in Management > ARKit.

  2. Dal menu a discesa Requirement, seleziona Optional per impostare l'app su AR (facoltativo).

  3. Fai clic su Edit > Project Settings > Player e seleziona la scheda con l'icona iOS.

  4. Sotto Other Settings > Configuration, specifica il Target minimum iOS Version per la tua app.

Esegui i controlli di runtime

Verificare se Google Play Services per AR è installato

Entrambe le app AR obbligatorie e AR facoltative devono utilizzare la coroutine ARSession.Install() prima di creare una sessione ARCore per verificare se è ancora installata una versione compatibile di Google Play Services per AR e per garantire che tutti i dati del profilo del dispositivo ARCore richiesti siano stati scaricati.

Durante il runtime, le app con richiesta AR eseguono automaticamente controlli di runtime per garantire che il dispositivo di destinazione:

  • Supporta ARCore
  • Ha installato Google Play Services for AR. Se non è installata (probabilmente perché è stata rimossa dall'utente) o la versione è troppo vecchia, l'app chiederà all'utente di installarla o aggiornarla.
  • Dispone di dati del profilo del dispositivo ARCore aggiornati. Se sono obsoleti, l'app scaricherà nuovi dati.

Imposta ARSession.attemptUpdate su false per disattivare questi controlli predefiniti. La tua app deve comunque gestire queste condizioni:

Condizione Azione
Il dispositivo non supporta ARCore. Nasconde le funzionalità correlate all'AR.
Il dispositivo supporta ARCore, ma i dati del profilo del dispositivo Google Play Services for AR e/o ARCore non sono installati o obsoleti. Chiedi all'utente di installare o aggiornare i dati del profilo del dispositivo Google Play Services for AR e/o ARCore chiamando ARSession.Install().
Il dispositivo supporta ARCore e Google Play Services for AR; i dati del profilo del dispositivo ARCore sono installati e aggiornati. Crea un elemento Session ARCore e inizia a utilizzare ARCore.

Puoi anche controllare la ARSession.state per gli stati di installazione e assistenza.

Rispettare i requisiti di privacy degli utenti

Per pubblicare l'app sul Play Store, assicurati che sia conforme ai requisiti per la privacy degli utenti di ARCore.

Passaggi successivi