- Configurar o ambiente de desenvolvimento para a API Depth
- Teste a oclusão e confira o mapa de profundidade em um app de exemplo
Pré-requisitos
- 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
- Um dispositivo Android compatível com profundidade. Consulte a lista de dispositivos compatíveis para mais detalhes.
- Conhecimentos básicos sobre o desenvolvimento para Android. Se você não tem experiência com Android, consulte Como criar seu primeiro app Android para iniciantes.
- Conhecimentos básicos sobre a API Depth. Se você não sabe trabalhar com Depth, consulte a visão geral da API Depth.
Abrir o projeto de exemplo
Este guia de início rápido usa o OpenGL (link em inglês), uma interface de programação para renderizar gráficos vetoriais 2D e 3D. Consulte Ativar o ARCore antes de seguir as etapas a seguir.
Clone o repositório para fazer o download do projeto de exemplo com o seguinte comando:
git clone https://github.com/google-ar/arcore-android-sdk.git
No Android Studio, abra o projeto de exemplo hello_ar_java, localizado no subdiretório samples no diretório arcore-android-sdk.
Executar a amostra
O app de exemplo da API Depth permite que você coloque figuras virtuais do Android no seu ambiente e alterne a oclusão para conferir a diferença. Ela também permite alternar a visualização de profundidade do mapa em um determinado espaço.
Confira se o dispositivo Android está conectado à máquina de desenvolvimento e clique em
Run 
no Android Studio.
Seu dispositivo pode solicitar a instalação ou atualização do Google Play Services para RA se ele estiver ausente ou desatualizado. Toque em CONTINUE para instalar o app pela Google Play Store.
Ativar profundidade
Na primeira vez que você executar o app e colocar um boneco do Android, uma caixa de diálogo solicitará que você ative a profundidade. Ele só aparece na primeira vez que o app é executado, para o primeiro Android colocado. Toque em Enable para adicionar a oclusão.
Alternar a oclusão e uma visualização do mapa de profundidade
Toque no ícone de engrenagem para alternar a oclusão e a visualização do mapa de profundidade. Selecione Enable depth para ativar a oclusão. Selecione Show depth map para exibir uma visualização do mapa de profundidade na tela do dispositivo.
Por exemplo, as imagens abaixo mostram o personagem virtual do Android em um espaço real com um porta-malas ao lado de uma porta. Na primeira imagem, o Android virtual se sobrepõe de forma irreal à borda do tronco. Na segunda imagem, o Android está adequadamente oculto, parecendo muito mais realista ao seu entorno.
As imagens a seguir mostram a imagem de um corredor com uma bicicleta na parede e uma visualização do mapa de profundidade criado para essa imagem da câmera.
Próximas etapas
Comece a usar a API Depth nos seus próprios apps. Para saber mais, veja: