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
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.
Se você não tem experiência com Android, consulte Como criar seu primeiro app Android.
Abrir um projeto de exemplo
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
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.
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
- Tente criar e executar outros projetos de amostra no SDK do ARCore.
- Confira os codelabs de realidade aumentada para ver mais apps de exemplo que você pode criar e executar.
- Saiba como ativar o ARCore no seu app.
- Analise as Considerações sobre o ambiente de execução.
- Revise as diretrizes de design.