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:
Android Studio 3.1 ou mais recente.
Android Emulator 27.2.9 ou mais recente.
Conferir o Android Studio e as ferramentas do SDK para o ARCore
Instale o Android Studio 3.1 ou mais recente.
No Android Studio, acesse Preferences > Appearance and Behavior > System Settings > Android SDK.
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.Selecione a guia SDK Tools e adicione Android Emulator 27.2.9 ou uma versão mais recente.
Clique em OK para instalar os pacotes e ferramentas selecionados.
Clique em OK novamente para confirmar as mudanças.
Accept o contrato de licença do instalador de componentes.
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)
No Android Studio, abra o Device Manager clicando em Tools > Device Manager.
Clique em Create Device, na parte de cima do painel Gerenciador de dispositivos.
Selecione ou crie o perfil de hardware do smartphone e selecione Next.
Selecione uma imagem do sistema
x86oux86_64com 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-v8aearmeabi-v7.
Verifique se o dispositivo virtual está configurado corretamente:
Clique em Show Advanced Settings.
Verifique se Camera Back está definido como VirtualScene.
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:
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.
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
adbenquanto 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.UnsatisfiedLinkErrorcom 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.