Esegui app AR nell'emulatore Android

Utilizza l'emulatore Android per testare gli scenari AR senza un dispositivo fisico. L'emulatore Android ti consente di eseguire app ARCore in un ambiente virtuale con un dispositivo virtualizzato che puoi controllare.

Configurazione dell'ambiente di sviluppo

Requisiti software:

Ottenere gli strumenti Android Studio e SDK per ARCore

  1. Installa Android Studio 3.1 o versioni successive.

  2. In Android Studio, vai a Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. Seleziona la scheda SDK Platforms e seleziona Show Package Details.

    Nella versione Android appropriata, seleziona:
    Immagine di sistema Intel x86 Atom per le API di Google, livello API 27 o versioni successive.

  4. Seleziona la scheda SDK Tools e aggiungi Android Emulator 27.2.9 o versioni successive.

  5. Fai clic su OK per installare i pacchetti e gli strumenti selezionati.

  6. Fai di nuovo clic su OK per confermare le modifiche.

  7. Accept il contratto di licenza per il programma di installazione dei componenti.

  8. Fai clic su Finish.

Creare un dispositivo virtuale con il supporto AR

Per ulteriori informazioni, consulta le istruzioni di Android Studio per creare un dispositivo virtuale.

Creare un nuovo dispositivo virtuale Android (AVD)

  1. In Android Studio, apri Gestione dispositivi facendo clic su Tools > Device Manager.

  2. Fai clic su Create Device nella parte superiore del riquadro Gestore dispositivi.

  3. Seleziona o crea il profilo hardware del Telefono che preferisci e seleziona Next.

  4. Seleziona un'immagine di sistema x86 o x86_64 con livello API 27 o versioni successive e seleziona Next.

    • Sebbene i dispositivi ARCore fisici siano supportati a partire dal livello API 24, il supporto di Android Emulator richiede il livello API 27 o versioni successive.

    • Sono supportate solo le architetture dell'emulatore Android basate su x86. Altre architetture come arm64-v8a e armeabi-v7 non sono attualmente supportate.

  5. Verifica che il dispositivo virtuale sia configurato correttamente:

    • Fai clic su Show Advanced Settings.

    • Assicurati che Camera Back sia impostato su VirtualScene.

  6. Fai clic su Finish per creare l'AVD.

Esegui l'app

Testa un'app ARCore su un dispositivo virtuale supportato dall'AR nell'emulatore. Per farlo, puoi seguire le istruzioni di Android Studio per eseguire un'app nell'emulatore Android.

Aggiornare Google Play Services per AR

È probabile che la versione di Google Play Services per AR sull'emulatore non sia aggiornata. Per aggiornarlo, segui queste istruzioni:

  1. Scarica l'ultima versione di Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk dalla pagina GitHub release.

  2. Installa l'APK scaricato in ogni AVD che vuoi utilizzare:

    Avvia l'AVD desiderato, quindi trascina l'APK scaricato dalla cartella di sistema (ad es. Downloads) nell'emulatore in esecuzione o installalo utilizzando adb quando il dispositivo virtuale è in esecuzione: 

    adb install -r Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk

Ripeti questa procedura per tutti gli altri AVD che vuoi utilizzare.

Controllare la scena virtuale

Quando l'app si connette ad ARCore, viene visualizzato un overlay che descrive come controllare la videocamera e una barra di stato sotto la finestra dell'emulatore.

Spostare la fotocamera virtuale

Tieni premuto Shift per accedere ai controlli del movimento della fotocamera. Utilizza i seguenti controlli per muovere la videocamera:

Azione Cosa fare
Spostare a sinistra o a destra Tieni premuto Maiusc + premi A o D
Sposta verso il basso o verso l'alto Tieni premuto Maiusc + premi Q o E
Sposta avanti o indietro Tieni premuto Maiusc + premi W o S
Modificare l'orientamento del dispositivo Tieni premuto Maiusc + muovi il mouse

Rilascia Shift per tornare alla modalità interattiva nell'emulatore.

Utilizza la scheda Virtual Sensors in Controlli avanzati per un posizionamento più preciso del dispositivo.

Aggiungi immagini aumentate alla scena

Carica le immagini nell'ambiente simulato dell'emulatore per testare le immagini aumentate.

Utilizza la scheda Camera in Extended controls per aggiungere o modificare Scene images. Esistono due posizioni delle immagini, una sulla parete e una sul tavolo.

Per visualizzare queste posizioni delle immagini nella scena, avvia l'emulatore, quindi sposta la videocamera nell'area della sala da pranzo attraverso la porta dietro la posizione iniziale della videocamera.

Suggerimenti per la risoluzione dei problemi

  • Se l'app ARCore si avvia e viene visualizzato il messaggio "Questo dispositivo non supporta la realtà aumentata", controlla la revisione dell'immagine di sistema. Assicurati di utilizzare il livello API 27, revisione 4 o successive.

  • Se l'app ARCore non riesce ad aprire la fotocamera al momento dell'avvio, assicurati che Camera Back sia impostato su VirtualScene, come descritto nei passaggi di configurazione precedenti.

  • Se l'app ARCore non si apre con il messaggio di errore "Impossibile creare la sessione AR", controlla il log dell'app. Se trovi un java.lang.UnsatisfiedLinkError con un messaggio contenente /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), potresti aver installato la versione sbagliata dell'apk Google Play Services per AR. Crea un nuovo dispositivo virtuale e installa la versione x86.