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 o ambiente de desenvolvimento

Requisitos de software:

Baixar o Android Studio e as ferramentas do SDK para o 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 adequada do Android, 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 AR

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

Criar um 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 Smartphone desejado e selecione Next.

  4. Selecione uma imagem do sistema x86 ou x86_64 que execute o nível da API 27 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 do 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. Outras arquiteturas, como arm64-v8a e armeabi-v7, não são compatíveis no momento.

  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 seu AVD.

Executar o app

Teste um app do ARCore em um dispositivo virtual compatível com AR 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.50.0_x86_for_emulator.apk na página de versões do GitHub.

  2. Instale o APK baixado 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.50.0_x86_for_emulator.apk

Repita essas etapas para todas as outras AVDs que você quiser usar.

Controlar a cena virtual

Quando o app se conecta ao ARCore, uma sobreposição descreve como controlar a câmera, e uma barra de status aparece abaixo da janela do emulador.

Mover a câmera virtual

Pressione e mantenha pressionado 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 baixo ou para cima 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 pressionada a tecla Shift e mova o mouse.

Solte Shift para voltar 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 as Imagens aumentadas.

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

Para ver 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 é compatível com RA", verifique a revisão na imagem do sistema. Confira se você está usando o nível 27 da API, revisão 4 ou mais recente.

  • Se o app ARCore não abrir a câmera ao ser 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 "Falha ao criar a sessão de AR", verifique o registro do app. 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 RA. Crie um novo dispositivo virtual e instale a versão x86.