Executar apps de RA no Android Emulator

Use o Android Emulator para testar cenários de RA sem um dispositivo físico. O Android Emulator permite executar apps do ARCore em um ambiente virtual com um dispositivo emulado que você controla.

Configurar seu ambiente de desenvolvimento

Requisitos de software:

Instalar o Android Studio e as ferramentas do SDK para ARCore

  1. Instale o Android Studio 3.1 ou uma versão mais recente.

  2. No Android Studio, acesse Preferences > Appearance and Behavior > System Settings > Android SDK.

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

    Na versão apropriada do Android, selecione:
    APIs do Google Intel x86 Atom System Image API de nível 27 ou mais recente.

  4. Selecione a guia SDK Tools e adicione Android Emulator 27.2.9 ou mais recente.

  5. Clique em OK para instalar os pacotes e ferramentas selecionados.

  6. Clique em OK novamente para confirmar as mudanças.

  7. Accept o contrato de licença do Instalador de componentes.

  8. Clique em Finish.

Criar um dispositivo virtual compatível com RA

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

Criar um Dispositivo virtual Android (AVD, na sigla em inglês)

  1. No Android Studio, clique em Tools > Device Manager para abrir o Gerenciador de dispositivos.

  2. Clique em Create Device na parte superior do painel Gerenciador de dispositivos.

  3. Selecione ou crie o perfil de hardware Phone desejado e selecione Next.

  4. Selecione uma imagem de sistema x86 ou x86_64 com a API de nível 27 ou mais recente e selecione Next.

    • Embora dispositivos físicos ARCore tenham suporte à API de nível 24 ou mais recente, o suporte ao Android Emulator requer o nível 27 ou mais recente da API.

    • Somente arquiteturas do Android Emulator baseadas em x86 são compatíveis. No momento, outras arquiteturas, como arm64-v8a e armeabi-v7, não têm suporte.

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

    • Clique em Show Advanced Settings.

    • Confira se Camera Back está definido como VirtualScene.

  6. Clique em Finish para criar seu AVD.

Executar o app

Testar um app ARCore em um dispositivo virtual com suporte de RA no emulador. Para fazer isso, siga as instruções do Android Studio em Executar um app no Android Emulator.

Atualizar o Google Play Services para RA

A versão do Google Play Services para RA no emulador provavelmente está desatualizada. Siga estas instruções para fazer a atualização:

  1. Faça o download do Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk mais recente na página de versões do GitHub.

  2. Instale o APK transferido por download em cada AVD que você quer usar:

    Inicie o AVD desejado e arraste o APK transferido por download da pasta do sistema. Por exemplo, Downloads) no emulador em execução, ou instale-o usando adb enquanto o dispositivo virtual estiver em execução:

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

Repita essas etapas para qualquer AVD adicional que você queira usar.

Controlar a cena virtual

Quando o app se conectar ao ARCore, você vai ver uma sobreposição descrevendo como controlar a câmera e uma barra de status abaixo da janela do emulador.

Mover a câmera virtual

Toque em Shift e pressione para acessar os controles de movimento da câmera. Use os seguintes controles para mover a câmera:

Ação O que fazer
Mover para a esquerda ou direita Mantenha pressionada a tecla Shift e pressione A ou D
Mover para baixo ou para cima Mantenha pressionada a tecla Shift + pressione Q ou E
Mover para a frente ou para trás Mantenha pressionada a tecla Shift + pressione W ou S
Mudar orientação do dispositivo Mantenha pressionada a tecla Shift e mova o mouse

Solte Shift para retornar ao modo interativo no emulador.

Use a guia Virtual Sensors em Extended controls para ter um posicionamento mais preciso do dispositivo.

Adicionar imagens aumentadas à cena

Carregue imagens no ambiente simulado do emulador para testar as imagens aumentadas.

Use a guia Camera em Extended controls para adicionar ou modificar Scene images. Há dois locais de imagens, um na parede e outro na mesa.

Para conferir esses locais das imagens na cena, inicie o emulador e mova a câmera até a área da sala de jantar pela porta atrás da posição inicial da câmera.

Dicas para solução de problemas

  • Se o app ARCore for iniciado e você vir a mensagem "Este dispositivo não oferece suporte a RA", verifique a revisão na imagem do sistema. Verifique se você está usando a API de nível 27, revisão 4 ou mais recente.

  • Se o app ARCore não abrir a câmera quando for iniciado, verifique se Camera Back está definido como VirtualScene, conforme descrito nas etapas de configuração acima.

  • Se o app ARCore falhar ao abrir com a mensagem de erro "Failed to create AR session", verifique o registro do aplicativo. Se você encontrar um java.lang.UnsatisfiedLinkError com uma mensagem que contenha /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), talvez tenha instalado a versão errada do APK do Google Play Services para AR. Crie um novo dispositivo virtual e instale a versão x86.