ARCore torna alla conferenza Google I/O del 10 maggio! Registrati ora.

Guida rapida per Android

Per iniziare a utilizzare ARCore con Android, puoi eseguire l'app di esempio hello_ar_kotlin o hello_ar_java inclusa nell'SDK ARCore. Queste app di esempio utilizzano OpenGL, un'interfaccia di programmazione per il rendering di immagini vettoriali 2D e 3D. Le app visualizzano i piani rilevati e consentono all'utente di toccare un piano per posizionare un modello 3D.

Configurazione dell'ambiente di sviluppo

Apri un progetto di esempio

  1. In Android Studio, clona il repository GitHub di ARCore SDK.

    Ci sono molti modi per farlo:

    • Per un'installazione esistente di Android Studio:

      • Dal menu Git, seleziona Clone.
      • Nel menu a discesa Version control, seleziona Git come sistema di controllo della versione.

      • Nel campo URL, inserisci il seguente URL al repository GitHub di ARCore:

        https://github.com/google-ar/arcore-android-sdk.git

    • Puoi anche aprire Terminal ed eseguire il comando git clone come segue:

      git clone https://github.com/google-ar/arcore-android-sdk.git

  2. Apri uno dei progetti di esempio nel seguente modo (devi aprire esplicitamente un progetto per crearlo ed eseguirlo).

    • Dal menu File, seleziona Open.
    • Nella cartella arcore-android-sdk/samples, seleziona la cartella hello_ar_kotlin o hello_ar_java e fai clic su Open.

Prepara il dispositivo o l'emulatore

Puoi eseguire le app AR su un dispositivo supportato o nell'emulatore di Android. Prima di eseguire l'app devi aggiornare Google Play Services per AR nell'emulatore. Per ulteriori informazioni, consulta Eseguire le app di AR nell'emulatore di Android .

Esegui l'esempio

Assicurati che il dispositivo Android sia connesso alla macchina di sviluppo e fai clic su Run in Android Studio.

Android Studio integra il progetto in un APK di cui è possibile eseguire il debug, quindi installa l'APK e poi esegue l'app sul dispositivo. Per ulteriori informazioni, consulta la pagina Creare ed eseguire la tua app.

È possibile che ti venga chiesto di installare o aggiornare Google Play Services per AR se manca o non è aggiornato. Seleziona CONTINUE per installarla dal Google Play Store oppure aggiornala manualmente come descritto in Aggiornare Google Play Services per AR.

L'app hello_ar_java ti consente di posizionare un pedone ARCore tridimensionale sulle piattaforme AR rilevate. Si implementa con Android GL SurfaceView, che viene utilizzato per il rendering dell'anteprima della fotocamera e di oggetti AR di base come piani e 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 Instant Placement consente all'utente di posizionare un oggetto AR sullo schermo senza dover attendere che ARCore rilevi la geometrica della superficie. Il posizionamento degli oggetti viene perfezionato in tempo reale man mano che l'utente si sposta ulteriormente 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 con precisione l'oggetto virtuale.

Una volta che ARCore rileva la geometria della superficie e stabilisce una tracciabile nell'area geografica in cui viene posizionato l'oggetto, la posa dell'oggetto viene aggiornata automaticamente per una maggiore precisione.

Posizionamento istantaneo

Nella Figura 1, il posizionamento istantaneo è disabilitato e la geometria della superficie non è definita. Gli oggetti collocati sul pavimento a destra del tavolo da biliardo (quattro piccoli punti blu) appaiono sconvolti; le loro posizioni non sono definite.

Nella figura 2, il posizionamento istantaneo è abilitato dal menu sotto l'icona a forma di ingranaggio.

Nella figura 3, con il posizionamento istantaneo attivato, un nuovo oggetto viene inserito nella scena. Appare in scala di grigi, anziché colorata, per indicare che non è ancora stata corretta per una posizione accurata.

Nella Figura 4, il nuovo oggetto diventa colorato e la sua posa è accurata quando viene rilevata la Geometria della superficie (descritta dalle linee della griglia tracciabili).

Utilizza profondità

Quando è attiva la profondità, ARCore prende in considerazione la geometrica e la posizione degli oggetti nella scena, quindi calcola la posizione degli oggetti inseriti nella scena rispetto agli altri oggetti della scena. Consente di occultare gli oggetti posizionati nella scena e dona un realismo alla tua app.

Posizionamento istantaneo

Nella figura 1, Profondità è disabilitata. Viene posizionato un oggetto sotto la tabella dei pool.

Nella Figura 2, mentre il dispositivo si sposta sulla tabella di biliardo, l'oggetto sembra seguire il dispositivo indipendentemente dagli oggetti nella scena.

Nella figura 3, la profondità è attivata.

Nella figura 4, l'oggetto appare ora occupato dalla tabella del biliardo mentre il dispositivo si muove.

Passaggi successivi