Executar apps de RA no Android Emulator

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Requisitos de software:

Acessar ferramentas do Android Studio e SDK para 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 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 Android Emulator 27.2.9 ou 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 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 para 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 do Telefone desejado 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 dispositivos físicos do ARCore sejam compatíveis com o nível de API 24 ou mais recente, a compatibilidade com o Android Emulator exige o nível de API 27 ou mais recente.

    • Há suporte apenas para arquiteturas do Android Emulator com base em x86. 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.

    • Confira se Camera Back está definido como VirtualScene.

  6. Clique em Finish para criar seu AVD.

Executar seu app

Testar um app do 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:

  1. Faça o download do Google_Play_Services_for_AR_1.33.0_x86_for_emulator.apk mais recente na página de versões do GitHub.

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

    Inicie o AVD desejado e arraste o APK transferido por download da pasta do sistema (ou seja, 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.33.0_x86_for_emulator.apk

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

Controlar a cena 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

Mantenha as teclas Option (macOS) ou Alt (Linux ou Windows) pressionadas 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 Manter pressionada a tecla Option + pressionar 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 Manter pressionada a tecla Option + pressionar W ou S
Mudar a orientação do dispositivo Mantenha pressionada a tecla Option + mover o mouse
Linux ou Windows Mover para a esquerda ou direita Manter pressionadas a tecla Alt + pressionar A ou D
Mover para baixo ou para cima Manter pressionadas a tecla Alt + pressionar Q ou E
Mover para a frente ou para trás Manter pressionadas a tecla Alt + pressionar W ou S
Mudar a orientação do dispositivo Manter pressionadas a tecla Alt + mover o mouse

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

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

Adicionar imagens aumentadas à 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 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 uma mensagem com "Este dispositivo não oferece suporte a AR" 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 ele for iniciado, verifique se Camera Back está definido como VirtualScene, conforme descrito nas etapas de configuração acima.

  • Se o app ARCore não for aberto 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 contenha /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), talvez tenha instalado a versão incorreta do APK do Google Play Services para RA. Crie um novo dispositivo virtual e instale a versão x86.