Esegui app AR nell'emulatore Android

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

Configurazione dell'ambiente di sviluppo

Requisiti software:

Scaricare Android Studio e gli strumenti 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, quindi Show Package Details.

    Sotto la versione di Android appropriata, seleziona:
    API di Google Intel x86 Atom System Image API di livello 27 o 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.

Crea un dispositivo virtuale con supporto AR

Per ulteriori informazioni, consulta le istruzioni di Android Studio relative alla creazione di un dispositivo virtuale.

Creare un nuovo dispositivo virtuale Android

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

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

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

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

    • Sebbene i dispositivi fisici ARCore siano supportati con livello API 24 o versioni successive, il supporto di Android Emulator richiede l'API di livello 27 o versioni successive.

    • Sono supportate solo architetture di emulatori Android basate su x86. Al momento non sono supportate altre architetture come arm64-v8a e armeabi-v7.

  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 la durata di visualizzazione media.

Esegui l'app

Testa un'app ARCore su un dispositivo virtuale supportato da AR nell'emulatore. A tale scopo, segui le istruzioni di Android Studio per eseguire un'app nell'emulatore di Android.

Aggiorna Google Play Services per AR

È probabile che la versione di Google Play Services per AR nell'emulatore sia obsoleta. Segui queste istruzioni per aggiornarlo:

  1. Scarica la versione più recente di Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk dalla pagina delle release di GitHub.

  2. Installa l'APK scaricato in ogni durata di visualizzazione media che intendi utilizzare:

    Avvia la durata di visualizzazione media desiderata, quindi trascina l'APK scaricato dalla cartella di sistema (ad esempio Downloads) nell'emulatore in esecuzione oppure installalo utilizzando adb mentre il dispositivo virtuale è in esecuzione: 

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

Ripeti questi passaggi per le eventuali durate di visualizzazione aggiuntive che intendi utilizzare.

Controlla la scena virtuale

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

Spostare la videocamera virtuale

Tieni premuto Shift per accedere ai controlli di movimento della videocamera. Utilizza i seguenti controlli per spostare la videocamera:

Azione Cosa fare
Sposta a sinistra o a destra Tieni premuto Maiusc + premi A o D
Sposta in basso o in alto Tieni premuto Maiusc + premi Q o E
Sposta avanti o indietro Tieni premuto Maiusc + premi W o S
Modifica l'orientamento del dispositivo Tieni premuto Maiusc e sposta il mouse

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

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

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. Ci sono due posizioni delle immagini, una sulla parete e una sul tavolo.

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

Suggerimenti per la risoluzione dei problemi

  • Se viene avviata l'app ARCore e viene visualizzato il messaggio "Questo dispositivo non supporta AR", controlla la revisione dell'immagine di sistema. Assicurati di utilizzare l'API Livello 27 Revisione 4 o successiva.

  • Se l'app ARCore non riesce ad aprire la videocamera all'avvio, assicurati che Camera Back sia impostato su VirtualScene, come descritto nella procedura di configurazione precedente.

  • Se l'app ARCore non si apre e viene visualizzato il messaggio di errore "Impossibile creare una sessione AR", controlla il log dell'app. Se trovi un elemento java.lang.UnsatisfiedLinkError con un messaggio che contiene /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), è possibile che tu abbia installato la versione errata dell'APK di Google Play Services per AR. Crea un nuovo dispositivo virtuale e installa la versione x86.