Sceneform-Kurzanleitung für Android

Entwicklungsumgebung einrichten

Beispielprojekt öffnen

Beispielprojekte abrufen Sie haben dann folgende Möglichkeiten:

  • Laden Sie die Szenenbeispiele herunter und extrahieren Sie sie

    Oder:

  • Klonen Sie das Repository mit dem folgenden Befehl:

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

Öffnen Sie in Android Studio das Beispielprojekt Hello Sceneform im Unterverzeichnis app im Verzeichnis sceneform-android-sdk.

Gerät oder Emulator vorbereiten

Du kannst AR-Apps auf einem unterstützten Gerät oder im Android Emulator ausführen:

Für das Ausführen von Sceneform-Anwendungen im Emulator gelten zusätzliche Anforderungen:

  • Sie benötigen die Version Android Emulator Version 27.2.9 oder höher.

  • OpenGL ES 3.0 oder höher muss im Android Emulator unterstützt und aktiviert werden.

    • Achten Sie darauf, dass Ihr Emulator so konfiguriert ist, dass er die neueste Version verwendet. Wählen Sie im Bereich "Erweiterte Steuerelemente" (Mehr in der Google Toolbar) die Option Einstellungen > Erweitertes > OpenGL ES-API-Level > Renderer-Maximum (bis zu OpenGL ES 3.1) aus und starten Sie dann den Emulator neu.

    • Führen Sie den Emulator aus, interagieren Sie kurz mit dem emulierten Gerät und prüfen Sie, ob OpenGL ES 3.0 oder höher verwendet wird:

      adb logcat | grep eglMakeCurrent

      Wenn ver 3 0 oder höher angezeigt wird, können Sie Sceneform-Apps ausführen. Wenn Sie eine niedrigere Version sehen, unterstützt Ihre Desktop-GPU OpenGL ES 3.0 nicht. Außerdem müssen Sie zum Ausführen von Sceneform-Anwendungen ein unterstütztes Gerät verwenden.

Beispiel ausführen

Vergewissere dich, dass dein Android-Gerät mit der Entwicklungsmaschine verbunden ist, und klicke in Android Studio auf Ausführen . Wählen Sie dann Ihr Gerät als Bereitstellungsziel aus und klicken Sie auf OK.

Android Studio baut dein Projekt in ein debugfähiges APK auf, installiert das APK und führt die App dann auf deinem Gerät aus. Weitere Informationen finden Sie unter Anwendung erstellen und ausführen.

Sie werden möglicherweise aufgefordert, die Google Play-Dienste für AR zu installieren oder zu aktualisieren, wenn diese fehlen oder veraltet sind. Wähle WEITER aus, um die App aus dem Google Play Store zu installieren.

Mit der App Hello Sceneform können Sie Android-Figuren auf flachen Oberflächen platzieren und bearbeiten.

Sceneform zu einem vorhandenen Projekt hinzufügen

So verwenden Sie Sceneform in einem vorhandenen Projekt:

  1. Folgen Sie der Anleitung zum Aktivieren von ARCore in Ihrer App

  2. Fügen Sie der Datei build.gradle Ihrer App die Sceneform-Bibliothek hinzu:

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

Weitere Informationen