Per iniziare a utilizzare ARCore con Android, puoi eseguire App di esempio hello_ar_kotlin o hello_ar_java inclusa in ARCore l'SDK. Queste app di esempio utilizzano OpenGL, una interfaccia di programmazione per il rendering di grafica vettoriale 2D e 3D. Vengono visualizzate le app a qualsiasi piano rilevato e consentire all'utente di toccare un aereo per posizionare un modello 3D.
Configurazione dell'ambiente di sviluppo
Installa Android Studio. versione 3.1 o successive con Android SDK Platform versione 7.0 (livello API 24) o superiore.
Se non hai mai utilizzato Android, consulta: Creazione della prima app per Android.
Apri un progetto di esempio
In Android Studio, clona il repository GitHub dell'SDK ARCore.
Puoi farlo in molti modi:
Per un'installazione consolidata di Android Studio:
- Dal menu Git, seleziona Clone.
- In Version control seleziona Git come sistema di controllo della versione.
Nel campo URL, inserisci il seguente URL all'ARCore GitHub repository:
https://github.com/google-ar/arcore-android-sdk.git
Puoi anche aprire un Terminal ed eseguire il comando
git clone
come che segue:git clone https://github.com/google-ar/arcore-android-sdk.git
Apri uno dei progetti di esempio come segue (devi aprire esplicitamente un progetto per crearlo ed eseguirlo).
- Dal menu File, seleziona Open.
- Nella cartella arcore-android-sdk/samples, seleziona il hello_ar_kotlin o hello_ar_java e fai clic su Open.
Prepara il dispositivo o l'emulatore
Puoi eseguire app AR su un dispositivo supportato oppure nell'emulatore Android. Devi aggiornare Google Play Services per AR sull'emulatore prima di eseguire l'app. Consulta Esegui app AR nell'emulatore Android per scoprire di più informazioni.
Esegui l'esempio
Assicurati che il tuo dispositivo Android sia connesso al computer di sviluppo e fai clic su Run in Android Studio.
Android Studio crea il tuo progetto in un APK di cui può essere eseguito il debug, installa l'APK e quindi esegue l'app sul dispositivo. Per ulteriori informazioni, vedi Crea ed esegui la tua app.
Ti potrebbe essere chiesto di installare o aggiornare Google Play Services per AR se manca o non è aggiornato. Seleziona CONTINUE da cui installarla Google Play Store oppure aggiornalo manualmente come descritto Aggiorna Google Play Services per AR.
L'app hello_ar_java consente di posizionare un pedone ARCore tridimensionale
rilevate superfici dei piani AR. È implementato con Android GL SurfaceView.
utilizzata per visualizzare l'anteprima della fotocamera e gli oggetti AR di base come Aerei
e gli ancoraggi. Il framework di rendering di esempio di hello_ar_java è disponibile in
com/google/ar/core/examples/java/common/samplerender
.
Usa posizionamento istantaneo
L'API per il posizionamento istantaneo consente all'utente di posizionare un oggetto AR sullo schermo senza dover attendere che ARCore rilevi la geometria della superficie. Il posizionamento degli oggetti viene perfezionato in tempo reale man mano che l'utente si sposta nell'ambiente.
Tocca lo schermo per posizionare un oggetto. Assicurati di continuare a spostare il dispositivo dopo aver visto l'oggetto olografico apparire sullo schermo, in modo che ARCore possa ottenere dati sufficienti sull'ambiente circostante per ancorare accuratamente il percorso .
Una volta che ARCore rileva la geometria della superficie e stabilisce un valore tracciabile regione in cui è posizionato l'oggetto, la posa dell'oggetto viene aggiornata automaticamente per l'accuratezza.
Nella figura 1, il posizionamento istantaneo è disattivato e la geometria della superficie non è definita. Oggetti posizionati sul pavimento a destra del tavolo da biliardo (quattro piccoli puntini blu) sembrano stravolte, le loro pose non sono definite.
Nella Figura 2, l'opzione Posizionamento istantaneo è attivata dal menu sotto l'icona a forma di ingranaggio.
Nella figura 3, con il posizionamento istantaneo attivato, nella scena viene inserito un nuovo oggetto. Viene visualizzato in scala di grigi, invece che di colore, per indicare che non è stata corretto per una posizione precisa.
Nella Figura 4, il nuovo oggetto diventa colorato e la sua posa è accurata quando rilevata la geometria della superficie (descritta dalle linee della griglia tracciabili).
Usa profondità
Quando l'opzione Profondità è abilitata, ARCore prende in considerazione la geometria e la posizione degli oggetti nella scena e calcola la posizione oggetti posizionati nella scena rispetto ad altri oggetti presenti nella scena. Consente collocati oggetti in modo che siano occultati da oggetti presenti nella scena e conferisce realismo alla la tua app.
Nella Figura 1, la profondità è disattivata. Un oggetto viene posizionato sotto il tavolo da biliardo.
Nella Figura 2, quando il dispositivo si sposta attorno al tavolo da biliardo, l'oggetto viene visualizzato a seguire il dispositivo a prescindere dagli oggetti nella scena.
Nella Figura 3, è attivata la funzionalità Profondità.
Nella Figura 4, l'oggetto ora appare occulto dal tavolo da biliardo mentre il dispositivo si sposta sulla scena.
Passaggi successivi
- Prova a creare ed eseguire altri progetti di esempio nell'SDK ARCore.
- Dai un'occhiata ai codelab per la realtà aumentata per trovare altri esempi di app che puoi creare ed eseguire.
- Scopri come attivare ARCore nella tua app.
- Esamina le considerazioni sul runtime.
- Leggi le linee guida per la progettazione.