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.

Configurare l'app come AR richiesta o AR facoltativa

Per risparmiare spazio sui singoli dispositivi, tutte le funzionalità AR vengono memorizzate in un'app chiamata Google Play Services per AR che viene aggiornata separatamente dal Play Store. Le app per 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 facoltativo. 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 soltanto le app richieste AR sui dispositivi che supportano ARCore.
  • Quando gli utenti installano un'app richiesta in AR, il Google Play Store installa automaticamente Google Play Services per AR sul loro dispositivo. Tuttavia, la tua app deve comunque eseguire controlli di runtime aggiuntivi nel caso in cui Google Play Services per AR non sia aggiornato o sia stata disinstallata manualmente.

Un'app AR Facoltativo 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 installa automaticamente Google Play Services per AR sul dispositivo.
AR richiestaAR (facoltativa)
Utilizzo di funzionalità AR La tua app richiede ARCore per le funzionalità di base. ARCore potenzia la funzionalità della tua app. L'app può essere eseguita senza il supporto ARCore.
Visibilità sul Play Store L'app è elencata nel Play Store soltanto sui dispositivi che supportano ARCore. L'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 ARSession.state per scaricare e installare ARCore.
Requisiti minSdkVersion per Android Android 7.0 (livello API 24) Android 4.4 (livello API 19), sebbene l'esecuzione di qualsiasi funzionalità AR richieda almeno Android 7.0 (livello API 24)
Devi utilizzare ARSession.state per controllare il supporto di ARCore e lo stato dell'installazione

Rendere richiesta l'AR per l'app

Android

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

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

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

iOS

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

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

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

Rendere 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. In Other Settings > Identification, specifica un Minimum API Level con un valore 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 facoltativa.

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

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

Esegui controlli di runtime

Verificare se Google Play Services per AR è installato

Entrambe le app AR richiesta e AR facoltative devono chiamare ARSession.state prima di creare una sessione ARCore per verificare se è ancora installata una versione compatibile di Google Play Services per AR e per verificare che tutti i dati del profilo del dispositivo ARCore richiesti siano stati scaricati.

Durante il runtime, le app richieste con 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 dovrebbe 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. Chiede 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 e i dati del profilo del dispositivo ARCore sono installati e aggiornati. Crea un Session ARCore e inizia a utilizzare ARCore.

Puoi anche controllare gli stati dell'installazione e dell'assistenza nella ARSession.state.

Rispettare i requisiti di privacy dell'utente

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

Passaggi successivi