Guide de démarrage rapide de Sceneform pour Android

Configurer l'environnement de développement

Ouvrir l'exemple de projet

Obtenez les exemples de projets. Vous avez alors deux possibilités :

  • Téléchargez et extrayez les exemples Sceneform.

    -ou-

  • Clonez le dépôt à l'aide de la commande suivante:

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

Dans Android Studio, ouvrez l'exemple de projet Hello Sceneform, situé dans le sous-répertoire app du répertoire sceneform-android-sdk.

Préparer votre appareil ou votre émulateur

Vous pouvez exécuter des applications de RA sur un appareil compatible ou dans l'émulateur Android:

D'autres exigences s'appliquent pour l'exécution d'applications Sceneform dans l'émulateur:

  • Vous devez utiliser Android Emulator 27.2.9 ou une version ultérieure.

  • OpenGL ES 3.0 ou version ultérieure doit être compatible et activé dans l'émulateur Android.

    • Assurez-vous que votre émulateur est configuré pour utiliser la dernière version. Dans le panneau "Extended Controls" (More) de la barre d'outils, sélectionnez Settings > Advanced > OpenGL ES API level > Renderer maximum (jusqu'à OpenGL ES 3.1), puis redémarrez l'émulateur.

    • Exécutez l'émulateur, interagissez brièvement avec l'appareil d'émulation, puis vérifiez si OpenGL ES 3.0 ou version ultérieure est utilisé:

      adb logcat | grep eglMakeCurrent

      Si vous voyez ver 3 0 ou une version ultérieure, vous pouvez exécuter les applications Sceneform. Si vous voyez une version antérieure, cela signifie que votre GPU pour ordinateur n'est pas compatible avec OpenGL ES 3.0. Vous devez utiliser un appareil compatible pour exécuter les applications Sceneform.

Exécuter l'exemple

Assurez-vous que votre appareil Android est connecté à la machine de développement, puis cliquez sur Run (Exécuter) dans Android Studio. Choisissez ensuite votre appareil comme cible de déploiement, puis cliquez sur OK.

Android Studio crée votre projet dans un APK débogable, installe l'APK, puis exécute l'application sur votre appareil. Pour en savoir plus, consultez Créer et exécuter votre application.

Vous pouvez être invité à installer ou à mettre à jour les Services Google Play pour la RA s'il est manquant ou obsolète. Sélectionnez CONTINUER pour l'installer à partir du Google Play Store.

L'application Hello Sceneform vous permet de placer et de manipuler des figurines Android sur des surfaces planes.

Ajouter Sceneform à un projet existant

Pour utiliser Sceneform dans un projet existant:

  1. Suivez les étapes pour activer ARCore dans votre application.

  2. Ajoutez la bibliothèque Sceneform à votre fichier app build.gradle:

    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'
}

Étapes suivantes