Guia de início rápido do Sceneform para Android

Configurar seu ambiente de desenvolvimento

Abrir o projeto de amostra

Acesse os projetos de amostra. você tem as seguintes opções:

  • Fazer o download e extrair as amostras de formas de cenas

    -ou-

  • Clone o repositório com o seguinte comando:

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

No Android Studio, abra o projeto de exemplo Hello Sceneform, localizado no subdiretório app do diretório sceneform-android-sdk.

Preparar seu dispositivo ou emulador

Você pode executar apps de RA em um dispositivo compatível ou no Android Emulator:

Há outros requisitos para executar apps de Sceneform no emulador:

  • Você precisa do Android Emulator versão 27.2.9 ou mais recente.

  • O OpenGL ES 3.0 ou versões mais recentes precisa ser compatível e estar ativado no Android Emulator.

    • Verifique se o emulador está configurado para usar a versão mais recente. No painel "Extended controls" (Mais na barra de ferramentas, selecione Settings > Advanced > OpenGL ES API level > Renderer maximum (up to OpenGL ES 3.1) e reinicie o emulador.

    • Execute o emulador, interaja brevemente com o dispositivo emulado e verifique se o OpenGL ES 3.0 ou versões mais recentes está sendo usado:

      adb logcat | grep eglMakeCurrent

      Se a versão ver 3 0 ou posterior for exibida, você poderá executar apps de cenário. Se você vir uma versão anterior, isso significa que a GPU para computador não é compatível com o OpenGL ES 3.0 e é necessário usar um dispositivo compatível para executar apps de cena.

Executar a amostra

Verifique se o dispositivo Android está conectado à máquina de desenvolvimento e clique em Run no Android Studio. Em seguida, escolha o dispositivo como destino de implantação e clique em OK.

O Android Studio cria seu projeto em um APK depurável, instala o APK e executa o app no dispositivo. Para ver mais informações, consulte Criar e executar seu app.

Talvez seja necessário instalar ou atualizar o Google Play Services para RA se ele estiver ausente ou desatualizado. Selecione CONTINUAR para instalá-lo pela Google Play Store.

O app Hello Sceneform permite posicionar e manipular figuras do Android em superfícies planas.

Adicionar o Sceneform a um projeto

Para usar o Sceneform em um projeto:

  1. Siga as etapas para Ativar o ARCore no app.

  2. Adicione a biblioteca Sceneform ao seu arquivo build.gradle app's:

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

Próximas etapas