Attiva l'AR per usare le funzionalità di realtà aumentata nell'app nuova o esistente.
Configura la tua app in modo che sia AR obbligatoria 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 le 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 l'app Google Play Services per AR.
Un'app AR richiesta non può funzionare senza ARCore. Richiede un dispositivo supportato da ARCore su cui è installato Google Play Services per AR.
- Il Google Play Store renderà disponibili le app richieste in AR solo 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, la tua app deve comunque eseguire ulteriori controlli di runtime nel caso in cui Google Play Services per AR non sia aggiornato o sia stata disinstallata manualmente.
Un'app AR facoltativa utilizza ARCore per migliorare le funzionalità esistenti. Ha funzionalità AR facoltative che sono attivate solo 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 obbligatorio | AR facoltativo | |
|---|---|---|
| Utilizzo delle funzionalità AR | La tua app richiede ARCore per le funzionalità di base. | ARCore migliora le funzionalità della tua app. La tua app può essere eseguita senza il supporto di ARCore. |
| Visibilità del Play Store | La tua app è elencata nel Play Store soltanto sui dispositivi che supportano ARCore. | La tua app segue le normali procedure per la pubblicazione delle schede. |
| Metodo di installazione di Google Play Services per AR | Il Play Store installa Google Play Services per AR insieme alla tua app. | La tua app utilizza
la coroutine ARSession.Install()
per scaricare e installare ARCore. |
Requisiti di Android minSdkVersion |
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) |
È necessario usare ARSession.state per verificare il supporto di ARCore e lo stato dell'installazione
|
||
Da utilizzare
la coroutine ARSession.Install()
per installare Google Play Services per AR |
Rendi obbligatorio l'AR per la tua app
Android
Vai a Edit > Project Settings > XR Plug-in Management > ARCore. Requirement è impostato su Required per impostazione predefinita.
Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'app Android .
In Other Settings > Identification, specifica un valore Minimum API Level pari o superiore a
24.
iOS
Vai a Edit > Project Settings > XR Plug-in Management > ARKit. Requirement è impostato su Required per impostazione predefinita.
Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'app .
In Other Settings > Configuration, specifica Target minimum iOS Version per la tua app.
Rendi la tua app facoltativa AR
Android
Vai a Edit > Project Settings > XR Plug-in Management > ARCore.
Dal menu a discesa Requirement, seleziona Optional per impostare l'app come AR facoltativa.
Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'app Android .
In Other Settings > Identification, specifica un valore Minimum API Level pari o superiore a
24.
iOS
Vai a Edit > Project Settings > XR Plug-in Management > ARKit.
Dal menu a discesa Requirement, seleziona Optional per impostare l'app su AR Facoltativo.
Fai clic su Edit > Project Settings > Player, seleziona la scheda con l'app .
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
È necessario utilizzare le app AR richieste e AR facoltative
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 assicurarti che tutti i dati del profilo del dispositivo ARCore richiesti siano stati scaricati.
Durante il runtime, le app richieste in realtà aumentata eseguono automaticamente i controlli di runtime per verifica che il dispositivo target:
- Supporta ARCore
- Ha installato Google Play Services for AR, se non è installata (probabilmente perché è stata rimossa dall'utente) o perché la versione è troppo vecchia, il tuo l'app chiederà all'utente di installarla o aggiornarla.
- Disponga di dati del profilo del dispositivo ARCore aggiornati; se non sono aggiornati, 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à relative all'AR. |
| Il dispositivo supporta ARCore, ma Google Play Services for AR e/o I dati del profilo del dispositivo ARCore non sono installati o non sono aggiornati. | Chiede all'utente di installare o aggiornare Google Play Services for AR e/o
Dati del profilo del dispositivo 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 di installazione e assistenza nel ARSession.state.
Rispettare i requisiti di privacy dell'utente
Per pubblicare la tua app sul Play Store, assicurati che sia conforme alle Requisiti di privacy dell'utente.
Passaggi successivi
- Scopri come configurare una sessione ARCore.