Execute aplicativos AR no Android Emulator

Use o emulador Android para cenários de teste AR sem um dispositivo físico. O Android Emulator permite que você execute aplicativos ARCore em um ambiente virtual com um dispositivo emulado que você controla.

Configure seu ambiente de desenvolvimento

Requisitos de software:

Obtenha ferramentas Android Studio e SDK para ARCore

  1. Instale Android Estúdio 3.1 ou posterior.

  2. Em Android Studio, vá para Preferences > Appearance and Behavior > System Settings > Android SDK .

  3. Selecione a SDK Platforms guia e verificar Show Package Details .

    Na versão apropriada do Android, selecione:
    Google APIs Intel x86 Atom Sistema Imagem API Nível 27 ou mais tarde.

  4. Selecione o SDK Tools guia e adicione Android Emulator 27.2.9 ou posterior.

  5. Clique OK para instalar os pacotes e ferramentas selecionadas.

  6. Clique OK novamente para mudanças confirmar.

  7. Accept o contrato de licença para a instalação do componente.

  8. Clique Finish .

Crie um dispositivo virtual com suporte de RA

Para mais informações, consulte as instruções Android Studio para criar um dispositivo virtual .

Crie um novo Android Virtual Device (AVD)

  1. Em Android Estúdio abrir o AVD Manager clicando em Tools > AVD Manager .

  2. Clique Create Virtual Device , na parte inferior da caixa de diálogo AVD Manager.

  3. Escolha ou crie o seu perfil de hardware de telefone desejado e selecionar Next .

  4. Selecione um x86 ou x86_64 imagem do sistema em execução API Nível 27 ou mais tarde e selecione Next .

    • Embora os dispositivos ARCore físicos sejam compatíveis com API de nível 24 ou posterior, o suporte do Android Emulator requer API de nível 27 ou posterior.

    • Apenas arquiteturas de emulador Android baseadas em x86 são suportadas. Outras arquiteturas, como arm64-v8a , armeabi-v7 , não são suportadas atualmente.

  5. Verifique se o seu dispositivo virtual está configurado corretamente:

    • Clique Show Advanced Settings .

    • Certifique-se de que a Camera Back está definido para VirtualScene .

  6. Clique Finish para criar o seu AVD.

Execute seu aplicativo

Teste um aplicativo ARCore em um dispositivo virtual compatível com AR no emulador. Para fazer isso, você pode seguir as instruções Android Studio para executar um aplicativo no emulador Android .

Atualize o Google Play Services para AR

A versão do Google Play Services para AR no emulador provavelmente está desatualizada. Siga estas instruções para atualizá-lo:

  1. Baixe a ultima Google_Play_Services_for_AR_1.28.0_x86_for_emulator.apk do GitHub lançamentos página.

  2. Instale o APK baixado em cada AVD que deseja usar:

    Comece o AVD desejado, em seguida, arraste o APK baixado a partir da pasta do sistema (ou seja, Downloads ) para o emulador em execução, ou instalá-lo usando adb enquanto o dispositivo virtual está em execução:

    adb install -r Google_Play_Services_for_AR_1.28.0_x86_for_emulator.apk

Repita o processo dessas etapas para quaisquer AVDs adicionais que você gostaria de usar.

Controle a cena virtual

Quando seu aplicativo se conectar ao ARCore, você verá uma sobreposição que descreve como controlar a câmera e uma barra de status abaixo da janela do emulador.

Mova a câmera virtual

Mantenha pressionada Option (MacOS) ou Alt (Linux ou Windows) para controles de movimento de câmera de acesso. Use os seguintes controles para mover a câmera:

Plataforma Açao O que fazer
Mac OS Mover para a esquerda ou direita Reter Opção + pressione A ou D
Mova para baixo ou para cima Segure Option + prima Q ou E
Avançar ou voltar Reter Opção + prima W ou S
Mudar a orientação do dispositivo Segure Option + rato movimento
Linux ou Windows Mover para a esquerda ou direita Segurar Alt + pressione A ou D
Mova para baixo ou para cima Segure Alt + prima Q ou E
Avançar ou voltar Reter Alt + prima W ou S
Mudar a orientação do dispositivo Segure Alt + rato movimento

Solte Option ou Alt para voltar ao modo interativo no emulador.

Use o Virtual Sensors guia em controles estendidos para o posicionamento dispositivo mais preciso.

Adicione imagens aumentadas à cena

Carregar imagens para o emulador é simulada ambiente para teste Aumentada Imagens .

Use o Camera guia em Extended controls para adicionar ou modificar Scene images . Existem duas localizações de imagens, uma na parede e outra na mesa.

Para visualizar esses locais de imagem na cena, inicie o emulador e mova a câmera para a área de jantar através da porta atrás da posição inicial da câmera.

Dicas de soluções de problemas

  • Se o seu aplicativo ARCore for iniciado e você vir uma mensagem "Este dispositivo não suporta AR", verifique a revisão na imagem do sistema. Certifique-se de que você está usando API Nível 27 Revisão 4 ou posterior.

  • Se seu aplicativo Arcore não abrir a câmera quando for lançado, certifique-se de que Camera Back está definido para VirtualScene , conforme descrito nas etapas de configuração acima .

  • Se o aplicativo ARCore não abrir com a mensagem de erro "Falha ao criar sessão AR", verifique o log do aplicativo. Se você encontrar um java.lang.UnsatisfiedLinkError com uma mensagem que contém /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) , você pode ter instalado a versão errada da peça Serviços do Google para AR apk. Crie um novo dispositivo virtual e instale a versão x86.