Guia de início rápido para o Android NDK

Configurar seu ambiente de desenvolvimento

  • Instale o Android Studio versão 3.1 ou mais recente com o Android SDK Platform versão 7.0 (nível 24 da API) ou mais recente.

  • Prepare o Android Studio para o desenvolvimento nativo instalando o Android Native Development Kit (NDK) e o CMake com o SDK Manager. Para mais informações, consulte Introdução ao NDK.

  • Será necessário fazer o download do SDK do ARCore para Android. você tem as seguintes opções:

    • Faça o download e extraia o SDK do ARCore para Android.

      -ou-

    • Clone o repositório com o seguinte comando:

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

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.

Abrir o projeto de exemplo

No Android Studio, abra o projeto de exemplo hello_ar_c em <ARCore SDK Folder>/samples/hello_ar_c.

O projeto de exemplo tem dependências de build em determinadas versões de software, como o Gradle e o SDK do Android. Se as dependências necessárias não estiverem instaladas, o Android Studio vai pedir permissão para fazer o download e instalar as dependências na máquina.

Executar a amostra

Verifique 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.

Quando você move o dispositivo, o app detecta automaticamente superfícies planas e desenha uma grade de diamante. Toque na grade para colocar um peão tridimensional do ARCore na superfície.

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 é refinado em tempo real à medida que o usuário se move mais pelo ambiente. Depois que o ARCore detecta a pose correta na região em que o objeto de RA é colocado, o objeto é atualizado automaticamente para ficar com a precisão da pose.

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.

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