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 controlado por você.

configure o 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 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 o Android Emulator 27.2.9 ou mais recente.

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

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

  7. Accept é o contrato de licença do instalador do componente.

  8. Clique em Finish.

Criar um dispositivo virtual compatível com RA

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

Criar um novo dispositivo virtual Android (AVD)

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

  2. Clique em Create Virtual Device, na parte inferior da caixa de diálogo AVD Manager.

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

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

    • Embora os dispositivos ARCore físicos 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 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 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á-la:

  1. Faça o download do Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk mais recente na página de versões do GitHub (em inglês).

  2. Instale o APK salvo em cada AVD que você quiser usar:

    Inicie o AVD desejado e arraste o APK salvo pela pasta do sistema. Por exemplo, Downloads) no emulador em execução ou instale-a usando adb enquanto o dispositivo virtual está em execução:

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

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

Controlar o cenário virtual

Quando seu app se conectar ao ARCore, você 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

Aperte Option (macOS) ou Alt (Linux ou Windows) e mantenha-o pressionado para acessar os controles de movimento da câmera. Use os seguintes controles para mover a câmera:

Plataforma Ação O que fazer
macOS Mover para a esquerda ou direita Mantenha pressionada a tecla Option + pressione A ou D.
Mover para baixo ou para cima Mantenha pressionada a tecla Option + pressione Q ou E.
Mover para a frente ou para trás Mantenha pressionada a tecla Option + pressione W ou S.
Mudar a orientação do dispositivo Manter pressionadas a tecla Option + mover o mouse
Linux ou Windows Mover para a esquerda ou direita Mantenha pressionada a tecla Alt + pressione A ou D
Mover para baixo ou para cima Mantenha pressionada a tecla Alt + pressione Q ou E
Mover para a frente ou para trás Mantenha pressionada a tecla Alt + pressione W ou S
Mudar a orientação do dispositivo Manter pressionadas as teclas Alt + mover o mouse

Solte Option ou Alt para retornar ao modo interativo no emulador.

Use a guia Virtual Sensors em Controles estendidos para um posicionamento de dispositivo mais preciso.

Adicionar imagens aumentadas à cena

Carregar imagens no ambiente simulado do emulador para testar Imagens aumentadas.

Use a guia Camera no 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 no cenário, inicie o emulador e mova a câmera para a área de refeições por meio da 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 AR", verifique a revisão na imagem do sistema. Confira se você está usando a Revisão 4 da API de nível 27 ou mais recente.

  • Se o app ARCore não abrir a câmera quando ela for iniciada, verifique se Camera Back está definida 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 sessão de RA", 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 você 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.