Guía de inicio rápido de Sceneform para Android

Cómo configurar tu entorno de desarrollo

Abrir el proyecto de muestra

Obtén los proyectos de muestra. Tienes varias opciones:

  • Descarga y extrae los ejemplos de Sceneform.

    O bien:

  • Clona el repositorio con el siguiente comando:

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

En Android Studio, abre el proyecto de muestra Hello Sceneform, ubicado en el subdirectorio app dentro del directorio sceneform-android-sdk.

Cómo preparar tu dispositivo o emulador

Puedes ejecutar apps de RA en un dispositivo compatible o en Android Emulator:

Hay requisitos adicionales para ejecutar apps de Sceneform en el emulador:

  • Necesitas el emulador de Android, versión 27.2.9 o posterior.

  • OpenGL ES 3.0 o una versión posterior deben ser compatibles y habilitarse en Android Emulator.

    • Asegúrate de que el emulador esté configurado para usar la versión más reciente. En el panel de controles extendidos (Más en la barra de herramientas), selecciona Settings > Advanced > OpenGL ES API level > Renderer max (up to OpenGL ES 3.1) y luego reinicia el emulador.

    • Ejecuta el emulador, interactúa brevemente con el dispositivo emulado y, luego, verifica si se usa OpenGL ES 3.0 o una versión posterior:

      adb logcat | grep eglMakeCurrent

      Si ves ver 3 0 o una versión posterior, puedes ejecutar las apps de Sceneform. Si ves una versión anterior, significa que tu GPU de escritorio no es compatible con OpenGL ES 3.0 y debes usar un dispositivo compatible para ejecutar apps de Sceneform.

Ejecutar la muestra

Asegúrate de que tu dispositivo Android esté conectado a la máquina de desarrollo y haz clic en Run en Android Studio. Luego, elige tu dispositivo como destino de implementación y haz clic en OK.

Android Studio compila tu proyecto en un APK depurable, lo instala y, luego, ejecuta la app en tu dispositivo. Para obtener más información, consulta Cómo compilar y ejecutar tu app.

Es posible que se te solicite instalar o actualizar los Servicios de Google Play para RA si falta o no está actualizado. Selecciona CONTINUAR para continuar desde Google Play Store.

La app de Hello Sceneform te permite colocar y manipular figuras de Android en superficies planas.

Cómo agregar Sceneform a un proyecto existente

Para usar Sceneform en un proyecto existente, sigue estos pasos:

  1. Sigue los pasos para habilitar ARCore en tu app.

  2. Agrega la biblioteca de Sceneform al archivo build.gradle de tu app:

    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óximos pasos