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 ARCore. SDK do Vertex AI Pipelines. Esses apps de exemplo usam o OpenGL (link em inglês), uma de programação para renderizar gráficos vetoriais 2D e 3D. Os apps mostram todos os planos detectados e permitem que o usuário toque em um plano para posicionar um modelo 3D.

Configurar o ambiente de desenvolvimento

Abrir um projeto de amostra

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

    Há várias maneiras de fazer isso:

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

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

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

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

    • Você também pode abrir um Terminal e emitir o comando git clone como da seguinte forma:

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

  2. Abra um dos projetos de exemplo da seguinte forma (é necessário abrir explicitamente um projeto para criá-lo e executá-lo).

    • No menu File, selecione Open.
    • Na pasta arcore-android-sdk/samples, selecione o 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 compatível ou no Android Emulator. Você precisa atualizar o Google Play Services para RA no emulador antes de executar o app. Consulte Execute apps de RA no Android Emulator para saber mais informações imprecisas ou inadequadas.

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 APK e e, em seguida, executa o app no seu dispositivo. Para mais informações, consulte Crie e execute seu app.

Talvez você precise instalar ou atualizar o Google Play Services para RA se ele estiver ausente ou desatualizado. Selecione CONTINUE para fazer a instalação Google Play Store ou faça a atualização manualmente, conforme descrito em Atualize o Google Play Services para RA.

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

Usar a posição instantânea

A API Instant Placement permite que o usuário coloque um objeto de RA na tela sem precisar esperar que o ARCore detecte a geometria da superfície. O posicionamento de objetos é refinado em tempo real à medida que o usuário avança no ambiente.

Toque na tela para posicionar um objeto. Continue movendo o dispositivo depois de ver o objeto holográfico aparecer na tela, para que o ARCore possa coletar dados suficientes sobre seus arredores para ancorar com precisão o virtual objeto.

Depois que o ARCore detectar a geometria da superfície e estabelecer uma faixa rastreável no na região onde o objeto é colocado, a posição do objeto é automaticamente atualizada para garantir a precisão.

Canal instantâneo

Na Figura 1, o posicionamento instantâneo está desativado e a geometria da superfície é indefinida. Objetos colocados no chão à direita da mesa de sinuca (quatro pequenos pontos azuis) parecer derrubado, suas posições são indefinidas.

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

Na Figura 3, com o Instant Placement ativado, um novo objeto é colocado na cena. Ele aparece em escala de cinza, em vez de colorido, para indicar que não foi já corrigido para uma pose precisa.

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

Profundidade de uso

Quando a opção Profundidade está ativada, o ARCore considera a geometria e a localização dos objetos na cena e calcula a localização dos objetos colocados na cena em relação a outros objetos na cena. Permite colocados para que sejam obstruídos por objetos na cena, o que dá realismo seu app.

Canal instantâneo

Na Figura 1, a opção "profundidade" está desativada. Um objeto é colocado embaixo da mesa de sinuca.

Na figura 2, conforme o dispositivo se move ao redor da mesa de sinuca, o objeto aparece para acompanhar o dispositivo, independentemente de objetos na cena.

Na Figura 3, a opção "profundidade" está ativada.

Na figura 4, o objeto agora aparece oculto pela tabela de sinuca enquanto o dispositivo se move pela cena.

Próximas etapas