Guida rapida di Sceneform per Android

Configurazione dell'ambiente di sviluppo

Apri il progetto di esempio

Recupera i progetti di esempio. Puoi:

  • Scarica ed estrai gli Esempi di Forma Scene

    -oppure-

  • Clona il repository con il comando seguente:

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

In Android Studio, apri il progetto di esempio Hello Sceneform, situato nella sottodirectory app all'interno della directory sceneform-android-sdk.

Prepara il tuo emulatore o dispositivo

Puoi eseguire app AR su un dispositivo supportato o nell'emulatore Android:

Esistono ulteriori requisiti per eseguire le app Sceneform nell'emulatore:

  • È necessaria la emulatore Android versione 27.2.9 o successiva.

  • OpenGL ES 3.0 o versioni successive deve essere supportato e abilitato in Android Emulator.

    • Assicurati che l'emulatore sia configurato in modo da utilizzare la versione più recente. Nel pannello di controllo esteso (Altre sulla barra degli strumenti), seleziona Impostazioni > Avanzate > Livello API OpenGL ES > Renderer massimo (fino a OpenGL ES 3.1), quindi riavvia l'emulatore.

    • Esegui l'emulatore, interagisci brevemente con il dispositivo emulato, quindi controlla se viene utilizzato OpenGL ES 3.0 o versioni successive:

      adb logcat | grep eglMakeCurrent

      Se vedi ver 3 0 o una versione successiva, puoi eseguire app Sceneform. Se vedi una versione precedente, significa che la GPU desktop non supporta OpenGL ES 3.0 e devi utilizzare un dispositivo supportato per eseguire le app Sceneform.

Esegui il campione

Assicurati che il dispositivo Android sia connesso alla macchina di sviluppo e fai clic su Esegui in Android Studio. Quindi scegli il dispositivo come destinazione di deployment e fai clic su OK.

Android Studio crea il tuo progetto in un APK di cui è possibile eseguire il debug, installa l'APK, quindi esegue l'app sul dispositivo. Per ulteriori informazioni, consulta l'articolo Creare ed eseguire un'app.

È possibile che ti venga richiesto di installare o aggiornare Google Play Services per AR se manca o è obsoleto. Seleziona CONTINUA per installarla dal Google Play Store.

L'app Hello Sceneform ti consente di posizionare e manipolare statuette Android su piattaforme.

Aggiungi Sceneform a un progetto esistente

Per utilizzare Sceneform in un progetto esistente:

  1. Segui i passaggi per attivare ARCore nell'app

  2. Aggiungi la libreria Sceneform al file build.gradle dell'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'
}

Passaggi successivi