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 seu ambiente de desenvolvimento
Requisitos de software:
Android Studio 3.1 ou mais recente
Android Emulator 27.2.9 ou mais recente
Instalar o Android Studio e as ferramentas do SDK para 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 apropriada do Android, selecione:
APIs do Google Intel x86 Atom System Image API de nível 27 ou mais recente.Selecione a guia SDK Tools e adicione Android Emulator 27.2.9 ou mais recente.
Clique em OK para instalar os pacotes e ferramentas selecionados.
Clique em OK novamente para confirmar as alterações.
Accept é o contrato de licença do instalador do componente.
Clique em Finish.
Criar um dispositivo virtual compatível com RA
Para ver 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 Gerenciador de dispositivos clicando em Tools > Device Manager.
Clique em Create Device, na parte superior do painel Gerenciador de dispositivos.
Selecione ou crie o perfil de hardware do Telefone desejado e selecione Next.
Selecione uma imagem do sistema
x86
oux86_64
executando a API de nível 27 ou mais recente e selecione Next.Embora os dispositivos físicos do ARCore sejam compatíveis com a API de nível 24 ou mais recente, a compatibilidade com o Android Emulator requer a API de nível 27 ou mais recente.
Somente arquiteturas do Android Emulator com base em x86 são compatíveis. Outras arquiteturas, como
arm64-v8a
earmeabi-v7
, não são compatíveis no momento.
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 seu AVD.
Executar seu app
Testar um app ARCore em um dispositivo virtual compatível com 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 atualizá-lo:
Faça o download do Google_Play_Services_for_AR_1.38.0_x86_for_emulator.apk mais recente na página de versões do GitHub.
Instale o APK transferido por download em cada AVD que você quiser usar:
Inicie o AVD desejado e arraste o APK salvo 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.38.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ê verá uma sobreposição que descreve como controlar a câmera e uma barra de status abaixo da janela do emulador.
Mover a câmera virtual
Pressione e segure 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. |
Alterar a 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 Controles estendidos para um posicionamento mais preciso do dispositivo.
Adicionar imagens aumentadas à 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 de imagem, 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 de refeições 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ê vir a mensagem "Este dispositivo não é compatível com RA", verifique a revisão na imagem do sistema. Use a Revisão de nível 27 da API 4 ou versões mais recentes.
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 "Failed to create AR session", 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 incorreta do apk Google Play Services para RA. Crie um novo dispositivo virtual e instale a versão x86.