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.
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.
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
- Saiba como ativar o ARCore no seu app.
- Use imagens aumentadas para criar apps que possam responder a imagens em 2D, como pôsteres ou logotipos, no ambiente do usuário.
- Usar o Cloud Anchors
- Use a API Depth para garantir uma profundidade precisa para experiências do usuário realistas e imersivas.
- Use a posição instantânea para colocar objetos de RA na tela rapidamente.
- Consulte as Considerações sobre o ambiente de execução.
- Consulte as diretrizes de design.