Guia de início rápido para Android

Para começar a usar o ARCore com o Android, execute o app de exemplo hello_ar_kotlin ou hello_ar_java incluído no SDK do ARCore. Esses apps de exemplo usam o OpenGL (link em inglês), uma interface de programação para renderizar gráficos vetoriais 2D e 3D. Os apps exibem os planos detectados e permitem que o usuário toque em um plano para inserir um modelo 3D.

Configurar seu ambiente de desenvolvimento

Abrir um projeto de exemplo

  1. No Android Studio, clone o repositório do GitHub do SDK do ARCore.

    Há muitas maneiras de fazer isso:

    • Para uma instalação estabelecida do Android Studio:

      • No menu Git, selecione Clone.
      • No menu suspenso Version control, selecione Git como o sistema de controle de versões.

      • No campo URL, insira o seguinte URL para o repositório ARCore GitHub:

        https://github.com/google-ar/arcore-android-sdk.git

    • Você também pode abrir um Terminal e emitir o comando git clone desta maneira:

      git clone https://github.com/google-ar/arcore-android-sdk.git

  2. Abra um dos projetos de amostra da seguinte maneira (é necessário abrir um projeto explicitamente para compilá-lo e executá-lo).

    • No menu File, selecione Open.
    • Na pasta arcore-android-sdk/samples, selecione a pasta hello_ar_kotlin ou hello_ar_java e clique em Open.

Preparar seu dispositivo ou emulador

Você pode executar apps de RA em um dispositivo com suporte ou no Android Emulator. É necessário atualizar o Google Play Services para RA no emulador antes de executar o app. Consulte Executar aplicativos de RA no Android Emulator para saber mais.

Executar a amostra

Confira se o dispositivo Android está conectado à máquina de desenvolvimento e clique em Run no Android Studio.

O Android Studio cria o projeto em um APK depurável, instala-o e executa o app no dispositivo. Para saber mais, consulte Criar e executar seu app.

Talvez você receba uma solicitação para instalar ou atualizar o Google Play Services para RA se ele estiver ausente ou desatualizado. Selecione CONTINUE para instalar o app pela Google Play Store ou faça a atualização manualmente, conforme descrito em Atualizar o Google Play Services para RA.

O app hello_ar_java permite colocar um peão tridimensional do ARCore em superfícies planas de RA detectadas. Ela é implementada com o Android GL SurfaceView, que é usado para renderizar a visualização da câmera e os objetos básicos de RA, como planos e âncoras. O exemplo de framework de renderização de hello_ar_java pode ser encontrado em com/google/ar/core/examples/java/common/samplerender.

Usar posicionamento instantâneo

A API Instant Placement permite que o usuário coloque um objeto de RA na tela sem ter que esperar que o ARCore detecte a geometria da superfície. O posicionamento de objetos é aprimorado em tempo real à medida que o usuário se movimenta pelo ambiente.

Toque na tela para posicionar um objeto. Continue movendo o dispositivo depois que o objeto holográfico aparecer na tela, para que o ARCore possa receber dados suficientes sobre os arredores para fixar o objeto virtual com precisão.

Depois que o ARCore detecta a geometria da superfície e estabelece um elemento rastreável na região em que o objeto está, a posição do objeto é atualizada automaticamente para maior precisão.

Posicionamento instantâneo

Na Figura 1, a Posição instantânea está desativada e a geometria da superfície é indefinida. Objetos colocados no chão à direita da mesa de sinuca (quatro pequenos pontos azuis) aparecem caídos, e as poses deles são indefinidas.

Na Figura 2, o Instant Placement está ativado no menu abaixo do ícone de engrenagem.

Na Figura 3, com o posicionamento instantâneo ativado, um novo objeto é colocado na cena. Ele aparece em escala de cinza, em vez de colorido, para indicar que ainda não foi corrigido para uma pose precisa.

Na Figura 4, o novo objeto fica colorido, e a posição fica precisa quando a geometria da superfície (descrita pelas linhas de grade rastreáveis) é detectada.

Usar profundidade

Quando a opção Depth está ativada, o ARCore considera a geometria e a localização dos objetos na cena e calcula a localização deles em relação a outros objetos na cena. Ele permite que objetos colocados sejam ocultos por objetos no cenário e dá realismo ao app.

Posicionamento instantâneo

Na Figura 1, a profundidade está desativada. Um objeto é colocado debaixo da mesa de sinuca.

Na Figura 2, conforme o dispositivo se move pela mesa de sinuca, o objeto parece seguir o dispositivo, independente dos objetos no cenário.

Na Figura 3, a profundidade está ativada.

Na Figura 4, o objeto agora aparece oculto pela mesa de sinuca enquanto o dispositivo se move pelo cenário.

Próximas etapas