Guida rapida per Android NDK

Configurazione dell'ambiente di sviluppo

  • Installa Android Studio versione 3.1 o successive con Android SDK Platform versione 7.0 (livello API 24) o successive.

  • Prepara Android Studio per lo sviluppo nativo installando il Native Development Kit (NDK) per Android e CMake con SDK Manager. Per ulteriori informazioni, consulta la Guida introduttiva all'NDK.

  • Dovrai scaricare l'SDK ARCore per Android. Puoi:

    • Scarica l'SDK ARCore per Android ed estrailo.

      -oppure-

    • Clona il repository con il comando seguente:

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

Prepara il tuo dispositivo o l'emulatore

Puoi eseguire app AR su un dispositivo supportato o nell'emulatore Android. Prima di eseguire l'app, devi aggiornare Google Play Services per AR dall'emulatore. Consulta l'articolo Esecuzione di app AR in Android Emulator per ulteriori informazioni.

Apri il progetto di esempio

In Android Studio, apri il progetto di esempio hello_ar_c in <ARCore SDK Folder>/samples/hello_ar_c.

Il progetto di esempio ha dipendenze da alcune versioni del software, come Gradle e l'SDK Android. Se le dipendenze richieste non sono installate, Android Studio ti chiederà l'autorizzazione per scaricarle e installarle sulla tua macchina.

Esegui l'esempio

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

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

Mentre muovi il dispositivo, l'app rileva automaticamente superfici piane e disegna una griglia a rombo. Tocca la griglia per posizionare un pedone ARCore tridimensionale sulla superficie.

Utilizza il posizionamento istantaneo

L'API Instant Placement 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. Quando ARCore rileva la posa corretta nell'area in cui è posizionato l'oggetto AR, l'oggetto si aggiorna automaticamente per garantire la massima precisione della posizione.

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.

Posizionamento istantaneo

Nella Figura 1, il posizionamento istantaneo è disattivato e la geometria della superficie non è definita. Gli oggetti posizionati sul pavimento a destra del tavolo da biliardo (quattro puntini blu) appaiono capovolti e le loro posizioni non sono definite.

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

Nella Figura 3, con il posizionamento istantaneo abilitato, nella scena viene inserito un nuovo oggetto. Viene visualizzata in scala di grigi, anziché colorata, per indicare che non è stata ancora corretta per una posa precisa.

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

Usa profondità

Quando l'opzione Profondità è abilitata, ARCore tiene conto della geometria e della posizione degli oggetti nella scena e calcola la posizione degli oggetti posizionati nella scena rispetto ad altri oggetti della scena. Consente di occultare gli oggetti posizionati nella scena e dona realismo alla tua app.

Posizionamento istantaneo

Nella Figura 1, la profondità è disabilitata. Viene posizionato un oggetto sotto il tavolo da biliardo.

Nella Figura 2, mentre il dispositivo si muove intorno al tavolo da biliardo, l'oggetto sembra seguire il dispositivo indipendentemente dagli oggetti nella scena.

Nella Figura 3, la funzionalità Profondità è attivata.

Nella Figura 4, l'oggetto appare ora nascosto dal tavolo da biliardo mentre il dispositivo si muove nella scena.

Passaggi successivi