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 ARCore em um ambiente virtual com um dispositivo emulado que você controla.

Configurar o ambiente de desenvolvimento

Requisitos de software:

Conferir o Android Studio e as ferramentas do SDK para o ARCore

  1. Instale o Android Studio 3.1 ou 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 do Android adequada, selecione:
    Google APIs Intel x86 Atom System Image nível 27 da API ou mais recente.

  4. Selecione a guia SDK Tools e adicione Android Emulator 27.2.9 ou uma versão 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 com suporte a RA

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

Criar um novo Dispositivo virtual Android (AVD)

  1. No Android Studio, abra o Device Manager clicando em Tools > Device Manager.

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

  3. Selecione ou crie o perfil de hardware do smartphone e selecione Next.

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

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

    • Somente arquiteturas do emulador do Android baseadas em x86 são compatíveis. No momento, não há suporte para outras arquiteturas, como arm64-v8a e armeabi-v7.

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

    • Clique em Show Advanced Settings.

    • Verifique se Camera Back está definido como VirtualScene.

  6. Clique em Finish para criar o AVD.

Executar o app

Teste um app ARCore em um dispositivo virtual com suporte a RA no emulador. Para fazer isso, siga as instruções do Android Studio para 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 atualizar:

  1. Faça o download da versão mais recente do Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk na página releases do GitHub.

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

    Inicie o AVD desejado e arraste o APK baixado da pasta do sistema (por exemplo, Downloads) no emulador em execução ou instale-o usando adb enquanto o dispositivo virtual está em execução: 

    adb install -r Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk

Repita esse processo para todos os AVDs adicionais que você quiser usar.

Controlar a cena virtual

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

Mover a câmera virtual

Toque e pressione Shift 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 cima ou para baixo Mantenha pressionada a tecla Shift e pressione Q ou E
Mover para a frente ou para trás Mantenha pressionada a tecla Shift e pressione W ou S
Mudar a orientação do dispositivo Mantenha Shift + mova o mouse

Libere Shift para retornar ao modo interativo no emulador.

Use a guia Virtual Sensors em Controles estendidos para posicionar o dispositivo com mais precisão.

Adicionar imagens de realidade aumentada à cena

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

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

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

Dicas de solução de problemas

  • Se o app ARCore for iniciado e você receber 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 não abrir com a mensagem de erro "Não foi possível criar a sessão de AR", verifique o registro do app. 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), talvez tenha instalado a versão errada do apk do Google Play Services para RA. Crie um novo dispositivo virtual e instale a versão x86.